Versionsanmerkungen zu Microsoft Mixed Reality Toolkit 2.7

Neuigkeiten in 2.7.3

Ein besonderer Dank aus Redmond

Das MRTK-Team möchte Ihnen, der MRTK-Community, den herzlichsten Dank aussprechen. Ihre Beiträge, Ihr Feedback und Ihre Stimmen haben einen großen Anteil daran, dass MRTK den Auggie Award für das beste Entwicklertool 2021 gewinnen konnte. Ohne Ihre Unterstützung wären wir heute nicht dort, wo wir stehen. Gleich ob für neu hinzugefügte Plattformunterstützung, neue Features, behobene Fehler, Vorschläge, Fragen oder eine der vielen anderen Mitwirkungsformen: vielen Dank!

Unity 2021-Unterstützung

Mit der Veröffentlichung von 2.7.3 haben wir das Erstellen von Builds in Unity 2021 vereinfacht! Wenn bei der Verwendung von MRTK mit Unity 2021 Probleme auftreten, melden Sie ein Problem in unserem GitHub-Repository.

Scene Understanding über Remotingunterstützung (nur OpenXR)

Scene Understanding ist jetzt während des Remotings auf der HoloLens 2 mit OpenXR-Plattform verfügbar.

Fehlerbehebungen und Änderungen in MRTK 2.7.3

• Die Erstellung eines CustomProfiles-Ordners wurde aufgegeben, es sei denn, ein Profil wurde in diesen Ordner geklont #9916
• Aufrufe von .gameObject in GameObjects wurden entfernt #9939
• Ein Fehler wurde behoben, bei dem Objekte mit deaktivierten Komponenten dazu führen konnten, dass Zeiger eine Fokussperre erhielten #9945
• Aktualisierung der veralteten Methoden und behobenen Compilerfehler für Unity 2021 #9938
• Korrigiert: link.xml für Unity 2021 #9942
• Aktualisierung des Schaltflächen-Konfigurationsinspektors, der jetzt Symbolnamen anzeigt #9972
• Aktualisierung von Header und Ausrichtung der Controllerzuordnungsliste #9976
• Verschiedene Unity-Verbesserungen für MRTK #9940
• Behoben: Colliderprobleme und Inkonsistenz bei BoundsControl#9973
• Korrektur der Schaltflächensymbolsatz-Inspektoren #9999
• Korrektur der Skalierungshandle-Colliderausrichtung bei BoundsControl#10007
• Korrigiert: Kategorisierung der SDF-Schriftarttextur #10006
• Korrigiert: automatisches Vereinfachen und Skalierungshandleausrichtung bei BoundsControl#10013
• Hinzugefügt: Feedback zur Korrektur der Vereinfachung für BoundsControl#10016
• Korrigiert: Ungewöhnliche Gitterverformungen bei Hand-Mesh während der Wiedergabe von Animationen #10024
• Korrigiert: Protokollierung und SpatialAwarenessSurfaceTypes für Scene Understanding #10026
• Hinzugefügt: Eigenständige Definitionsanweisung zum Skript der Leap-Beispielszene #10036
• Korrigiert:OnEnable-Problem in BoundsControl, wenn im Editor ein nicht standardmäßiger Aktivierungstyp angegeben wurde #10039
• Korrigiert: Fehler wegen ungültiger Shader-Bytecodes für OpenGL ES und Metal #10041
• Hinzugefügt: ClearProgressBar-Aufruf zum Korrigieren des Einfrierens des Buildfensters in Unity 2020 #10046
• Aktualisiert: Serialisierung für Schriftartenressourcen #10047
• Korrigiert: Handinteraktionsszene, um ordnungsgemäße Collider für Schieberegler zum Anheften zu erhalten #10060
• Korrigiert: Quaternion-Berechnung für Oberflächenmagnetismus #10074
• Verbessert: Versionsmeldungen der PV-Kamera #10077
• Korrigiert: BoundingBoxHelper.GetRawBoundsCorners-Schutzebene #10093
• Aktualisiert: gLTF-Importprotokolle auf ein Protokoll statt mehreren #10090
• Entfernt: MRSceneContent-Skript aus Szenen, in denen kein MRTK enthalten ist #10091
• Entfernt: Paketbasierte Ereignissysteme aus Beispielszenen für Unity 2018-Kompatibilität #10092
• Entfernt: Unterstützung für Microsoft OpenXR-Vorschaupakete #10119
• Behoben: Einfrieren von Apps beim Empfangen von Daten #10033
• Korrigiert: EyeTrackingTarget löst beim Übergang von Collider mit EyeTrackingTarget zu einem Collider ohne nicht aus #10127
• Geändert: Standardausdehnung des Zeigers, um das Mauszeigerverhalten intuitiver zu gestalten #10075
• Aktualisiert: Zusammenfassung zur Verdeutlichung, wann die Initialisierung ausgeführt wird #10177
• Korrigiert: NullReferenceException-Problem in LinePointer#10190
• Korrigiert: BoundsControl mit Problemen wegen nicht einheitlicher Skalierung #10133
• Korrigiert: Behandlung von IOSMinOSVersion in verschiedenen Kulturen #10178
• Entfernt: Zusätzliche Raycasts von Objekten mit Anvisier-Unterstützung #10162
• Hinzugefügt: QuickInfos beim Zeigen auf die verschiedenen Profile im Editor-Inspektor für das MixedRealityToolkit-Prefab #10180
• Behoben: Dropdownmenü für Sprachbefehle und Updatebefehle in EyeTrackingExample #10197
• Korrigiert: 'gLTF'-Objekte, die beim Laden mit dem Standard-Shader von Unity schwarz angezeigt werden #10209
• Korrigiert: UnityTouchDeviceManager aktualisiert sich selbst, wenn die IsEnabled-Eigenschaft FALSE ist #10203
• Aktualisiert: Ein Eigenschaftenname im Hilfsmodul der Konfigurationsschaltfläche #10221
• Korrigiert: Koordinatenraum, Wickelreihenfolge und Kulturformatierung im Objekt-Explorer #10208
• Hinzugefügt: Option zum Verschieben des Greifpunkts zur Fingerspitze #10206
• Hinzugefügt: Unterstützung für Leap UnityModules 4.9.1 #10282
• Rückportierung einiger geringfügiger Änderungen an ReserializeAssetsUtility.cs#10280
• Konvertiert: Falsche Verwendungen von enumValueIndex in intValue#10274
• Behoben: Driften von Objekten bei der Manipulation in der Nähe #10294
• Behoben: Fälle, in denen die Begrenzungssteuerung aggressiv andere Komponenten entfernte #10296
• Behoben: Flimmerndes Näherungslicht #10325
• Hinzugefügt: Überprüfung, um festzustellen, ob etwas in Ereignisse eingebunden ist, bevor bestimmt wird, ob diese Ereignisse ausgelöst werden #10330
• Geändert: Verschiedene kleinere Dinge #10316
• Eingeführt: Alternative zu HasFlag #10319
• Verringert: Spam im Debugprotokoll des HandConstraint-Solvers #10331
• Korrigiert: Protokollspam, der von HandConstraintPalmUp.cs stammt #10326
• Aktiviert: Scene Understanding für Holographic Remoting über OpenXR #10338
• Hinzugefügt: Parameterloser Konstruktor für InteractableOnClickReceiver #10353
• Verschoben: FingerChaser-Prefab in den Common-Ordner im Beispielpaket #10358
• Hinzugefügt: Fallbackfall für artikulierte Handauswahl in OpenXR #10359
• Behoben: Problem mit dem UPM-Import einer Windows Mic Stream-Demo #10362
• Umbenannt: OpenXR-Profile #10363
• Verbesserte: Ausgabe des Raycast-Trefferprotokolls mit Unity 2021 und Behoben: Absturz bei Verwendung von AssetBundles #10370
• Aktualisiert: Zeichenfolgen auf const und Cachetyp zum Reduzieren der Anzahl der Zuweisungen #10369
• Korrigiert: XRSDK-basierte Mesh-Beobachter bei Verwendung von App-basiertem Holographic Remoting #10366
• Integrierte Oculus-Visualisierung #10067
• Hinzugefügt: Dokumentation für BoundsControl-Eigenschaften #10361
• Korrigiert: Prefab für die Handgelenksverfolgung #10377
• Behoben: Bereitstellungsfehler für Oculus Quest 10374
• Behoben: Problem mit Scene Understanding-Beispielszenenprofil #10368
• Behoben: MRTK-Konsolenfehler beim Importieren in die neuesten Versionen von Unity 2021.2 #10182
• Hinzugefügt: Fehlende Dokumentation zum Ändern von Cursorn #4934
• Verbessert: Anweisungen auf der Releaseseite des MRTK Unity-Pakets, um sie klarer zu machen #9575
• Behoben: Problem, bei dem die Demoszene für die MicStream-Auswahl keine Sprache verarbeitet hat (UPM-Paket) #9908
• Behoben: Problem, bei dem Beispiele nicht einzeln in das MRTK-Beispielpaket importiert werden konnten #10216
• Hinzugefügt: Fehlende Dokumentation zu BoundsControl für einige Eigenschaften #10346
• Behoben: Ein Fehler, bei dem InteractableOnClickReceiver keinem Spielobjekt mit einer interaktiven Komponente hinzugefügt werden konnte #10341

Neuerungen in 2.7.2

Ein Problem mit der UPM-Paketabhängigkeit wurde behoben

Es bestand ein Problem mit MRTK 2.7.1-UPM-Paketen, das dazu führte, dass die Abhängigkeiten nicht ordnungsgemäß eingerichtet wurden. Das Problem bewirkte, dass das Mixed Reality Feature-Tool MRTK 2.7.1-Pakete nicht ordnungsgemäß importiert. Das Problem wurde nun in 2.7.2 behoben. Es gibt keine Codeänderung in dieser Version gegenüber 2.7.1.

Neuerungen in 2.7.1

Version anzeigen

Das Menü Mixed Reality > Toolkit enthält jetzt einen Eintrag Version anzeigen..., der das Mixed Reality Toolkit Foundation-Paket untersucht, um die Version von MRTK zu bestimmen, die vom Projekt verwendet wird.

Hinweis

Wenn MRTK aus dem GitHub-Repository geklont wird, werden die Versionsinformationen nicht festgelegt.

Autorenliste

Von MRTK 2.7.1 an aufwärts ist die Autorenlistendatei im Mixed Reality Toolkit Foundation-Paket enthalten.

In den Konfigurator-Setupflow integriertes OpenXR-Projektsetup

Ab MRTK 2.7.1 erhalten Benutzer des Mixed Reality OpenXR-Plug-Ins Anweisungen zum Einrichten dieses Plug-Ins in MRTK. Es gibt eine Option für Benutzer mit der Zielplattform HoloLens 2, die empfohlenen Einstellungen automatisch anzuwenden.

Wichtige Fehlerbehebungen und Änderungen

• Unity Joystick-Manager in XR SDK-Pipeline als unterstützt gekennzeichnet #9954, #9994
• Zusätzliche Überprüfungen für interaktiven Inspektorcode, um NULL-Fehler zu verhindern #9943
• OpenXR-Gitternetzanbieter zur Impuls-Shader-Beispielszene hinzugefügt #9902
• Wiederherstellen des Handmechanikprofils in Beispielszene #9915
• Einige Bereinigungen in den HandConstraint-Skripts #9935
• Es wurden einige Fehler behoben, die sich auf das Erstellen und Klonen von Profilen auswirken #9982

Neuerungen in 2.7.0

OpenXR wird im MRTK jetzt offiziell unterstützt

Da die neuen OpenXR-Plug-Ins immer ausgereifter werden, unterstützt MRTK jetzt offiziell OpenXR. Im Vergleich zu früheren Releases haben wir Projekten mit OpenXR die folgenden Funktionen hinzugefügt:

• Unterstützung für das vom System bereitgestellte Motion Controller-Modell
• Unterstützung für WinMR-Gesten (Auswählen, Halten, Bearbeiten und Navigation) #9843
• Unterstützung für Controller-Haptik
• Unterstützung für ein artikuliertes Hand-Mesh in HoloLens 2
• Unterstützung für räumliche Abbildung in HoloLens 2 #9567, #9827
• Unterstützung für Scene Understanding in HoloLens 2 #9744

Wenn Sie HoloLens 2 oder Windows Mixed Reality-Headsets als Zielplattform über OpenXR ansteuern, achten Sie darauf, mithilfe des Mixed Reality Feature-Tools die Mixed Reality OpenXR-Plug-In-Version 0.9.5 oder höher zu installieren oder auf diese zu aktualisieren, andernfalls entgehen Ihnen einige der vorstehend genannten Verbesserungen.

Legacy-XR- und XR SDK-Datenanbieter können jetzt innerhalb desselben Profils verwendet werden

Datenanbieter werden jetzt außerdem nur dann geladen, wenn die entsprechende Pipeline ausgewählt ist, sodass sowohl Legacy-XR- als auch XR SDK-Datenanbieter innerhalb desselben Profils gleichzeitig vorhanden sein können. Um dies zu berücksichtigen, sind Legacy XR- und XR SDK-Datenanbieter jetzt auf verschiedenen Registerkarten in der Profilansicht organisiert. Diese Organisation soll dabei helfen, festzustellen, ob das richtige Profil für die gewünschte XR-Pipeline ausgewählt ist.

Zu diesem Zweck werden im Profilinspektor keine NULL-Daten mehr geladen und angezeigt. Benutzer können unter Bearbeiten > Projekteinstellungen > Mixed Reality ToolkitShow null data providers in the profile inspector umschalten, um unerwartetes Verhalten bei fehlenden Datenanbietern zu debuggen.

Zusätzliche Einstellungen für die Benutzererfahrung und ein zugeordnetes Verhalten von Mixed Reality-Szeneninhalten

Benutzer können jetzt Einstellungen für die Benutzererfahrung konfigurieren, die MRTK ausgehend von der Zielerfahrung die angemessene Darstellung von Mixed Reality-Szeneninhalten ermöglichen.

Wenn die bisherigen Einstellungen eines Benutzers für die Erfahrungsskala nicht mit dem neuen Profil für Benutzeroberflächeneinstellungen übereinstimmt, wird er aufgefordert, sie im Inspektor zu korrigieren

Der neu gestaltete Konfigurator führt den Benutzer jetzt durch den Setupvorgang

Der neue MRTK-Konfigurator bietet Benutzern Schritt-für-Schritt-Anleitungen, um das Projekt ordnungsgemäß für die XR-Entwicklung und die Verwendung mit MRTK zu konfigurieren. Sie behandeln die Auswahl der XR-Pipeline, das Abrufen der plattformspezifischen Plug-Ins, das Importieren von TextMeshPro, das Anzeigen der Beispiele (bei Verwendung von UPM) und andere zuvor enthaltene empfohlene Einstellungen für das Projekt.

Anerkannter Teleport-Hotspot

Eine neue Teleport-Hotspotkomponente wurde anerkannt. Sie können Ihrem GameObject einen Teleport-Hotspot hinzufügen, um sicherzustellen, dass sich der Benutzer beim Teleportieren an diesen Ort in einer bestimmten Position und Ausrichtung befindet.

Anerkanntes Verweilen

Die Verweilen-Funktion und das entsprechende Beispiel sind jetzt dem experimentellen Stadium entwachsen und anerkannt. Neue Beispiele für volumetrische Schaltflächen im HoloLens 2-Stil sind in der Beispielszene enthalten.

Neu hinzugefügte Unterstützung für Leap Motion Unity-Module der Versionen 4.6.0, 4.7.0, 4.7.1 und 4.8.0

Die Unterstützung für die neuesten Versionen der Leap Motion Unity-Module ist jetzt mit MRTK 2.7.0 kompatibel. Weitere Informationen finden Sie unter Konfigurieren von MRTK für Leap Motion.

Vielen Dank an @jackyangzzh für seinen Beitrag, die neue LeapMotionOrientationExample-Szene!

Auslösung von zielgerichteten Sprachereignissen nicht mehr auf den Anvisieren-Cursor beschränkt

Bisher konnten zielgerichtete Sprachereignisse nur für Objekte ausgelöst werden, die ihren Fokus durch den Anvisieren-Cursor erhalten hatten. Jetzt können Objekte Sprachereignisse unabhängig davon empfangen, durch welchen Cursor sie den Fokus erhalten.

TextToSpeech wurde von HTK zu MRTK portiert

Das beliebte TextToSpeech-Skript ist nun im MRTK verfügbar, damit Sie mithilfe von SpeechSynthesizer auf der UWP-Plattform Sprache aus Text generieren können. Außerdem wurde eine Beispielszene hinzugefügt, um die Funktion zu veranschaulichen.

Unterstützung für das vom System bereitgestellte Motion Controller-Modell in OpenXR

Sowohl im Editor als auch zur Laufzeit steht jetzt in OpenXR Unterstützung für das vom System bereitgestellte Motion Controller-Modell zur Verfügung.

Unterstützung für das artikulierte Hand-Mesh von HoloLens 2 in OpenXR

Unterstützung für Controllerhaptik in Legacy-WMR, dem Windows XR-Plug-In und OpenXR

Unterstützung für Controllerhaptik wurde für Legacy-WMR, das Windows XR-Plug-In und OpenXR hinzugefügt. #9735

Unterstützung für Eyetracking im Windows XR-Plug-In

Neu hinzugefügte Unterstützung für Anvisieren bei Verwendung der Mindestversionen 2.7.0 (Unity 2019), 4.4.2 (Unity 2020) oder 5.2.2 (Unity 2021) des Windows XR-Plug-Ins. #9609

Wichtige Fehlerbehebungen und Änderungen

• Die Zusammendrücken-Erkennung arbeitet jetzt reibungsloser. Es ist jetzt schwieriger, die Zusammendrücken-Geste versehentlich einzugeben. #9576
• Objekte behalten jetzt in der Objektmanipulatorkomponente durchgängig die Geschwindigkeit bei, wenn das Flag gesetzt ist. #9733
• Die Hintergrundprüfung prüft jetzt auf einen Boden, um Situationen zu verhindern, in denen die Kamera in der Umgebung befestigt wird oder der Benutzer im leeren Raum schwebt.#9697
• IsNearObject ist jetzt eine virtuelle Eigenschaft, was mehr Flexibilität beim Erweitern der Kugel oder des Poke-Zeigers bietet. #9803
• Schaltflächen zeigen jetzt das richtige Schlüsselwort an, wenn der verfügbare Sprachbefehl angezeigt wird. #9824
• Oculus-Controller verwenden jetzt eine eigene eigenständige Schnellansicht, was Konflikte zwischen der MRTK-Visualisierung und der Visualisierung des Oculus-Integrationspakets verhindert. #9589
• Tastaturbezogene Skripts wurden geändert, um dem Verhalten in den neuesten Unity-Versionen (2019.4.25 und höher sowie 2020.3.2 und höher) zu entsprechen. Zum Zeitpunkt der Veröffentlichung besteht immer noch ein Fehler bei der automatischen Vervollständigung und ein Fehler im TMP-Eingabefeld (beide sind zu MRTK extern), die HoloLens betreffen. Weitere Informationen finden Sie unter #9056 und #9724.
• Verbesserte Leistung der Scrolling-Objektsammlung. Außerdem wurde ein Problem behoben, das zum Verlust von Material des GameObject innerhalb der Sammlung beim Duplizieren führte. #9813, #9718
• Im Scene Understanding-Demoskript wurde die Funktion GetSceneObjectsOfType hinzugefügt, um alle beobachteten Szenenobjekte einer bestimmten Art abzurufen. #9524, #9744
• Im Befehlszeilen-Buildtool werden nur Szenen in den Build aufgenommen, die durch das Flag sceneList oder sceneListFile gekennzeichnet sind (falls Flags vorhanden sind). #9695
• Im Buildtool gibt es eine neue Option zum Angeben eines Pfads zu nuget.exe und zum Verwenden dieses Pfads zum Ausführen der Paketwiederherstellung anstelle der Option msbuild (Standardoption). #9556
• Das Problem, bei dem die Verwendung des Windows XR-Plug-Ins zu veralteten Handgelenken und doppelten Hand-Meshes führen konnte, wurde behoben. #9890
• Das Problem, bei dem die Verwendung des automatischen Remotingfeatures des Windows XR-Plug-Ins zu fehlenden Eingaben und Interaktionen führen konnte, wurde behoben. #9868
• Das Problem wurde behoben, bei dem das BuildDeployWindow versuchte, für den Windows SDK-Pfad einen ungültigen Registrierungsschlüssel abzufragen. #9664
• Die glTF-Importmodule des MRTK sind jetzt optional. Wenn mehrere glTF-Importmodule vorhanden sind, können diejenigen des MRTK durch Hinzufügen von MRTK_GLTF_IMPORTER_OFF zur Symboldefinition von benutzerdefinierten Skripts deaktiviert werden. #9658
• Ein Problem wurde behoben, bei dem die Knuckles-Controllers unter OpenVR nicht ordnungsgemäß erkannt wurden. #9881
• Verringern der Anzahl der Zuweisungen pro Einzelbild beim Visualisieren des Hand-Meshs #9756
• Neu hinzugefügtes Menüelement zum Starten des MRTK-Beispielpakets (im Unity-Paket-Manager), um das Importieren von Beispielen zu vereinfachen #9798
• Die Anzahl der Warnungen zur Ladezeit beim Verwenden von Unity 2020.3 wurde verringert.
• Neu hinzugefügte Dokumentation zum Erstellen-Fenster-Feature: Seite besuchen

Bekannte Probleme

In den Audiodemos fehlt eine asmdef-Datei (UPM-Paket)

Beim Importieren von MRTK mithilfe des Mixed Reality Feature-Tools werden dem Projekt Beispiele und Demos über die Benutzeroberfläche des Unity-Paket-Managers hinzugefügt. Nachdem die Audiodemos importiert wurden, verhält sich die WindowsMicrophoneStreamDemo.unity-Szene nicht ordnungsgemäß. Dieses Verhalten ist die Folge einer fehlenden ASMDEF-Datei für das Beispiel.

Führen Sie die folgenden Schritte aus, um das Problem zu umgehen:

• Kopieren Sie Library/PackageCache/com.microsoft.mixedreality.toolkit.examples@[...]/MRTK.Examples.asmdef in Ihren Ordner „Assets/Samples/Mixed Reality Toolkit Examples“
• Benennen Sie die kopierte Datei in „Examples“ um
• Öffnen Sie die Datei „Examples“
• Ersetzen Sie im Namenfeld den Inhalt durch „Examples“
• Klicken Sie auf „Übernehmen“
• Erstellen und Bereitstellen

Dieses Problem wird in einer zukünftigen MRTK-Version behoben.

Das MRTK-Buildfenster löst ein nicht endendes Dialogfeld „Importieren von Medienobjekten“ in Unity 2020.3 aus

Es gibt ein bekanntes Problem mit dem MRTK-Buildfenster in Unity 2020.3, bei dem das Dialogfeld „Importieren von Medienobjekten“ nach einem UWP-Build nicht abgeschlossen wird. Dieses Problem wird in Zusammenarbeit mit Unity untersucht.

Text Mesh Pro Canvas-Rendererwarnungen in Unity 2020

Wenn Unity 2020 verwendet wird, wird in den meisten MRTK-Beispielszenen die folgende Warnung protokolliert:

Please remove the `CanvasRenderer` component from the [TextMeshPro] GameObject as this component is no longer necessary.

Die Canvas-Rendererwarnung wurde in TextMeshPro-Version 3.0.3 hinzugefügt. Diese Warnungen wirken sich nicht auf die MRTK-Beispielszenen aus und können über die Konsole entfernt werden. Weitere Informationen finden Sie unter Problem 9811.