Permettre le placement d’objets 3D dans l’accueil réalité mixteEnable placement of 3D models in the mixed reality home

Notes

Cette fonctionnalité a été ajoutée dans le cadre de la mise à jour 2018 de Windows 10 avril.This feature was added as part of the Windows 10 April 2018 Update. Les versions antérieures de Windows ne sont pas compatibles avec cette fonctionnalité.Older versions of Windows are not compatible with this feature.

La base de la réalité Windows Mixed est le point de départ où les utilisateurs se trouvent avant de lancer des applications.The Windows Mixed Reality home is the starting point where users land before launching applications. Dans certains scénarios, les applications 2D (comme l’application hologrammes) permettent de placer des modèles 3D directement dans l’espace de la réalité mixte en tant que décorations ou pour une inspection supplémentaire en 3D complet.In some scenarios, 2D apps (like the Holograms app) enable placement of 3D models directly into the mixed reality home as decorations or for further inspection in full 3D. Le protocole Add Model vous permet d’envoyer un modèle 3D à partir de votre site Web ou application directement dans la page d’hébergement Windows Mixed Reality, où il sera conservé comme les lanceurs d’applications 3D, les applications 2D et les hologrammes.The add model protocol allows you to send a 3D model from your website or application directly into the Windows Mixed Reality home, where it will persist like 3D app launchers, 2D apps, and holograms.

Par exemple, si vous développez une application qui couvre un catalogue de mobilier en 3D pour la conception d’un espace, utilisez le protocole ajouter un modèle pour permettre aux utilisateurs de placer ces modèles de mobilier 3D à partir du catalogue.For example, if you're developing an application that surfaces a catalog of 3D furniture for designing a space, use the add model protocol to allow users to place those 3D furniture models from the catalog. Une fois placés dans le monde, les utilisateurs peuvent déplacer, redimensionner et supprimer ces modèles 3D comme d’autres hologrammes de la famille.Once placed in the world, users can move, resize, and remove these 3D models just like other holograms in the home. Cet article fournit une vue d’ensemble de l’implémentation du protocole Add Model pour permettre aux utilisateurs de décorer leur monde avec des objets 3D à partir de votre application ou du Web.This article provides an overview of implementing the add model protocol for enabling users to decorate their world with 3D objects from your app or the web.

Prise en charge des appareilsDevice support

FonctionnalitéFeature HoloLensHoloLens Casques immersifsImmersive headsets
Ajouter un protocole de modèleAdd model protocol ✔️✔️ ✔️✔️

Concepts de baseThe basics

Il existe deux étapes pour activer le placement des modèles 3D dans la page d’hébergement de Windows Mixed Reality :There are two steps to enabling the placement of 3D models in the Windows Mixed Reality home:

  1. Vérifiez que votre modèle 3D est compatible avec la page d’hébergement Windows Mixed Reality.Ensure your 3D model is compatible with the Windows Mixed Reality home.
  2. Implémentez le protocole Add Model dans votre application ou votre page Web (cet article).Implement the add model protocol in your application or webpage (this article).

Implémentation du protocole Add ModelImplementing the add model protocol

Une fois que vous disposez d’un modèle 3D compatible, vous pouvez implémenter le protocole Add Model en activant l’URI suivant à partir d’une page Web ou d’une application :Once you have a compatible 3D model, you can implement the add model protocol by activating the following URI from any webpage or 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’hébergement.If the URI points to a remote resource, then it will automatically be downloaded and placed in the home. Les ressources locales seront copiées dans le dossier des données d’application de la réalité mixte avant d’être placées dans la page d’hébergement.Local resources will be copied to the mixed reality home's app data folder before being placed in the home. Nous vous recommandons de concevoir votre expérience afin de 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.We recommend designing your experience to account for scenarios where the user might be running an older version of Windows that doesn't support this feature by hiding the button or disabling it if possible.

Appel du protocole Add Model à partir d’une application plateforme Windows universelle :Invoking the add model protocol from a Universal 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
   }
}

Appel du protocole Add Model à partir d’une page Web :Invoking the add model protocol from a webpage:

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

Considérations relatives aux casques immersifs (VR)Considerations for immersive (VR) headsets

  • Pour les casques immersifs (VR), le portail de réalité mixte n’a pas besoin d’être en cours d’exécution avant d’appeler le protocole Add Model.For immersive (VR) headsets, the Mixed Reality Portal doesn't have to be running before invoking the add model protocol. Dans ce cas, le protocole Add Model lance le portail de réalité mixte et place l’objet directement là où le casque regarde une fois que vous arrivez dans la zone d’hébergement de la réalité mixte.In this case, the add model protocol will launch the Mixed Reality Portal and place the object directly where the headset is looking once you arrive in the mixed reality home.
  • Quand vous appelez le protocole Add Model à partir du bureau avec le portail de réalité mixte déjà en cours d’exécution, assurez-vous que le casque est « éveillé ».When invoking the add model protocol from the desktop with the Mixed Reality Portal already running, ensure that the headset is "awake". Si ce n’est pas le cas, l’emplacement ne fonctionnera pas.If not, the placement won't succeed.

Voir aussiSee also