Habilitación de la colocación de modelos 3D en el ambiente principalEnable placement of 3D models in the mixed reality home

Nota

Esta característica se agregó como parte de la actualización 2018 de abril de Windows 10.This feature was added as part of the Windows 10 April 2018 Update. Las versiones anteriores de Windows no son compatibles con esta característica.Older versions of Windows are not compatible with this feature.

La Página principal de Windows Mixed Reality es el punto de partida en el que los usuarios se colocan antes de iniciar las aplicaciones.The Windows Mixed Reality home is the starting point where users land before launching applications. En algunos escenarios, las aplicaciones 2D (como la aplicación de hologramas) permiten colocar los modelos 3D directamente en la Página principal de la realidad mixta como decoración o para realizar más inspecciones en 3D completo.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. El Protocolo agregar modelo le permite enviar un modelo 3D desde su sitio web o aplicación directamente a la Página principal de Windows Mixed Reality, donde se conservará como iniciadores de aplicaciones 3D, aplicaciones 2D y hologramas.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.

Por ejemplo, si está desarrollando una aplicación que muestra un catálogo de mobiliario 3D para diseñar un espacio, use el Protocolo agregar modelo para permitir que los usuarios coloquen los modelos de mobiliario 3D del catálogo.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. Una vez colocado en el mundo, los usuarios pueden moverse, cambiar de tamaño y quitar estos modelos 3D igual que otros hologramas en el hogar.Once placed in the world, users can move, resize, and remove these 3D models just like other holograms in the home. En este artículo se proporciona información general sobre la implementación del Protocolo de incorporación de modelos para permitir a los usuarios decorar su mundo con objetos 3D desde la aplicación o la 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.

Compatibilidad con dispositivosDevice support

CaracterísticaFeature HoloLensHoloLens Cascos envolventesImmersive headsets
Agregar protocolo de modeloAdd model protocol ✔️✔️ ✔️✔️

Conceptos básicosThe basics

Hay dos pasos para habilitar la selección de ubicación de modelos 3D en la Página principal de Windows Mixed Reality:There are two steps to enabling the placement of 3D models in the Windows Mixed Reality home:

  1. Asegúrese de que el modelo 3D es compatible con la Página principal de Windows Mixed Reality.Ensure your 3D model is compatible with the Windows Mixed Reality home.
  2. Implemente el Protocolo de adición de modelos en la aplicación o la página web (este artículo).Implement the add model protocol in your application or webpage (this article).

Implementación del Protocolo Add ModelImplementing the add model protocol

Una vez que tenga un modelo 3D compatible, puede implementar el Protocolo agregar modelo activando el URI siguiente desde cualquier página web o aplicación: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 el URI apunta a un recurso remoto, se descargará automáticamente y se colocará en el hogar.If the URI points to a remote resource, then it will automatically be downloaded and placed in the home. Los recursos locales se copiarán en la carpeta de datos de la aplicación de la Página principal de la realidad mixta antes de colocarse en el hogar.Local resources will be copied to the mixed reality home's app data folder before being placed in the home. Se recomienda diseñar su experiencia para tener en cuenta los escenarios en los que el usuario podría estar ejecutando una versión anterior de Windows que no admita esta característica ocultando el botón o deshabilitando si es posible.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.

Invocar el Protocolo agregar modelo desde una aplicación plataforma universal de Windows: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
   }
}

Invocar el Protocolo de agregar modelo desde una página 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>

Consideraciones sobre los auriculares envolventes (VR)Considerations for immersive (VR) headsets

  • En el caso de los auriculares envolventes (VR), el portal de realidad mixta no tiene que estar en ejecución antes de invocar el Protocolo de adición del modelo.For immersive (VR) headsets, the Mixed Reality Portal doesn't have to be running before invoking the add model protocol. En este caso, el Protocolo de adición del modelo iniciará el portal de realidad mixta y colocará el objeto directamente, donde el casco está mirando una vez que llega a la Página principal de la realidad mixta.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.
  • Al invocar el Protocolo agregar modelo desde el escritorio con el portal de realidad mixta que ya se está ejecutando, asegúrese de que el casco esté "activo".When invoking the add model protocol from the desktop with the Mixed Reality Portal already running, ensure that the headset is "awake". Si no es así, la selección de ubicación no se realizará correctamente.If not, the placement won't succeed.

Consulte tambiénSee also