Opmerkingen bij de release van Microsoft Mixed Reality Toolkit 2.6

Belangrijk

Er is een bekend compilerprobleem dat van invloed is op toepassingen die zijn gebouwd voor Microsoft HoloLens 2 met ARM64. Dit probleem is opgelost door Visual Studio 2019 bij te werken naar versie 16.8 of hoger. Als u Visual Studio niet kunt bijwerken, importeert u het com.microsoft.mixedreality.toolkit.tools pakket om een tijdelijke oplossing toe te passen.

Nieuw in 2.6.2

Corrigeert het ouderschap van de ruimtelijke mesh

Hiermee wordt het probleem opgelost waarbij ruimtelijke meshes niet goed werden geplaatst nadat het Mixed Reality Playspace-object werd verplaatst (bijvoorbeeld via een teleport).

Nieuw in 2.6.1

Oplossing dat OpenXR niet wordt uitgevoerd op HoloLens 2/UWP

Hiermee wordt een regressie opgelost waardoor de OpenXR-ondersteuning van MRTK niet kan worden uitgevoerd op UWP.

Fixes Leap Motion ObjectManipulator niet draaien

Hiermee wordt een regressie opgelost waarbij de draaiing van een Leap Motion-hand niet in aanmerking is genomen door het ObjectManipulator-script.

Voorbeeld van scène-updates

Updates de scène de voorbeeldscène begrijpt om de verzonden status van de Unity-invoegtoepassing correct weer te geven. Ook wordt het voorbeeld bijgewerkt zodat deze niet langer afhankelijk is van de voorbeeldscène voor ruimtelijk bewustzijn die wordt geïmporteerd. Voordat u bijwerkt naar 2.6.1, moet u de geïmporteerde voorbeelden voor scènes en ruimtelijk bewustzijn verwijderen als deze aanwezig zijn in uw project om mogelijke conflicten te voorkomen. Als u deze voorbeelden niet hebt verwijderd en wel conflicten ziet met betrekking tot de voorbeelden in de console, verwijdert u beide voorbeelden (of de Assets/Samples/Mixed Reality Toolkit Examples map) en probeert u opnieuw te importeren.

Updates de voorbeeldscène van het dialoogvenster om de huidige dialoogvensterscenario's correct te beschrijven.

Nieuw in 2.6.0


Ondersteuning toevoegen voor OpenXR

De eerste ondersteuning voor het OpenXR preview-pakket van Unity en het Mixed Reality OpenXR-pakket van Microsoft is toegevoegd. Zie de MRTK/XRSDK-pagina aan de slag, het forumbericht van Unity of de documentatie van Microsoft voor meer informatie.

Belangrijk

OpenXR in Unity wordt alleen ondersteund op Unity 2020.2 en hoger.

Momenteel worden ook alleen x64- en ARM64-builds ondersteund.

Hulpprogramma voor het wisselen van activa

Wissel meerdere assets in een Unity-scène met het nieuwe hulpprogramma Asset Swap.

HP Motion Controllers nu ondersteund met MRTK

Controllers voor de HP Reverb G2 werken nu systeemeigen met MRTK.

Experimenteel interactief element + status visualiseren

Interactive Element is een vereenvoudigd gecentraliseerd toegangspunt voor het MRTK-invoersysteem. Het bevat statusbeheermethoden, gebeurtenisbeheer en de statusinstellingslogica voor kerninteractiestatussen. Zie Documentatie voor interactieve elementen voor meer informatie.

InteractiveElementAddCoreState

State Visualizer is een animatieonderdeel dat afhankelijk is van het interactieve element. Met dit onderdeel maakt u Animatieclips, stelt u keyframes in en genereert u een Animator State Machine. Zie Documentatie voor State Visualizer voor meer informatie

StateVisualizerColorChangeOnFocus

Teleportatie met de teleportbeweging wordt nu ondersteund op alle platforms

Gebruikers kunnen nu de teleportbeweging gebruiken om door hun speelruimte te bewegen op alle platforms. Als u wilt teleporten met een controller op MR-apparaten met standaardconfiguraties, gebruikt u de duimstick. Als u wilt teleporteren met gearticuleerde handen, maakt u een gebaar met uw palm naar boven gericht met de wijsvinger en duim die naar buiten steekt, en voltooit u de teleport door de wijsvinger te krullen. Als u wilt teleporten met invoersimulatie, raadpleegt u onze bijgewerkte documentatie voor Input Simulation Service.

Teleport-beweging

Scene Understanding nu beschikbaar in MRTK als experimentele waarnemer van ruimtelijk bewustzijn

Experimentele ondersteuning van Scene Understanding is geïntroduceerd in MRTK 2.6. Gebruikers kunnen de kennismogelijkheden van de scène van HoloLens 2 opnemen als waarnemer van ruimtelijk bewustzijn in MRTK-projecten. Lees de documentatie over Scene Understanding voor meer informatie.

Belangrijk

Scene Understanding wordt alleen ondersteund op HoloLens 2 en Unity 2019.4 en hoger.

Voor deze functie is het Scene Understanding-pakket vereist, dat nu beschikbaar is via het hulpprogramma Mixed Reality functie. Wanneer u het hulpprogramma voor Mixed Reality functies gebruikt of op een andere manier importeert via UPM, importeert u de demo's - SpatialAwareness-voorbeeld voordat u het voorbeeld Experimental - SceneUnderstanding importeert vanwege een afhankelijkheidsprobleem. Raadpleeg dit GitHub-probleem voor meer informatie.

Inzicht in scènes

Ondersteuning voor het schakelen tussen runtimeprofielen

MRTK staat nu profielwisselingen toe, zowel vóór de initialisatie van het MRTK-exemplaar (dat wil weten vóór de MRTK-initialisatieprofielswitch) als nadat een profiel actief is gebruikt (dat wil weten actieve profielswitch). De eerste switch kan worden gebruikt om bepaalde onderdelen in te schakelen op basis van de mogelijkheden van de hardware, terwijl de laatste kan worden gebruikt om de ervaring te wijzigen wanneer de gebruiker een subonderdeel van de toepassing invoert. Lees de documentatie over profielwisseling voor meer informatie en codevoorbeelden.

Directionele indicator en volg oplossers afgestudeerd van experimentele

Twee nieuwe oplossers zijn klaar voor gebruik met mainline MRTK.

Directional Indicator Oplosser

Handcoach afgestudeerd van experimenteel

De functie Handcoach is nu klaar voor gebruik met mainline MRTK.

Voorbeeld van handcoach

Besturingselementen voor dialoogvensters die zijn afgetrokken van experimenteel

Dialoogvensterbesturingselementen zijn nu klaar voor gebruik met hoofdlijn MRTK.

Dialoogvensterbesturingselementen

Pulse shader is niet meer experimenteel

De Pulse-arceringsscripts zijn niet meer experimenteel. Zie voor meer informatie: Documentatie voor Pulse Shader

MRTK_SpatialMesh_Pulse

Verbeteringen van invoeropnameservice

InputRecordingService en InputPlaybackService kan nu ooggaarinvoer opnemen en afspelen. Opname is geoptimaliseerd om een consistente framesnelheid gedurende de opnameperiode te garanderen, terwijl de grootte van het opnamebestand en het besparen van tijd ook met ongeveer 50% worden verminderd. Het opslaan en laden van opnamebestanden kan nu asynchroon worden uitgevoerd. Houd er rekening mee dat de bestandsindeling van de opname is gewijzigd in deze MRTK-versie. Kijk hier voor meer informatie over de nieuwe versie 1.1 specificaties.

Leesmodus

Ondersteuning toegevoegd voor de leesmodus op HoloLens 2. De leesmodus vermindert het weergaveveld van het systeem, maar elimineert het schalen van de uitvoer van Unity. Een pixel die door Unity wordt weergegeven, komt overeen met een geprojecteerde pixel op HoloLens 2. Auteurs van toepassingen moeten tests uitvoeren met meerdere personen om er zeker van te zijn dat dit een compromis is dat ze in hun app willen hebben.

Windows Mixed Reality leesmodus

Ondersteuning voor startprogramma's voor 3D-apps op UWP

Hiermee wordt de mogelijkheid toegevoegd om een 3D-startprogramma voor apps in te stellen voor UWP. Deze instelling wordt weergegeven in zowel het MRTK-buildvenster als de MRTK-projectinstellingen, onder Build-instellingen. Deze wordt automatisch in het project geschreven tijdens de build in Unity.

Build-instellingen

Wijzigingen die fouten veroorzaken

Bepaalde velden van geïmporteerde GLTF-objecten worden nu met hoofdletters gebruikt

Vanwege problemen met betrekking tot deserialisatie beginnen sommige velden met geïmporteerde GLTF-objecten nu met hoofdletters. De betrokken velden zijn (in hun nieuwe naam): , , , , , , , MagFilter, MinFilter, , WrapS. WrapTModeTargetTypeInterpolationPathComponentType

Binaire invoeranimatiebestand heeft een bijgewerkte versie 1.1-indeling

Invoeranimatie binair bestand, gebruikt door InputRecordingService en InputPlaybackService, heeft nu een bijgewerkte bestandsindeling om de optimalisaties voor deze twee services in te schakelen. Kijk hier voor meer informatie over de nieuwe versie 1.1-specificaties.

ONDERSTEUNING voor MSBuild voor Unity

Ondersteuning voor MSBuild voor Unity is verwijderd vanaf de versie 2.5.2, in overeenstemming met de nieuwe pakketrichtlijnen van Unity.

Bekende problemen

OpenXR

Er is momenteel een bekend probleem met Holographic Remoting en OpenXR, waarbij handgewrichten niet consistent beschikbaar zijn. Bovendien zijn de voorbeeldscènes voor oogtracering momenteel niet compatibel, hoewel oogtracering wel werkt.

Voor sommige Mixed Reality Toolkit Standard Shader-functies is het Foundation-pakket vereist

Wanneer de MRTK Standard Shader-hulpprogramma's (bijvoorbeeld HoverLight.cs) worden geïmporteerd via Unity Package Manager, worden ze niet op dezelfde locatie geplaatst als de arcering in het Standard Assets-pakket. Voor toegang tot deze functionaliteit moeten toepassingen het Foundation-pakket importeren.

CameraCache kan een nieuwe camera maken bij afsluiten

In sommige situaties (bijvoorbeeld bij het gebruik van de LeapMotion-provider in de Unity-editor), is het mogelijk dat de CameraCache de MainCamera opnieuw maakt bij afsluiten. Zie dit probleem voor meer informatie.

FileNotFoundException wanneer voorbeelden worden geïmporteerd via Unity Package Manager

Afhankelijk van de lengte van het projectpad kan het importeren van voorbeelden via Unity Package Manager FileNotFoundException-berichten genereren in de Unity-console. De oorzaak hiervan is dat het pad naar het 'ontbrekende' bestand langer is dan MAX_PATH (256 tekens). U kunt dit oplossen door de lengte van het projectpad in te korten.

Er is geen spatializer opgegeven. De toepassing biedt geen ondersteuning voor ruimtelijk geluid

De waarschuwing 'Er is geen spatializer opgegeven' wordt weergegeven als er geen audio spatializer is geconfigureerd. Dit kan gebeuren als er geen XR-pakket is geïnstalleerd, omdat Unity spatializers in deze pakketten bevat.

Als u dit wilt oplossen, moet u ervoor zorgen dat:

  • Venster>Package Manager heeft een of meer XR-pakketten geïnstalleerd

  • Mixed RealityHulpprogramma's> voor toolkit>Unity-project configureren en een selectie maken voor Audio Spatializer

    Selecteer Audio Spatializer

NullReferenceException: Objectverwijzing is niet ingesteld op een exemplaar van een object (SceneTransitionService.Initialize)

In sommige situaties kan het openen EyeTrackingDemo-00-RootScene een NullReferenceException veroorzaken in de methode Initialize van de klasse SceneTransitionService. Deze fout wordt veroorzaakt doordat het configuratieprofiel van de Scene Transition Service niet is ingesteld. Gebruik de volgende stappen om dit op te lossen:

  • Navigeer naar het MixedRealityToolkit object in de hiërarchie
  • Selecteer in het venster Inspector Extensions
  • Als dit niet is uitgevouwen, vouwt u uit Scene Transition Service
  • Stel de waarde van Configuration Profile in op MRTKExamplesHubSceneTransitionServiceProfile

Scèneovergangsprofiel herstellen

Oculus Quest

Er is momenteel een bekend probleem met het gebruik van de Oculus XR-invoegtoepassing bij het richten op zelfstandige platforms. Controleer de Oculus-bugtracker/-forums/releaseopmerkingen voor updates.

De fout wordt gekwalificeerd met deze set van 3 fouten:

Fout met Oculus XR-invoegtoepassing

UnityUI en TextMeshPro

Er is een bekend probleem voor nieuwere versies van TextMeshPro (1.5.0+ of 2.1.1+), waarbij de standaardtekengrootte voor vervolgkeuzelijsten en vetgedrukte tekenafstand is gewijzigd.

TMP-installatiekopieën

U kunt dit omzeilen door te downgraden naar een eerdere versie van TextMeshPro. Zie probleem #8556 voor meer informatie.