Adicionar o plug-in Realidade Misturada OpenXR ao projeto do Unity existente

Se você tiver um projeto do Unity que já está configurado para OpenXR (você tem o plug-in OpenXR do Unity instalado e configurado) e deseja adicionar a funcionalidade para direcionar seu aplicativo para o HoloLens 2, siga as instruções abaixo.

Para determinar se o projeto tem o plug-in Realidade Misturada OpenXR instalado:

  1. No Unity, na barra de menus, selecione Editar>Project Configurações.

  2. Verifique se você está na página Gerenciamento de plug-in de XR com as configurações da Plataforma Universal do Windows (guia do logotipo do Windows) exibidas.

  3. Se o grupo de recursos do Microsoft Hololens estiver esmaecido ou não existir, o plug-in Realidade Misturada OpenXR não estará instalado.

    Screenshot of XR Plug-in Management window.

Baixar e instalar a Ferramenta de Recursos Realidade Misturada

O plug-in Realidade Misturada OpenXR vem na forma de um pacote para Unity. A melhor maneira de descobrir, atualizar e importar pacotes de recursos é com a Realidade Misturada Feature Tool. Você pode pesquisar pacotes por nome ou categoria, ver suas dependências e visualizar as alterações propostas no arquivo de manifesto do seu projeto antes de importar.

  1. Baixe a versão mais recente da ferramenta de recursos Realidade Misturada do Centro de Download da Microsoft.

  2. Após o término do download, descompacte o arquivo e salve-o em sua área de trabalho.

    Observação

    Antes de executar a Ferramenta de Recurso de Realidade Misturada, você deve instalar o runtime do .NET 5.0

  3. Na pasta descompactada, navegue até o arquivo executável MixedRealityFeatureTool.exe e use-o para iniciar a Ferramenta de Recurso de Realidade Misturada.

    Screenshot of Opening MixedRealityFeatureTool.

Importar o plug-in Realidade Misturada OpenXR

  1. Na Ferramenta de Recurso de Realidade Misturada, selecione Iniciar.

    Screenshot of the Mixed Reality Feature Tool opening screen.

  2. Selecione o botão Procurar (é o botão "três pontos" na imagem abaixo), navegue até a pasta que contém seu projeto do Unity e abra-o.

    Open your project

    Observação

    A caixa Caminho do Projeto na ferramenta deve conter algum valor, portanto, insira uma barra invertida ("_") por padrão.

    Depois de selecionar uma pasta, a ferramenta verifica se é uma pasta de projeto do Unity válida.

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  3. Selecione Descobrir Recursos.

    Observação: talvez seja necessário aguardar alguns segundos enquanto a ferramenta atualiza os pacotes dos feeds.

  4. Na página descobrir Recursos observe que há uma lista de seis grupos de pacotes.

    The main groups of packages in the Mixed Reality Feature Tool

  5. Clique no botão "+" à esquerda de Suporte à plataforma (0 de 5) e selecione a versão mais recente do Plug-in OpenXR de Realidade Misturada.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Depois de fazer suas seleções, clique em obter Recursos.

  7. Selecione Validar para validar o pacote. Você deverá ver uma caixa de diálogo informando que Nenhum problema de validação foi detectado. Quando ela aparecer, clique em OK.

  8. Na página importar Recursos, a coluna do lado esquerdo, Recursos, exibe os pacotes que você acabou de selecionar. A coluna do lado direito, Dependências Necessárias, exibe as dependências. Você pode clicar no link Detalhes em qualquer um desses itens para saber mais sobre eles.

  9. Quando estiver pronto para continuar, selecione Importar. Na página Examinar e Aprovar, você pode revisar as informações sobre os pacotes.

  10. Selecione Aprovar.

  11. Retorne ao editor do Unity e clique em uma área em branco na interface do usuário. Você verá uma barra de progresso mostrando que o pacote está sendo importado.

  12. No Unity, verifique se você está na janela Project Configurações, na página Gerenciamento de Plug-in XR e na guia Plataforma Universal do Windows.

  13. Agora há dois grupos de recursos abaixo do OpenXR. Selecione o primeiro, Grupo de Recursos do Microsoft HoloLens.

  14. Feche a janela Configurações de Projeto.

Confira também