Habilitar o posicionamento de modelos 3D no início da realidade misturadaEnable placement of 3D models in the mixed reality home

Observação

Esse recurso foi adicionado como parte da atualização do Windows 10 de abril de 2018.This feature was added as part of the Windows 10 April 2018 Update. As versões mais antigas do Windows não são compatíveis com esse recurso.Older versions of Windows are not compatible with this feature.

O Windows Mixed Reality Home é o ponto de partida onde os usuários vão antes de iniciar os aplicativos.The Windows Mixed Reality home is the starting point where users land before launching applications. Em alguns cenários, os aplicativos 2D (como o aplicativo hologramas) permitem o posicionamento de modelos 3D diretamente na casa mistura de realidade como decorações ou para uma inspeção mais detalhada no 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. O protocolo adicionar modelo permite que você envie um modelo 3D de seu site ou aplicativo diretamente para a página inicial do Windows Mixed Realm, onde ele persistirá como inicializadores de aplicativos 3D, aplicativos 2D e 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 exemplo, se você estiver desenvolvendo um aplicativo que superfícies um catálogo de mobília 3D para criar um espaço, poderá usar o protocolo adicionar modelo para permitir que os usuários coloquem esses modelos de móveis 3D a partir do catálogo.For example, if you're developing an application that surfaces a catalog of 3D furniture for designing a space, you can use the add model protocol to allow users to place those 3D furniture models from the catalog. Uma vez colocado no mundo, os usuários podem mover, redimensionar e remover esses modelos 3D assim como outros hologramas em casa.Once placed in the world, users can move, resize, and remove these 3D models just like other holograms in the home. Este artigo fornece uma visão geral da implementação do protocolo adicionar modelo para que você possa começar a permitir que os usuários decorem seu mundo com objetos 3D do seu aplicativo ou da Web.This article provides an overview of implementing the add model protocol so that you can start enabling users to decorate their world with 3D objects from your app or the web.

Suporte a dispositivosDevice support

RecursoFeature HoloLensHoloLens Headsets imersivosImmersive headsets
Adicionar protocolo de modeloAdd model protocol ✔️✔️ ✔️✔️

Visão geralOverview

Há duas etapas para habilitar o posicionamento de modelos 3D na página inicial do Windows Mixed Reality:There are 2 steps to enabling the placement of 3D models in the Windows Mixed Reality home:

  1. Verifique se seu modelo 3D é compatível com a página inicial do Windows Mixed Reality.Ensure your 3D model is compatible with the Windows Mixed Reality home.
  2. Implemente o protocolo adicionar modelo em seu aplicativo ou página da Web (este artigo).Implement the add model protocol in your application or webpage (this article).

Implementando o protocolo adicionar modeloImplementing the add model protocol

Depois de ter um modelo 3D compatível, você pode implementar o protocolo adicionar modelo ativando o seguinte URI de qualquer página da Web ou aplicativo: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>

Se o URI apontar para um recurso remoto, ele será baixado automaticamente e colocado em casa.If the URI points to a remote resource, then it will automatically be downloaded and placed in the home. Os recursos locais serão copiados para a pasta de dados de aplicativo da página inicial da realidade misturada antes de serem colocados em casa.Local resources will be copied to the mixed reality home's app data folder before being placed in the home. É recomendável projetar sua experiência para considerar cenários em que o usuário pode estar executando uma versão mais antiga do Windows que não dá suporte a esse recurso, ocultando o botão ou desabilitando-o, se possível.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.

Invocando o protocolo adicionar modelo de um aplicativo plataforma universal do 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
   }
}

Invocando o protocolo adicionar modelo de uma página da 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>

Considerações sobre headsets de imersão (VR)Considerations for immersive (VR) headsets

  • Para headsets de imersão (VR), o portal de realidade misturada não precisa estar em execução antes de invocar o protocolo adicionar modelo.For immersive (VR) headsets, the Mixed Reality Portal does not have to be running before invoking the add model protocol. Nesse caso, o protocolo adicionar modelo iniciará o portal de realidade misturada e posicionará o objeto diretamente, no qual o headset está olhando quando você chegar na casa misturada da realidade.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.
  • Ao invocar o protocolo adicionar modelo da área de trabalho com o portal da realidade misturada já em execução, verifique se o headset está "ativo".When invoking the add model protocol from the desktop with the Mixed Reality Portal already running, ensure that the headset is "awake". Caso contrário, o posicionamento não terá sucesso.If not, the placement will not succeed.

Consulte tambémSee also