Problembehandlung für World Locking Tools
In diesem Artikel werden störende Probleme dokumentiert. Eine empfohlene Strategie zur Eingrenzung von World Locking-Problemen finden Sie hier.
World Locking: Probleme
Niedrige Framerate
World Locking Tools sollten keine nennenswerten Auswirkungen auf Ihre Framerate haben. (Es gibt eine Ausnahme: Visualisierungen verringern die Framerate, wenn viele Anker erstellt wurden, aber die Visualisierungen dienen nur der Diagnose und werden nicht mit Ihrer Anwendung ausgeliefert.)
Wenn Sie nach dem Hinzufügen von World Locking Tools zu Ihrer Anwendung einen Abfall der Framerate feststellen, überprüfen Sie Ihre Unity-Protokolle. In der Regel weist dies auf eine wiederholt erzeugte Ausnahme hin.
Fehler im Zusammenhang mit fehlender DLL
Diese Fehler sind in der Regel auf die FWE-DLL (Frozen World Engine) zurückzuführen. Befolgen Sie zur Behebung die Anweisungen in der Setupdokumentation, um die FrozenWorld-Engine auf eine höhere Version upzugraden. Wenn Sie diese Anweisungen befolgen, ohne die Versionsnummer zu ändern, wird die Installation repariert.
Alternativ können Sie die Installation mithilfe des MR-Featuretools durchführen. Das Tool übernimmt die Installation der Abhängigkeiten für Sie.
Fehlender Namespace „FrozenWorld“
Fehler wie die folgenden (in der Regel eine Menge):
Assets\WorldLocking.Engine\Plugin.cs(10,37): Fehler CS0234: Der Typ oder Namespacename 'FrozenWorld' ist nicht im Namespace 'Microsoft.MixedReality' vorhanden (fehlt ein Assemblyverweis?).
Die DLL „FrozenWorld.Engine“ fehlt. Siehe NuGet-Setup.
Alternativ können Sie Installation über das MR-Featuretool durchführen und die Installation der Abhängigkeiten für sich erledigen lassen.
Es funktioniert nicht
Überprüfen Sie die Unity-Protokolle auf Fehler und Ausnahmen.
Vergewissern Sie sich, dass Ihre Szenenkamera an mindestens ein anderes Objekt angefügt ist. Ein Beispiel finden Sie im Setup von WorldLocking.Examples.WorldLockingPhysicsSample. Wenn Sie dynamische Kameramanipulationen vornehmen, müssen Sie ggf. WorldLockingManager über die aktuelle Kamera auf dem Laufenden halten. Siehe WorldLockingManager.AdjustmentFrame und WorldLockingManager.CameraParent.
Allgemeinere Unity-/AR-Probleme
„DirectoryNotFoundException: Ein Teil des Pfads wurde nicht gefunden“
Der Pfad ist zu lang geworden. Eine umfassendere Erläuterung finden Sie hier.
Meldung „Ein Remotevorgang dauert länger als erwartet“ und anschließender Fehler bei der Bereitstellung
Überprüfen Sie Ihre USB-Verbindung. Dieses Problem kann durch ein fehlerhaftes Kabel oder einen falschen Port oder durch Fehlen von „IPOverUSB“ verursacht werden. Aber wahrscheinlich liegt die Fehlerursache irgendwo auf dem Kommunikationsweg zwischen Ihrem PC und Ihrem Gerät.
Fehlende Windows SDK-Komponenten
Die in Unity angegebene Visual Studio-Version und die für den Build verwendete Visual Studio-Version stimmen nicht überein. Aktivieren:
Unity > File > Build Settings > Visual Studio Version
Besonders gefährlich ist es, wenn dieser Wert auf Latest Installed festgelegt ist und Sie mehrere Versionen von Visual Studio installiert haben.
In HoloLens wird die Anwendung als Slate und nicht als AR-Funktion gestartet
Wenn Sie die integrierte VR-Unterstützung von Unity (auch Legacy XR genannt) nutzen möchten, dann prüfen Sie Folgendes:
Unity > Project Settings > Player > XR Settings
Sie müssen Virtual Reality Supported (Virtual Reality-Unterstützung) und in den Virtual Reality SDKs die Option Windows Mixed Reality aktiviert haben.
Vergewissern Sie sich bei Verwendung der AR-Subsysteme von Unity oder des XR SDK, dass Sie alle Schritte des Artikels Plattformübergreifende Verwendung des XR SDK-Plug-In-Systems von Unity ausgeführt haben. Wahrscheinliche Ursachen:
- Eines der erforderlichen Pakete fehlt.
- Das entsprechende Profil wurde nicht für das MixedRealityToolkit-Objekt festgelegt (bei Verwendung von MRTK).
Wenn die App für ARM auf HoloLens2 erstellt wurde, wird die App beim Start beendet. ARM64 funktioniert hingegen einwandfrei.
Dies ist ein bekanntes Problem.
Die Lösung ist, die Grafikaufträge in diesem Pfad zu deaktivieren:
Project Settings > Player > Other Settings > Graphics Jobs
Als Alternative erstellen Sie nur einen Build für ARM64.
Dieses Problem wurde in Unity 2019.4 und Unity 2020.3 behoben.