Habilitar o posicionamento de modelos 3D na página inicial da realidade misturada

A Windows Mixed Reality casa é o ponto de partida em que os usuários chegam antes de iniciar aplicativos. Em alguns cenários, aplicativos 2D (como o aplicativo Hologramas) permitem o posicionamento de modelos 3D diretamente na casa de realidade misturada como decorações ou para inspeção adicional em 3D completo. O protocolo adicionar modelo permite que você envie um modelo 3D do seu site ou aplicativo diretamente para o Windows Mixed Reality página inicial, onde ele persistirá como inicializadores de aplicativos 3D, aplicativos 2D e hologramas.

Por exemplo, se você estiver desenvolvendo um aplicativo que apresenta um catálogo de móveis 3D para projetar um espaço, use o protocolo adicionar modelo para permitir que os usuários coloquem esses modelos de móveis 3D do catálogo. Uma vez colocados no mundo, os usuários podem mover, redimensionar e remover esses modelos 3D, assim como outros hologramas em casa. Este artigo fornece uma visão geral da implementação do protocolo de adição de modelo para permitir que os usuários decorem seu mundo com objetos 3D do seu aplicativo ou da Web.

Suporte a dispositivos

Noções básicas

Há duas etapas para habilitar o posicionamento de modelos 3D na Windows Mixed Reality página inicial:

1. Verifique se o modelo 3D é compatível com o Windows Mixed Reality página inicial.
2. Implemente o protocolo adicionar modelo em seu aplicativo ou página da Web (este artigo).

Implementando o protocolo de adição de modelo

Depois de ter um modelo 3D compatível, você pode implementar o protocolo de adição de modelo ativando o seguinte URI de qualquer página da Web ou aplicativo:

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 e colocado automaticamente na página inicial. Os recursos locais serão copiados para a pasta de dados do aplicativo da página inicial da realidade misturada antes de serem colocados na página inicial. Recomendamos 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.

Invocando o protocolo adicionar modelo de um aplicativo Plataforma Universal do Windows:

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:

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

Considerações para headsets imersivos (VR)

• Para headsets imersivos (VR), o Portal do Realidade Misturada não precisa estar em execução antes de invocar o protocolo adicionar modelo. Nesse caso, o protocolo adicionar modelo iniciará o portal do Realidade Misturada e colocará o objeto diretamente onde o headset está procurando quando você chegar na página inicial da realidade misturada.
• Ao invocar o protocolo adicionar modelo da área de trabalho com o Portal do Realidade Misturada já em execução, verifique se o headset está "ativo". Caso contrário, o posicionamento não terá êxito.

Confira também

• Criando modelos 3D para uso na página inicial do Windows Mixed Reality
• Como navegar na página inicial do Windows Mixed Reality