Permettre le placement d’objets 3D dans l’accueil réalité mixte

Article
07/12/2023

Notes

Cette fonctionnalité a été ajoutée dans le cadre de la mise à jour Windows 10 avril 2018. Les versions antérieures de Windows ne sont pas compatibles avec cette fonctionnalité.

Le Windows Mixed Reality domicile est le point de départ où les utilisateurs atterrissent avant de lancer des applications. Dans certains scénarios, les applications 2D (comme l’application Hologrammes) permettent de placer des modèles 3D directement dans la maison de réalité mixte en tant que décorations ou pour une inspection supplémentaire en 3D complète. Le protocole d’ajout de modèle vous permet d’envoyer un modèle 3D à partir de votre site web ou de votre application directement dans le Windows Mixed Reality accueil, où il sera conservé comme des lanceurs d’applications 3D, des applications 2D et des hologrammes.

Par exemple, si vous développez une application qui expose un catalogue de meubles 3D pour la conception d’un espace, utilisez le protocole d’ajout de modèle pour permettre aux utilisateurs de placer ces modèles de meubles 3D à partir du catalogue. Une fois placés dans le monde, les utilisateurs peuvent déplacer, redimensionner et supprimer ces modèles 3D comme d’autres hologrammes dans la maison. Cet article fournit une vue d’ensemble de l’implémentation du protocole d’ajout de modèle pour permettre aux utilisateurs de décorer leur monde avec des objets 3D à partir de votre application ou du web.

Prise en charge des appareils

Fonctionnalité	HoloLens	Casques immersifs
Ajouter un protocole de modèle	✔️	✔️

Concepts de base

Il existe deux étapes pour activer le placement de modèles 3D dans le Windows Mixed Reality maison :

Assurez-vous que votre modèle 3D est compatible avec le Windows Mixed Reality maison.
Implémentez le protocole d’ajout de modèle dans votre application ou page web (cet article).

Implémentation du protocole d’ajout de modèle

Une fois que vous disposez d’un modèle 3D compatible, vous pouvez implémenter le protocole d’ajout de modèle en activant l’URI suivant à partir de n’importe quelle page web ou application :

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

Si l’URI pointe vers une ressource distante, il est automatiquement téléchargé et placé dans la page d’accueil. Les ressources locales sont copiées dans le dossier de données d’application de l’accueil de réalité mixte avant d’être placées dans l’accueil. Nous vous recommandons de concevoir votre expérience pour prendre en compte les scénarios dans lesquels l’utilisateur peut exécuter une version antérieure de Windows qui ne prend pas en charge cette fonctionnalité en masquant le bouton ou en le désactivant si possible.

Appel du protocole d’ajout de modèle à partir d’une application plateforme Windows universelle :

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

Appel du protocole d’ajout de modèle à partir d’une page web :

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

Considérations relatives aux casques immersifs (VR)

Pour les casques immersifs (VR), le portail Mixed Reality n’a pas besoin d’être en cours d’exécution avant d’appeler le protocole d’ajout de modèle. Dans ce cas, le protocole d’ajout de modèle lance le portail Mixed Reality et place l’objet directement à l’endroit où le casque se trouve une fois que vous arrivez dans la maison de réalité mixte.
Lorsque vous appelez le protocole d’ajout de modèle à partir du bureau avec le portail Mixed Reality déjà en cours d’exécution, assurez-vous que le casque est « éveillé ». Si ce n’est pas le cas, le placement ne réussira pas.

Partager via