Plaatsing van 3D-modellen in de startpagina van mixed reality inschakelen

Artikel
07/12/2023

Notitie

Deze functie is toegevoegd als onderdeel van de update van Windows 10 april 2018. Oudere versies van Windows zijn niet compatibel met deze functie.

De Windows Mixed Reality home is het beginpunt waar gebruikers terechtkomen voordat ze toepassingen starten. In sommige scenario's kunnen 2D-apps (zoals de hologrammen-app) 3D-modellen rechtstreeks in het mixed reality-huis plaatsen als decoraties of voor verdere inspectie in volledig 3D. Met het protocol voor het toevoegen van een model kunt u een 3D-model rechtstreeks vanuit uw website of toepassing verzenden naar de Windows Mixed Reality startpagina, waar het blijft bestaan, zoals startprogramma's voor 3D-apps, 2D-apps en hologrammen.

Als u bijvoorbeeld een toepassing ontwikkelt waarmee een catalogus met 3D-meubels wordt weergegeven voor het ontwerpen van een ruimte, gebruikt u het protocol model toevoegen om gebruikers in staat te stellen deze 3D-meubelmodellen uit de catalogus te plaatsen. Eenmaal ter wereld geplaatst, kunnen gebruikers deze 3D-modellen verplaatsen, het formaat ervan wijzigen en deze verwijderen, net als andere hologrammen thuis. Dit artikel bevat een overzicht van het implementeren van het protocol voor het toevoegen van modellen, zodat gebruikers hun wereld kunnen inrichten met 3D-objecten vanuit uw app of het web.

Ondersteuning voor apparaten

Functie	HoloLens	Immersive headsets
Modelprotocol toevoegen	✔️	✔️

De basisbeginselen

Er zijn twee stappen voor het inschakelen van de plaatsing van 3D-modellen in de Windows Mixed Reality home:

Zorg ervoor dat uw 3D-model compatibel is met de Windows Mixed Reality home.
Implementeer het protocol voor het toevoegen van modellen in uw toepassing of webpagina (dit artikel).

Het protocol voor het toevoegen van modellen implementeren

Zodra u een compatibel 3D-model hebt, kunt u het protocol voor het toevoegen van het model implementeren door de volgende URI vanaf elke webpagina of toepassing te activeren:

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

Als de URI verwijst naar een externe resource, wordt deze automatisch gedownload en in de startpagina geplaatst. Lokale resources worden gekopieerd naar de map met app-gegevens van de mixed reality-startpagina voordat ze in de startpagina worden geplaatst. We raden u aan uw ervaring te ontwerpen om rekening te houden met scenario's waarin de gebruiker mogelijk een oudere versie van Windows gebruikt die deze functie niet ondersteunt door de knop te verbergen of indien mogelijk uit te schakelen.

Het protocol voor het toevoegen van een model aanroepen vanuit een Universeel Windows-platform-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
   }
}

Het protocol voor het toevoegen van een model aanroepen vanaf een webpagina:

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

Overwegingen voor immersive (VR)-headsets

Voor insluitende headsets (VR) hoeft de Mixed Reality Portal niet te worden uitgevoerd voordat het protocol voor het toevoegen van het model wordt aanroepen. In dit geval wordt met het protocol voor het toevoegen van het model de Mixed Reality Portal gestart en wordt het object direct op de plaats geplaatst waar de headset naartoe kijkt zodra u in de startpagina van mixed reality aankomt.
Wanneer u het protocol voor het toevoegen van het model vanaf het bureaublad aanroept terwijl de Mixed Reality Portal al actief is, moet u ervoor zorgen dat de headset 'actief' is. Zo niet, dan slaagt de plaatsing niet.

Delen via