Ativar a colocação de modelos 3D na home page da realidade mista

Artigo
07/12/2023

Nota

Esta funcionalidade foi adicionada como parte da Atualização de Abril de 2018 Windows 10. As versões mais antigas do Windows não são compatíveis com esta funcionalidade.

O Windows Mixed Reality casa é o ponto de partida onde os utilizadores acedem antes de iniciarem aplicações. Em alguns cenários, as aplicações 2D (como a aplicação Hologramas) permitem a colocação de modelos 3D diretamente na home page da realidade mista como decorações ou para uma inspeção posterior em 3D completo. O protocolo adicionar modelo permite-lhe enviar um modelo 3D a partir do seu site ou aplicação diretamente para a home page do Windows Mixed Reality, onde irá persistir, como iniciadores de aplicações 3D, aplicações 2D e hologramas.

Por exemplo, se estiver a desenvolver uma aplicação que apresenta um catálogo de mobiliário 3D para estruturar um espaço, utilize o protocolo add model para permitir que os utilizadores coloquem esses modelos de mobiliário 3D a partir do catálogo. Uma vez colocados no mundo, os utilizadores podem mover, redimensionar e remover estes modelos 3D, tal como outros hologramas em casa. Este artigo fornece uma descrição geral da implementação do protocolo adicionar modelo para permitir que os utilizadores decorem o seu mundo com objetos 3D da sua aplicação ou da Web.

Suporte de dispositivos

Funcionalidade	HoloLens	Headsets envolventes
Adicionar protocolo de modelo	✔️	✔️

Noções básicas

Existem dois passos para ativar a colocação de modelos 3D na home page do Windows Mixed Reality:

Certifique-se de que o modelo 3D é compatível com o Windows Mixed Reality home page.
Implemente o protocolo add model na sua aplicação ou página Web (este artigo).

Implementar o protocolo adicionar modelo

Assim que tiver um modelo 3D compatível, pode implementar o protocolo adicionar modelo ao ativar o seguinte URI a partir de qualquer página Web ou aplicação:

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

Se o URI apontar para um recurso remoto, será transferido e colocado automaticamente na home page. Os recursos locais serão copiados para a pasta de dados da aplicação da mixed reality home antes de serem colocados na home page. Recomendamos que crie a sua experiência para ter em conta cenários em que o utilizador possa estar a executar uma versão mais antiga do Windows que não suporte esta funcionalidade ao ocultar o botão ou desativá-lo, se possível.

Invocar o protocolo adicionar modelo a partir de uma aplicação 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
   }
}

Invocar o protocolo adicionar modelo a partir de uma página Web:

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

Considerações para headsets envolventes (VR)

Para headsets envolventes (VR), o Portal do Mixed Reality não tem de estar em execução antes de invocar o protocolo adicionar modelo. Neste caso, o protocolo adicionar modelo iniciará o Portal do Mixed Reality e colocará o objeto diretamente onde o headset está a procurar assim que chegar à home page da realidade mista.
Ao invocar o protocolo adicionar modelo a partir do ambiente de trabalho com o Portal do Mixed Reality já em execução, certifique-se de que o headset está "ativo". Caso contrário, a colocação não terá êxito.

Share via