Microsoft Mixed Reality Toolkit 2.6 Versionshinweise

Wichtig

Es gibt ein bekanntes Compilerproblem, das anwendungen beeinflusst, die für Microsoft HoloLens 2 mit ARM64 erstellt wurden. Dieses Problem wurde behoben, indem sie Visual Studio 2019 auf Version 16.8 oder höher aktualisieren. Wenn Sie Visual Studio nicht aktualisieren können, importieren Sie das com.microsoft.mixedreality.toolkit.tools Paket, um eine Problemumgehung anzuwenden.

Neuerungen in 2.6.2

Korrigiert das Übergeordnete des räumlichen Gitters

Behebt das Problem, bei dem räumliche Gitter nach dem Verschieben des Mixed Reality Playspace-Objekts nicht ordnungsgemäß gefunden wurden (z. B. über einen Teleport).

Neuerungen in 2.6.1

Fixes OpenXR wird nicht auf HoloLens 2 / UWP ausgeführt

Behebt eine Regression, die verhindert hat, dass die OpenXR-Unterstützung von MRTK auf UWP ausgeführt wird.

Fixes Leap Motion ObjectManipulator wird nicht gedreht

Behebt eine Regression, bei der die Drehung einer Schalthand nicht vom ObjectManipulator-Skript berücksichtigt wurde.

Beispielszeneupdates

Aktualisiert die Szene, die Beispielszene verstehen, um den gesendeten Zustand des Unity-Plug-Ins korrekt darzustellen. Aktualisiert auch das Beispiel, um keine Abhängigkeit mehr von der räumlichen Sensibilisierungsbeispielszene zu haben, die importiert wird. Vor dem Aktualisieren auf 2.6.1 sollten Sie die importierten Szenenverständnis- und räumlichen Bewusstseinsbeispiele löschen, wenn sie in Ihrem Projekt vorhanden sind, um mögliche Konflikte zu vermeiden. Wenn Sie diese Beispiele nicht entfernt haben und Konflikte im Zusammenhang mit denen in der Konsole angezeigt werden, entfernen Sie beide Beispiele (oder den Assets/Samples/Mixed Reality Toolkit Examples Ordner), und versuchen Sie es dann erneut zu importieren.

Aktualisiert die Dialogfeldbeispielszene, um die aktuellen Dialogfeldszenarien ordnungsgemäß zu beschreiben.

Neuerungen in 2.6.0


Hinzufügen der Unterstützung für OpenXR

Die anfängliche Unterstützung für das OpenXR-Vorschaupaket von Unity und das Mixed Reality OpenXR-Paket von Microsoft wurde hinzugefügt. Weitere Informationen finden Sie auf der Seite "MRTK/XRSDK", dem Forumbeitrag von Unity oder der Dokumentation von Microsoft .

Wichtig

OpenXR in Unity wird nur für Unity 2020.2 und höher unterstützt.

Derzeit unterstützt es auch nur x64- und ARM64-Builds.

Asset Swap-Hilfsprogramm

Tauschen Sie mehrere Ressourcen in einer Unity-Szene mit dem neuen Asset Swap-Hilfsprogramm aus.

HP Motion Controller werden jetzt mit MRTK unterstützt

Controller für das HP Reverb G2 funktionieren jetzt native mit MRTK.

Experimentelles interaktives Element + Zustandsvisualisierer

Interaktives Element ist ein vereinfachter zentralisierter Einstiegspunkt für das MRTK-Eingabesystem. Es enthält Zustandsverwaltungsmethoden, Ereignisverwaltung und die Zustandseinstellungslogik für Kerninteraktionszustände. Weitere Informationen finden Sie in der Dokumentation zum interaktiven Element.

InteractiveElementAddCoreState

Die Zustandsvisualisierer ist eine Animationskomponente, die von interaktivem Element abhängt. Diese Komponente erstellt Animationsclips, legt Keyframes fest und generiert einen Animator-Zustandscomputer. Weitere Informationen finden Sie in der Dokumentation zur Zustandsansicht

StateVisualizerColorChangeOnFocus

Teleportierung mit der Teleportgeste wird jetzt auf allen Plattformen unterstützt

Benutzer können nun die Teleportgeste verwenden, um sich um ihren Spielraum auf allen Plattformen zu bewegen. Um mit einem Controller auf MR-Geräten mit Standardkonfigurationen zu teleportieren, verwenden Sie den Daumenstick. Um mit gestikulierten Händen zu teleportieren, machen Sie eine Geste mit der Handfläche, die mit dem Index konfrontiert ist und den Daumen nach außen hält, indem Sie den Zeigefinger schließen. Um mit Eingabesimulation zu teleportieren, lesen Sie bitte unsere aktualisierte Dokumentation zum Input Simulation Service.

Teleport Gesture

Szenenverständnis jetzt in MRTK als experimenteller räumlicher Sensibilisierungsbeobachter verfügbar

Experimentelle Unterstützung des Szenenverständnisses wird in MRTK 2.6 eingeführt. Benutzer können die Funktionen des Szenenverständnisses von HoloLens 2 als räumlicher Bewusstseinsbeobachter in MRTK-basierte Projekte integrieren. Weitere Informationen finden Sie in der Dokumentation "Szenenverständnis ".

Wichtig

Szenenverständnis wird nur auf HoloLens 2 und Unity 2019.4 und höher unterstützt.

Dieses Feature erfordert das Szenenverständnispaket, das jetzt über das Mixed Reality Featuretool verfügbar ist. Wenn Sie das Mixed Reality Featuretool verwenden oder anderweitig über UPM importieren, importieren Sie bitte das Demos - SpatialAwareness-Beispiel vor dem Importieren des Experimental - SceneUnderstanding-Beispiels aufgrund eines Abhängigkeitsproblems. Weitere Informationen finden Sie in diesem GitHub Problem.

Scene Understanding

Unterstützung für die Laufzeitprofilwechsel

MRTK ermöglicht jetzt den Profilwechsel sowohl vor der Initialisierung der MRTK-Instanz (d. h. Vor MRTK-Initialisierungsprofilschalter) als auch nach dem aktiven Einsatz eines Profils (d. h. aktiver Profilschalter). Der ehemalige Switch kann verwendet werden, um auswahlkomponenten basierend auf den Funktionen der Hardware zu aktivieren, während dieser verwendet werden kann, um die Benutzeroberfläche zu ändern, da der Benutzer einen Teil der Anwendung eingibt. Weitere Informationen und Codebeispiele finden Sie in der Dokumentation zum Profilwechsel .

Richtungsanzeige und Folgen von Solvern, die von experimentell abgestuft wurden

Zwei neue Solver sind für die Verwendung mit Hauptlinien-MRTK bereit.

Directional Indicator Solver

Hand-Coach, der von experimentell abgestuft wurde

Das Hand-Coach-Feature ist jetzt bereit für die Verwendung mit Hauptlinien MRTK.

Hand Coach Example

Dialogfeldsteuerelemente, die von experimentell abgestuft wurden

Dialogfeldsteuerelemente sind jetzt für die Verwendung mit Hauptlinien-MRTK bereit.

Dialog Controls

Pulse-Shader, der aus dem experimentellen Modell abgestuft wurde

Die Pulse-Shaderskripts haben sich aus dem Experimentellen abgestuft. Weitere Informationen finden Sie unter: Pulse Shader-Dokumentation

MRTK_SpatialMesh_Pulse

Verbesserungen des Eingabeaufzeichnungsdiensts

InputRecordingService und InputPlaybackService kann jetzt Augenblickeingaben aufzeichnen und wiedergeben. Die Aufzeichnung wurde optimiert, um eine konsistente Framerate im gesamten Aufzeichnungszeitraum zu gewährleisten, während die Größe der Aufzeichnungsdatei und die Speicherzeit um ca. 50 % reduziert werden. Das Speichern und Laden von Aufzeichnungsdateien kann jetzt asynchron ausgeführt werden. Beachten Sie, dass sich das Dateiformat der Aufzeichnung in dieser MRTK-Version geändert hat , finden Sie hier weitere Informationen zu den neuen Version 1.1-Spezifikationen.

Lesemodus

Unterstützung für den Lesemodus auf HoloLens 2 hinzugefügt. Der Lesemodus reduziert das Ansichtsfeld des Systems, entfernt jedoch eine Skalierung der Unity-Ausgabe. Ein von Unity gerendertes Pixel entspricht einem projizierten Pixel auf HoloLens 2. Anwendungsautoren sollten Tests mit mehreren Personen durchführen, um sicherzustellen, dass dies ein Handel ist, den sie in ihrer App wünschen.

Windows Mixed Reality reading mode

Unterstützung für 3D-App-Starteinrichtungen auf UWP

Fügt die Möglichkeit hinzu, ein 3D-App-Startfeld für UWP festzulegen. Diese Einstellung wird sowohl im MRTK-Buildfenster als auch im MRTK-Project Einstellungen unter Build Einstellungen verfügbar gemacht. Das Projekt wird während des Build in Unity automatisch in das Projekt geschrieben.

Build settings

Aktuelle Änderungen

Bestimmte Felder importierter GLTF-Objekte werden jetzt groß geschrieben.

Aufgrund der Deerialisierung beginnen einige Felder importierter GLTF-Objekte jetzt mit Großbuchstaben. Die betroffenen Felder sind (in ihren neuen Namen): ComponentType, TypeModePathMinFilterInterpolationWrapTTargetMagFilterWrapS.

Die Binärdatei für Eingabeanimationen verfügt über ein aktualisiertes Version 1.1-Format

Eingabeanimation binärdatei, die von InputRecordingService und InputPlaybackService, jetzt ein aktualisiertes Dateiformat verwendet wird, um die Optimierungen für diese beiden Dienste zu ermöglichen. Weitere Informationen zu den neuen Version 1.1-Spezifikationen finden Sie hier .

MSBuild für Unity-Unterstützung

Die Unterstützung für MSBuild für Unity wurde ab der Version 2.5.2 entfernt, um die neuen Paketleitlinien von Unity auszurichten.

Bekannte Probleme

OpenXR

Es gibt derzeit ein bekanntes Problem mit Holographic Remoting und OpenXR, wo Handgelenke nicht konsistent verfügbar sind. Darüber hinaus sind die Augenverfolgungsbeispiele derzeit nicht kompatibel, obwohl die Augenverfolgung funktioniert .

Einige Mixed Reality Toolkit Standard-Shaderfeatures erfordern das Foundation-Paket

Wenn sie über die Unity-Paket-Manager importiert werden, werden die MRTK-Standard-Shader-Hilfsskripts (ex: HoverLight.cs) nicht mit dem Shader im Standardressourcenpaket zusammengestellt. Um auf diese Funktionalität zuzugreifen, müssen Anwendungen das Foundation-Paket importieren.

CameraCache kann eine neue Kamera beim Herunterfahren erstellen.

In einigen Situationen (z. B. beim Verwenden des LeapMotion-Anbieters im Unity-Editor) ist es möglich, den CameraCache erneut zu erstellen, um die MainCamera zum Herunterfahren neu zu erstellen. Weitere Informationen finden Sie in diesem Problem .

FileNotFoundException, wenn Beispiele über Unity Paket-Manager importiert werden

Je nach Länge des Projektpfads generieren Importbeispiele über Unity Paket-Manager möglicherweise FileNotFoundException-Nachrichten in der Unity-Konsole. Die Ursache hierfür ist der Pfad zur "fehlenden" Datei, die länger als MAX_PATH (256 Zeichen) ist. Um die Lösung zu beheben, kürzen Sie die Länge des Projektpfads.

Es wurde kein Raumprogramm angegeben. Die Anwendung unterstützt keinen räumlichen Sound

Eine Warnung "Kein Raumprogramm wurde angegeben" wird angezeigt, wenn ein Audioraumisierer nicht konfiguriert ist. Dies kann auftreten, wenn kein XR-Paket installiert ist, da Unity Raumisierer in diesen Paketen enthält.

Um sie zu beheben, stellen Sie sicher, dass:

  • Fenster>Paket-Manager hat mindestens ein XR-Paket installiert

  • Mixed RealityToolkit-Dienstprogramme>>Konfigurieren von Unity Project und treffen Sie eine Auswahl für Audio Spatializer

    Select Audio Spatializer

NullReferenceException: Objektreferenz wird nicht auf eine Instanz eines Objekts festgelegt (SceneTransitionService.Initialize)

In einigen Situationen kann das Öffnen EyeTrackingDemo-00-RootScene eine NullReferenceException in der Initialize-Methode der SceneTransitionService-Klasse verursachen. Dieser Fehler liegt daran, dass das Konfigurationsprofil des Szenenübergangsdiensts nicht aktiviert ist. Um die Lösung zu beheben, verwenden Sie die folgenden Schritte:

  • Navigieren zum MixedRealityToolkit Objekt in der Hierarchie
  • Wählen Sie im Fenster "Inspektor" Extensions
  • Wenn nicht erweitert, erweitern Sie Scene Transition Service
  • Festlegen des Werts von Configuration ProfileMRTKExamplesHubSceneTransitionServiceProfile

Fix Scene Transition Profile

Oculus Quest

Es gibt derzeit ein bekanntes Problem für die Verwendung des Oculus XR-Plug-Ins bei der Ausrichtung auf eigenständige Plattformen. Überprüfen Sie die Oculus-Fehlerverfolgung/Foren/Versionshinweise für Updates.

Der Fehler ist mit diesem Satz von 3 Fehlern gekennzeichnet:

Oculus XR Plugin Error

UnityUI und TextMeshPro

Es gibt ein bekanntes Problem für neuere Versionen von TextMeshPro (1.5.0+ oder 2.1.1+), bei dem der Standardschriftgrad für Dropdowns und fett formatierten Schriftabstand geändert wurde.

TMP image

Dies kann durch Die Herabstufung auf eine frühere Version von TextMeshPro bearbeitet werden. Weitere Informationen finden Sie unter Problem #8556 .