> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/de/abschnitt-02-velogic-studio-verwenden/troubleshooting.md). # Fehlerbehebung für Velogic Studio Umfassender Leitfaden zur Fehlerbehebung bei häufigen Problemen mit Velogic Studio, einschließlich Leistung, Abstürzen und Videoproblemen Wenn du überhaupt keine Informationen vom Kinect erhältst oder die Kinect sich trennt: Sieh dir unseren [Hardware-Kompatibilitätsleitfaden](/de/abschnitt-01-erste-schritte/pc-system-requirements.md) und [Kinect-Kamera-Fehlerbehebungsleitfaden](/de/abschnitt-01-erste-schritte/kinect-troubleshooting.md) . Sobald du sicher bist, dass die Kinect einwandfrei funktioniert (d. h. der Kinect Configuration Verifier stabil ist und 29–30 FPS liefert), hilft dir dieser Leitfaden bei der Fehlerbehebung von Anwendungsproblemen. ## Wireframe wird nicht automatisch angezeigt Siehe: [Fehlerbehebung bei der Marker-Erkennung](/de/abschnitt-02-velogic-studio-verwenden/troubleshooting-marker-detection.md) ## Bildrate ist niedrig Wenn du die bestmöglichen Umgebungsbedingungen erreichen möchtest (um die Bildrate zu verbessern), gibt es einige Dinge, die du überprüfen solltest. * Wenn du Velogic Studio zum ersten Mal gestartet hast oder gerade auf eine neue Version aktualisiert hast, ist Windows möglicherweise noch damit beschäftigt, die Anwendung für deinen Computer zu optimieren. Bitte lass es einige Minuten laufen und schließe es dann und starte es neu. * Starke Lichtquellen (Fenster, Tür, Glühbirne) hinter dem Reiter, die im Sichtfeld der Kinect sind, führen zu einer schlechteren Bildrate und einem unscharfen Bild (dies beeinträchtigt jedoch nicht die Messung – nur das Farbbild). * Schlechte Lichtverhältnisse können einen schwach beleuchteten Bereich oder nur Deckenbeleuchtung bedeuten. Jede Lichtsituation, die einen Helligkeitsverlauf über den Reiter erzeugt (z. B. oben hell und unten dunkel) oder Hotspots (direktes Anstrahlen eines der Marker), verschlechtert die Lichtbewertung. Siehe auch: [Beleuchtung & Umgebung](/de/abschnitt-01-erste-schritte/lighting-environment.md) ## Liveansicht ist nicht live (friert nach einem Bild ein) Dies ist ein bekanntes Problem mit Intel Iris Xe-Grafiktreibern. Es gibt mehrere mögliche Lösungen: * Du kannst deine Treiber auf die neueste Version aktualisieren und prüfen, ob das Problem behoben ist. Das sollte entweder über den Geräte-Manager möglich sein (Anzeigeadapter erweitern, mit der rechten Maustaste auf deine Grafikkarte klicken und Treiber aktualisieren wählen) ODER du installierst manuell den [von Intel empfohlene Treiberversion](https://www.intel.com/content/www/us/en/download/19344/30579/intel-graphics-windows-dch-drivers.html?) um dieses spezifische Problem zu beheben. Wenn du diese Treiberversion installierst und der Freeze trotzdem auftritt, versuche es mit [Intels eigener Verwaltungssoftware](https://www.intel.com/content/www/us/en/support/detect.html) um auf eine neuere Version der Grafiktreiber zu aktualisieren. * Du kannst den problematischen Code für deinen gesamten Computer deaktivieren, indem du dieses DWORD-Flag im Registrierungs-Editor setzt: `HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1` * Velogic Studio hat eine spezielle Einstellung, um die Hardwarebeschleunigung zu deaktivieren und dieses Problem zu umgehen: Einstellungen -> Support -> Software-Rendermodus erzwingen. Im Allgemeinen ist es besser, diese Einstellung ausgeschaltet zu lassen (da dadurch deine CPU Arbeit übernehmen muss, die von der GPU erledigt werden sollte), aber das Einschalten umgeht das Treiberproblem. ## Gelegentliche zufällige Abstürze Velogic Studio ist eine sehr stabile Anwendung, aber wenn es bei dir gelegentlich zu Abstürzen kommt, lies weiter für mögliche Lösungen. ### Anzeigetreiber aktualisieren Velogic Studio verwendet Funktionen deiner Videotreiber. Wenn die Videotreiber fehlerhaft sind, kann das zu Instabilität in Velogic Studio führen. Befolge [diesen Leitfaden von Microsoft](https://support.microsoft.com/en-us/windows/update-drivers-in-windows-10-ec62f46c-ff14-c91d-eead-d7126dc1f7b6), aber wähle im Geräte-Manager „Anzeigeadapter“ statt des im Artikel angegebenen Beispiels: ![Device Manager window showing Display Adapters section for updating video drivers](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-78e146ad5890a5387a593d3c40fc9d49021e8839%2Ftroubleshooting.png?alt=media) ### Antivirenprogramm anweisen, die von Velogic Studio gespeicherten Dateien nicht zu prüfen Wenn Velogic Studio bei dir beim Speichern einer Aufnahme „einfriert“, kann das helfen. Windows hat ein integriertes Antivirenprogramm, das jede auf die Festplatte gespeicherte Datei scannt. Manchmal meinen wir, dass es ein gespeichertes Video fälschlicherweise als Virus erkennt und Velogic Studio stoppt, ohne dass ein Fehlerbericht gesendet wird. Du kannst diese Fehlalarme vermeiden und außerdem die Zeit zum Speichern der Ergebnisse jeder Aufnahme verkürzen, indem du Windows anweist, das Verzeichnis zu ignorieren, in dem die Fit-Daten von Velogic Studio gespeichert werden: * Klicke auf „Start“ und gib „Virus“ ein, klicke dann auf „Viren- & Bedrohungsschutz“ * Klicke unter „Einstellungen für Viren- & Bedrohungsschutz“ auf „Einstellungen verwalten“ ![Einstellungen für den Viren- & Bedrohungsschutz von Windows Defender mit Schaltfläche „Einstellungen verwalten“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5eed58b05bb9fbe0b708891f47118cbf07997a55%2Ftroubleshooting-1.png?alt=media) * Klicke auf „Ausschlüsse hinzufügen oder entfernen“ ![Seite mit den Einstellungen für den Virenschutz und der Option „Ausschlüsse hinzufügen oder entfernen“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-e622bccfce29fe80e578a4c77b31906f5b9fec54%2Ftroubleshooting-2.png?alt=media) * Klicke auf „Ausschluss hinzufügen“ und dann auf „Ordner“ ![Dialog zum Hinzufügen eines Ausschlusses mit ausgewählter Ordner-Option zum Ausschließen des Verzeichnisses für Fit-Daten](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a1554c9b0cfb1e1b034b6c180158e4681cb3e49e%2Ftroubleshooting-3.png?alt=media) * Wähle den Ordner, in dem Velogic Studio Fit-Daten speichert (normalerweise ist das „Documents\Velogic Studio fits“, aber du hast es möglicherweise in den Einstellungen von Velogic Studio geändert) * Velogic Studio neu starten ### Nach anderen Anwendungen suchen, die LibUSB verwenden Einige Kunden haben berichtet, dass Velogic Studio einfriert, wenn auf demselben Computer andere Anwendungen installiert sind, die LibUSB verwenden. Ein Beispiel für eine solche Anwendung ist die EBike-Verwaltungssoftware. Du kannst nach LibUSB suchen, indem du im Geräte-Manager nachsiehst. ![Geräte-Manager mit LibUSB-Treibern in der Liste der Systemgeräte](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1949740b9d24d140f8b2e2c78090a2920de2b875%2Ftroubleshooting-4.png?alt=media) Wenn du feststellst, dass LibUSB auf dem Computer vorhanden ist, versuche, andere USB-Dongles vom Computer zu entfernen. Wenn Velogic Studio immer noch instabil ist, versuche, libUSB vom Computer zu entfernen (mit der rechten Maustaste auf den Eintrag im Geräte-Manager klicken und „Gerät deinstallieren“ wählen) ### Nach Velogic-Studio-Fehlermeldungen im Ereignisanzeige-Tool suchen Visual Studio schreibt Fehlerinformationen in das Windows-Ereignisprotokoll. Möglicherweise bitten wir dich, die Protokolle zu prüfen und uns eine Datei mit den relevanten Informationen zu senden. So geht das: * Drücke die Windows-Taste und suche nach „Ereignisanzeige“, dann klicke, um sie zu starten ![Suchergebnisse im Windows-Startmenü, die die Anwendung Ereignisanzeige anzeigen](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0020cf6f004c6bba0ac6552c9a5289f1cb9b658f%2Ftroubleshooting-5.png?alt=media) * Klicke auf „Windows-Protokolle“ und dann auf „Anwendung“ ![Ereignisanzeige mit hervorgehobenem Bereich „Windows-Protokolle“ und „Anwendung“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-66fb067705fb03676854ee610b0534563f9ca44a%2Ftroubleshooting-6.png?alt=media) * Klicke im Bereich „Aktionen“ auf der rechten Seite des Fensters auf „Aktuelles Protokoll filtern“ ![Bereich „Aktionen“ der Ereignisanzeige mit ausgewählter Option „Aktuelles Protokoll filtern“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-16848a6983b9c3a4a260d4c79b9e658824c0b2b8%2Ftroubleshooting-7.png?alt=media) * Im Filter-Popup-Fenster die Optionen einstellen: Ereignisebene = Fehler, Ereignisquellen = .NET Runtime, Ereignis-ID = 1011, dann auf OK klicken ![Dialog „Aktuelles Protokoll filtern“ mit konfigurierten Einstellungen für Fehlerstufe und .NET Runtime](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-53e1f68e8d8cde5680481b65981a26099c9a9e02%2Ftroubleshooting-8.png?alt=media) * Klicke im Bereich „Aktionen“ auf der rechten Seite des Fensters auf „Gefilterte Protokolldatei speichern unter...“ ![Bereich „Aktionen“ der Ereignisanzeige mit Option zum Speichern der gefilterten Protokolldatei](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-75aa2f2d6a1cd4dc0daa3f572d1c07b1a3c6fae0%2Ftroubleshooting-9.png?alt=media) * Gib im Speichern-Dialog der Datei einen Namen (z. B. deinen Namen) und speichere sie an einem Ort, an dem du sie wiederfinden kannst, z. B. auf dem Desktop ![Speichern-unter-Dialog zum Exportieren der gefilterten Ereignisprotokolldatei auf den Desktop](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-74dc2128b1d90e07023a1b40a284514564a14d75%2Ftroubleshooting-10.png?alt=media) * Sende eine E-Mail mit dieser Datei als Anhang an ### Dump-Dateien hochladen Wenn Velogic Studio unerwartet beendet wird (abstürzt), sollte es eine Dump-Datei in einem Verzeichnis auf deinem Computer schreiben und dann neu starten. Beim Neustart erkennt es, dass die Dump-Datei vorhanden ist, und zeigt unten im Hauptfenster von Velogic Studio eine Aufforderung an. ![Aufforderung zum Hochladen des Crash-Dumps von Velogic Studio mit Upload-Schaltfläche unten im Fenster](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b07da01dd3e5207065367f1fbca048ec0543b210%2Ftroubleshooting-11.png?alt=media) Diese Dump-Dateien sind sehr nützlich, um uns bei der Diagnose und schließlich bei der Behebung des Problems zu helfen, das den Absturz verursacht hat. Wenn du diese Meldung siehst und eine brauchbare Internetverbindung hast, klicke bitte auf die Schaltfläche „Upload“. Velogic Studio zippt die Dump-Datei(en) und lädt sie an unser Support-Team hoch. Das Hochladen kann einige Minuten dauern, aber du kannst die Anwendung währenddessen wie gewohnt verwenden, und du kannst den Vorgang jederzeit abbrechen. Wenn du die Dateien nicht an den Support hochladen möchtest, kannst du auf „Löschen“ klicken. Oder du kannst auf die X-Schaltfläche klicken, um die Meldung auszublenden, ohne etwas zu unternehmen. ### Eine manuelle Dump-Datei an uns senden Wenn Visual Studio nicht mehr reagiert, aber nicht automatisch eine Dump-Datei erstellt (siehe oben), bitten wir dich möglicherweise, manuell eine Dump-Datei zu erstellen. So geht das: * Starte den Task-Explorer (indem du die Tasten Strg+Umschalt+Esc gleichzeitig drückst) * Suche Velogic Studio und klicke auf den Aufklapp-Pfeil daneben ![Task-Manager mit dem Prozess Velogic Studio und aufgeklappter Ansicht der Unterprozesse](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-9ed9554ad89842648da249e060da5fcf4eb24bff%2Ftroubleshooting-12.png?alt=media) * Klicke mit der rechten Maustaste auf den Prozess und wähle „Dump-Datei erstellen“ ![Kontextmenü des Prozesses mit Option „Dump-Datei erstellen“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a055a3ac74dfdabf9c0055385e8fc73287357ef3%2Ftroubleshooting-13.png?alt=media) * Du wirst eine Meldung wie diese sehen: ![Dialog zum Fortschritt bei der Erstellung der Dump-Datei, der die laufende Dateierzeugung zeigt](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5efe042bba4a54dc8ba954ae605335cc39a8779b%2Ftroubleshooting-14.png?alt=media) ... und dann nach einigen Sekunden wirst du Folgendes sehen: ![Dialog zum Abschluss der Dump-Dateierstellung mit angezeigtem Dateipfad](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-29c458bdaabcb998fbf5e7d65565dfa073a49412%2Ftroubleshooting-15.png?alt=media) * Besuche in deinem Webbrowser , und klicke auf die Schaltfläche „Dateien auswählen“ ![Web-Upload-Oberfläche auf vlgc.io/upload mit der Schaltfläche „Dateien auswählen“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-44ad9584d63e9094155da844db9575bceb60b279%2Ftroubleshooting-16.png?alt=media) * Navigiere zu dem Pfad aus dem vorherigen Schritt (z. B. c:\Users\\AppData\Local\temp\Velogic.Studio.App.DMP). Um das zu erleichtern, kannst du dies in das Feld „Dateiname“ eingeben: `%localappdata%\temp\Velogic.Studio.App.DMP` * Gib deinen Vor- und Nachnamen ein und klicke auf „Upload“ ![Datei-Upload-Formular mit Namensfeldern und Upload-Schaltfläche zum Senden der Dump-Datei](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c980fa2f2fce73b68f324afdf74f84c46950469f%2Ftroubleshooting-17.png?alt=media) * Das Hochladen dauert je nach Internetverbindung einige Minuten. Die Dump-Datei dürfte etwa 1 GB groß sein. Wenn du also teures Internet nutzt, kontaktiere uns bitte, damit wir sicherstellen können, dass dies der beste Weg für dich ist. * Bitte sende auch eine E-Mail an , in der du erklärst, warum du die .dmp-Datei gesendet hast. Idealerweise enthält deine E-Mail: * Was du getan hast * Was du erwartet hast * Was tatsächlich passiert ist ## Die Anwendung wirkt im Allgemeinen träge, Videos haben Verzögerungen Velogic-Anwendungen sollten sich immer reaktionsschnell anfühlen und auf angemessener Hardware eine gute Leistung haben. Wenn du Hardware hast, die unsere Mindestanforderungen übertrifft, und du nicht die erwartete Leistung erhältst, kannst du Folgendes überprüfen. ### Versuche, die Webcam auszustecken Wir haben von Nutzern Berichte erhalten, dass einige Webcams selbst viel CPU verbrauchen, sodass für die Arbeit der Velogic-Apps nicht genug übrig bleibt. Versuche, deine Webcam zu trennen, und wenn die Leistung merklich besser ist, verwende eine andere Webcam. ### Process Explorer verwenden, um den Engpass zu finden Process Explorer ist ein kostenloses Hilfsprogramm von Microsoft (Teil des kostenlosen Sysinternals-Toolsets). Du kannst es direkt herunterladen oder starten von der [Process-Explorer-Webseite](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer). Suche einfach den Velogic-Prozess in der Prozessliste, klicke dann mit der rechten Maustaste und wähle „Eigenschaften“. Lass das laufen, während du einige Aktivitäten in Velogic Studio ausführst, und betrachte dann die Diagramme. ![Leistungsdiagramme von Process Explorer mit CPU-Auslastung, Speicher und I/O-Statistiken](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-695dd3522704a4b50c5d68b8a15716dfbcaac5bd%2Ftroubleshooting-18.png?alt=media) Du kannst dir Folgendes ansehen: * CPU-Auslastung – Die CPU-Auslastung ist niedrig, was gut ist. (Hohe CPU-Auslastung ist nicht unbedingt schlecht, es sei denn, du bist mit der Gesamtleistung der Anwendung unzufrieden) * „Private Bytes“ – das ist die Speichernutzung und sollte relativ konstant bei etwa 500–700 MB bleiben. Wenn sie ständig und schnell ansteigt, liegt möglicherweise ein Speicherleck vor – bitte kontaktiere uns und sende uns eine Kopie deines Diagramms (du kannst es mit der Tastenkombination \[Umschalt]-\[Windows]-\[s] als Screenshot aufnehmen) * I/O – Die I/O-Werte erreichen während der Capture-Phase ihren Höhepunkt, wenn die App das Video auf die Festplatte schreibt. Ansonsten ist I/O niedrig. Der CPU-Höchstwert während der Capture-Phase ist recht klein, sodass die CPU nicht zu stark damit beschäftigt ist, die Videos zu kodieren. Wir helfen gerne dabei, Leistungsprobleme mit unserer Software zu diagnostizieren. Bitte melde dich mit so vielen Informationen wie möglich – idealerweise einschließlich eines Screenshots aus Process Explorer. ### Leistungsdaten zur Analyse an uns senden Wir haben in Velogic Studio ein Tool eingebaut, mit dem du detaillierte Leistungsdaten senden kannst. Siehe [diesen Artikel](/de/abschnitt-01-erste-schritte/submitting-performance-data.md) für Details. ### Uns Systeminformationen senden Windows hat ein integriertes Tool, um detaillierte Informationen über die Hardware und das Betriebssystem deines Systems zu sammeln. Das kann manchmal hilfreich sein, um uns bei der Diagnose von Problemen zu unterstützen. Wenn wir dich danach fragen: * Klicke auf das Windows-Menü und gib „Systeminformationen“ ein, dann starte die App: ![Windows-Startmenüsuche mit der Anwendung „Systeminformationen“](https://1036273497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-3357cd97f790a4ab99602800af6415263a9d6633%2Ftroubleshooting-19.png?alt=media) * * Klicke auf Datei -> Exportieren, speichere die Datei irgendwo (z. B. auf deinem Desktop) und sende uns dann die Datei per E-Mail - --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.velogicfit.com/de/abschnitt-02-velogic-studio-verwenden/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.