Aktivera placering av 3D-modeller i mixed reality-hemmet

Anteckning

Den här funktionen lades till som en del av uppdateringen Windows 10 april 2018. Äldre versioner av Windows är inte kompatibla med den här funktionen.

Den Windows Mixed Reality hem är startpunkten där användarna landar innan de startar program. I vissa scenarier möjliggör 2D-appar (till exempel Holograms-appen) placering av 3D-modeller direkt i mixed reality-hemmet som dekorationer eller för ytterligare inspektion i fullständig 3D. Med protokollet lägg till modell kan du skicka en 3D-modell från din webbplats eller ditt program direkt till Windows Mixed Reality hem, där den bevaras som 3D-appstartare, 2D-appar och hologram.

Om du till exempel utvecklar ett program som visar en katalog med 3D-möbler för att utforma ett utrymme använder du protokollet lägg till modell för att låta användarna placera dessa 3D-möbelmodeller från katalogen. När användarna väl har placerats i världen kan de flytta, ändra storlek på och ta bort dessa 3D-modeller precis som andra hologram i hemmet. Den här artikeln innehåller en översikt över hur du implementerar tilläggsmodellprotokollet för att göra det möjligt för användare att dekorera sin värld med 3D-objekt från din app eller webben.

Stöd för enheter

Funktion HoloLens Integrerande headset
Lägg till modellprotokoll ✔️ ✔️

Grunderna

Det finns två steg för att aktivera placeringen av 3D-modeller i Windows Mixed Reality hem:

  1. Se till att din 3D-modell är kompatibel med Windows Mixed Reality hem.
  2. Implementera protokollet lägg till modell i ditt program eller din webbsida (den här artikeln).

Implementera protokollet lägg till modell

När du har en kompatibel 3D-modell kan du implementera protokollet add model genom att aktivera följande URI från valfri webbsida eller ett program:

ms-mixedreality:addmodel?uri=<Path to a .glb 3D model either local or remote>

Om URI:n pekar på en fjärrresurs hämtas den automatiskt och placeras i hemmet. Lokala resurser kopieras till mixed reality-hemmets appdatamapp innan de placeras i hemmet. Vi rekommenderar att du utformar din upplevelse för att ta hänsyn till scenarier där användaren kanske kör en äldre version av Windows som inte stöder den här funktionen genom att dölja knappen eller inaktivera den om möjligt.

Anropa protokollet lägg till modell från en Universell Windows-plattform app:

private async void launchURI_Click(object sender, RoutedEventArgs e)
{
   // Define the add model URI
   var uriAddModel = new Uri(@"ms-mixedreality:addModel?uri=sample.glb");

   // Launch the URI to invoke the placement
   var success = await Windows.System.Launcher.LaunchUriAsync(uriAddModel);

   if (success)
   {
      // URI launched
   }
   else
   {
      // URI launch failed
   }
}

Anropar protokollet lägg till modell från en webbsida:

<a class="btn btn-default" href="ms-mixedreality:addModel?uri=sample.glb"> Place 3D Model </a>

Överväganden för integrerande (VR)-headset

  • För integrerande (VR)-headset behöver Mixed Reality-portalen inte köras innan tilläggsmodellprotokollet anropas. I det här fallet startar protokollet lägg till modell Mixed Reality-portalen och placerar objektet direkt där headsetet tittar när du kommer till mixed reality-hemmet.
  • När du anropar protokollet lägg till modell från skrivbordet med Mixed Reality-portalen redan igång kontrollerar du att headsetet är "vaken". Annars lyckas inte placeringen.

Se även