Abilitare il posizionamento di modelli 3D nell'ambiente iniziale

Articolo
07/12/2023

Nota

Questa funzionalità è stata aggiunta come parte dell'aggiornamento di Windows 10 aprile 2018. Le versioni precedenti di Windows non sono compatibili con questa funzionalità.

La Windows Mixed Reality home è il punto di partenza in cui gli utenti arrivano prima di avviare le applicazioni. In alcuni scenari, le app 2D (come l'app Holograms) consentono di posizionare i modelli 3D direttamente nella casa di realtà mista come decorazioni o per un'ulteriore ispezione in 3D completo. Il protocollo di aggiunta del modello consente di inviare un modello 3D dal sito Web o dall'applicazione direttamente nella home page di Windows Mixed Reality, in cui sarà persistente come le utilità di avvio delle app 3D, le app 2D e gli ologrammi.

Ad esempio, se si sviluppa un'applicazione che espone un catalogo di mobili 3D per progettare uno spazio, usare il protocollo add model per consentire agli utenti di posizionare tali modelli di mobili 3D dal catalogo. Una volta inseriti nel mondo, gli utenti possono spostare, ridimensionare e rimuovere questi modelli 3D proprio come altri ologrammi nella casa. Questo articolo offre una panoramica dell'implementazione del protocollo add model per consentire agli utenti di decorare il proprio mondo con oggetti 3D dall'app o dal Web.

Supporto di dispositivi

Funzionalità	HoloLens	Visori VR immersive
Aggiungere il protocollo del modello	✔️	✔

Nozioni di base

Esistono due passaggi per abilitare il posizionamento dei modelli 3D nella home Windows Mixed Reality:

Verificare che il modello 3D sia compatibile con la home Windows Mixed Reality.
Implementare il protocollo di aggiunta del modello nell'applicazione o nella pagina Web (questo articolo).

Implementazione del protocollo add model

Dopo aver creato un modello 3D compatibile, è possibile implementare il protocollo di aggiunta del modello attivando l'URI seguente da qualsiasi pagina Web o applicazione:

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

Se l'URI punta a una risorsa remota, verrà scaricato e inserito automaticamente nella home page. Le risorse locali verranno copiate nella cartella dei dati dell'app della casa di realtà mista prima di essere posizionate nella home page. È consigliabile progettare l'esperienza per tenere conto degli scenari in cui l'utente potrebbe eseguire una versione precedente di Windows che non supporta questa funzionalità nascondendo il pulsante o disabilitandolo, se possibile.

Richiamare il protocollo di aggiunta del modello da un'app piattaforma UWP (Universal Windows Platform):

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
   }
}

Richiamare il protocollo di aggiunta del modello da una pagina Web:

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

Considerazioni per i visori VR immersive

Per i visori VR immersive, il portale di Realtà mista non deve essere in esecuzione prima di richiamare il protocollo del modello di aggiunta. In questo caso, il protocollo di aggiunta del modello avvierà il portale di Realtà mista e inserisce l'oggetto direttamente in cui il visore VR sta guardando una volta arrivati nella casa della realtà mista.
Quando si richiama il protocollo di aggiunta del modello dal desktop con il portale di Realtà mista già in esecuzione, assicurarsi che il visore VR sia "sveglio". In caso contrario, il posizionamento non avrà esito positivo.

Condividi tramite