Partilhar via

Configurar um novo projeto OpenXR com MRTK

  • Artigo

A maneira mais fácil de configurar seu projeto Unity para realidade mista é com o Mixed Reality Toolkit (MRTK). O MRTK for Unity é um kit de desenvolvimento multiplataforma de código aberto projetado para facilitar a criação de incríveis aplicativos de realidade mista.

Infográfico mostrando alguns dos recursos do Kit de Ferramentas de Realidade Mista.

O MRTK fornece um sistema de entrada multiplataforma, componentes fundamentais e blocos de construção comuns para interações espaciais. Ele pode ajudá-lo a acelerar o desenvolvimento de aplicativos para Microsoft HoloLens, fones de ouvido imersivos (VR) Windows Mixed Reality e muitos outros dispositivos VR/RA. O projeto visa reduzir as barreiras à entrada, permitindo que todos construam aplicações de realidade mista e contribuam de volta para a comunidade à medida que todos crescemos.

O MRTK suporta uma ampla gama de plataformas, incluindo:

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Headset da Windows Mixed Reality

  • Headsets do OpenVR (HTC Vive/Oculus Rift)

  • Rastreio Manual da Ultraleap

  • Dispositivos Android e iOS

Nota

Recentemente, apresentamos o MRTK3, a terceira geração do Microsoft Mixed Reality Toolkit for Unity, construído com base no sistema de gerenciamento XR e no kit de ferramentas de interação XR da Unity, com melhor suporte para uma variedade de dispositivos compatíveis com OpenXR e uma nova linguagem de design. Para obter mais informações, consulte a documentação do MRTK3.

Nota

Você também pode configurar um novo projeto OpenXR sem MRTK.

Outras opções de configuração não-OpenXR a considerar

Windows XR: A Microsoft não recomenda o uso do plug-in do Windows XR para novos projetos no Unity 2020. Em vez disso, você deve usar o plugin OpenXR de Realidade Mista. No entanto, se você estiver usando o Unity 2019 e precisar do AR Foundation 2.0 para compatibilidade com dispositivos ARCore/ARKit, este plug-in habilita esse suporte.

XR legado:

Se você ainda estiver no Unity 2019 ou anterior, a Microsoft recomenda usar o suporte a XR Legacy Built-in.

Se você está começando um novo projeto, recomendamos que você instale o Unity 2020 em vez disso e use o plug-in OpenXR de Realidade Mista.

Introdução ao OpenXR: Crie um novo projeto Unity

  1. Inicie o Unity Hub.

  2. Na guia Projetos, clique em Novo Projeto.

    Captura de tela do Unity Hub na guia Projetos com o botão Novo Projeto realçado.

  3. Clique na lista suspensa abaixo de Novo projeto e selecione a versão do Editor desejada.

    Captura de tela do Unity Hub com a lista suspensa Versão do Editor exibida.

  4. Certifique-se de que o modelo escolhido é 3D Core.

  5. Na caixa Nome do projeto, insira um nome para o seu projeto - por exemplo, "Tutorial MRTK".

  6. Na caixa Local, clique no ícone da pasta e, em seguida, navegue até a pasta onde deseja salvar seu projeto e selecione-o. Você também pode criar uma nova pasta.

    Captura de ecrã do Hub do Unity com 3D, Nome do Projeto, Localização e Criar realçados.

  7. Clique em Create Project (Criar Projeto). Isso abre seu projeto no Unity.

    Captura de tela do seu projeto aberto no Unity.

Atenção

Ao trabalhar no Windows, existe um limite MAX_PATH de 255 carateres. O Unity é afetado por estes limites e a compilação poderá falhar se algum caminho de ficheiro tiver mais de 255 carateres. Portanto, recomendamos que você armazene seu projeto Unity o mais próximo possível da raiz da unidade.

Defina seu destino de compilação

  1. Na barra de menus, selecione Configurações de compilação de arquivo>....

    Para criar um aplicativo para o Windows Mixed Reality, você deve escolher um destino de compilação. As configurações de compilação da Plataforma Universal do Windows (UWP) destinam-se a qualquer dispositivo, incluindo fones de ouvido imersivos como o HP Reverb G2. Esta é a melhor escolha se você estiver construindo para o HoloLens 2; no entanto, se você estiver visando VR desktop, recomendamos que você use o PC, Mac ou Linux Standalone plataforma.

  2. Execute um dos seguintes procedimentos:

    Se você estiver segmentando o Desktop VR:

    • Mantenha a plataforma independente PC, Mac ou Linux que é selecionada por padrão em um novo projeto Unity:

    Captura de tela da janela Configurações de compilação aberta no editor de unidade com PC, Mac & plataforma autônoma realçada

    Se você estiver segmentando o HoloLens 2:

    • Em Plataforma, selecione Plataforma Universal do Windows. Verifique se as seguintes configurações estão ativas:

    Tipo de construção: Projeto D3D

    Versão do SDK de destino: Instalação mais recente

    Versão mínima da plataforma: 10.0.10240.0

    Versão do Visual Studio: Instalação mais recente

    Captura de tela da janela Configurações de compilação aberta no editor da unidade com a Plataforma Universal do Windows realçada.

  3. Clique no botão Mudar de plataforma . Unity exibe uma barra de progresso enquanto troca de plataforma.

  4. Depois que o processo da plataforma de switch for concluído, feche a janela Configurações de compilação.

Baixe e instale a Ferramenta de Recursos de Realidade Mista

O Mixed Reality OpenXR Plugin vem na forma de um pacote para Unity. A melhor maneira de descobrir, atualizar e importar pacotes de recursos é com a Ferramenta de Recursos de Realidade Mista. Você pode pesquisar pacotes por nome ou categoria, ver suas dependências e exibir as alterações propostas no arquivo de manifesto do seu projeto antes de importar.

  1. Transfira a versão mais recente da Mixed Reality Feature Tool a partir do Centro de Transferências da Microsoft.

  2. Após a conclusão do download, navegue até o MixedRealityFeatureTool.exe do arquivo executável e use-o para iniciar a Ferramenta de Recursos de Realidade Mista.

    Screenshot da abertura de MixedRealityFeatureTool.

Importe os pacotes Mixed Reality Toolkit e OpenXR

  1. Na Ferramenta de Recursos de Realidade Mista, selecione Iniciar.

    Captura de tela da tela de abertura da Mixed Reality Feature Tool.

  2. Selecione o botão Procurar (é o botão "três pontos" na imagem abaixo), navegue até o seu projeto e abra-o.

    Abra o seu projeto

    Nota

    A caixa Caminho do Projeto na Ferramenta deve conter um valor, para que ela insira uma barra invertida ("_") por padrão.

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

    Captura de tela da tela Caminho do projeto da ferramenta de recurso de realidade mista.

  3. Selecione Descobrir recursos.

    Nota: Pode ser 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.

    Os principais grupos de pacotes na Mixed Reality Feature Tool

  5. Clique no botão "+" à esquerda do Mixed Reality Toolkit (0 de 10) e selecione a versão mais recente do Mixed Reality Toolkit Foundation.

    Nota

    O pacote Mixed Reality Toolkit Foundation é o único pacote que deve ser importado e configurado para usar o MRTK com seu projeto. Este pacote inclui os componentes principais necessários para criar uma aplicação de realidade mista.

  6. Clique no botão "+" à esquerda de Suporte à Plataforma (0 de 5) e, em seguida, selecione a versão mais recente do Mixed Reality OpenXR Plugin.

    Captura de tela das seleções de pacotes na Ferramenta de Recursos de Realidade Mista.

  7. Depois de fazer a(s) sua(s) seleção(ões), clique em Obter Recursos.

  8. Selecione Validar para validar os pacotes selecionados. Você verá uma caixa de diálogo que diz Nenhum problema de validação foi detetado. Quando o fizer, clique em OK.

  9. 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 todas as dependências. Você pode clicar no link Detalhes de qualquer um desses itens para saber mais sobre eles.

  10. Quando estiver pronto para seguir em frente, selecione Importar. Na página Rever e Aprovar , pode rever as informações sobre os pacotes.

  11. Selecione Aprovar.

  12. Retorne ao Editor Unity e clique em uma área em branco na interface do usuário. Você verá uma barra de progresso mostrando que seus pacotes estão sendo importados.

Definir configurações de back-end de entrada

  1. Depois que o Unity importar o pacote, um aviso será exibido perguntando se você deseja habilitar os back-ends reiniciando o editor. Selecione Yes (Sim).

    Screenshot da opção Unity Restart.

Configurar o projeto para o HoloLens 2 via Validação de Projeto (MR OpenXR 1.6+)

Se você estiver desenvolvendo para VR de desktop, ignore esta seção e vá para Configurar o projeto para VR de desktop.

  1. Na barra de menus, clique em Mixed Reality Project > Validation Settings > HoloLens 2 Application (UWP) para ativar as regras de validação para o HoloLens 2. Para plugins MR OpenXR antes da versão 1.9, o item de menu disponível é Mixed Reality > Project > Apply recommended project settings for HoloLens 2.
  2. Na janela de validação de projeto que aparece, verifique se você está na guia Plataforma UWP (indicada pelo logotipo do Windows) e clique em Corrigir tudo para resolver os problemas de validação. Observe que pode haver problemas que permanecem depois de clicar em Corrigir tudo. Nesse caso, tente clicar em Corrigir tudo novamente, ignore quaisquer problemas marcados como "específicos da cena" (se houver) e analise o restante dos problemas (se houver) para ver se há alguma alteração sugerida que você deseja fazer.
  3. O projeto está quase pronto para a implantação do HoloLens 2 neste momento. Prossiga para Definir configurações do Player para a próxima etapa.

Configurar o projeto para o HoloLens 2 manualmente

Se você estiver desenvolvendo para VR de desktop, ignore esta seção e vá para Configurar o projeto para VR de desktop.

  1. Verifique se a janela Configurações do projeto está aberta. Caso contrário, na barra de menus, selecione Editar>configurações do projeto.

  2. Na janela Configurações do projeto, verifique se você está na página Gerenciamento de plug-in XR e na guia Plataforma Universal do Windows.

    Captura de tela da janela Configurações do projeto aberta na página de gerenciamento de plug-ins XR e na guia Plataforma Universal do Windows.

  3. Verifique se a opção Inicializar XR na inicialização está selecionada e, em Provedores de plug-ins, clique em OpenXR.

    Captura de tela da janela Configurações do projeto, dentro da Plataforma Universal do Windows, com Inicializar XR na inicialização selecionado e o plug-in OpenXR realçado.

  4. O plug-in OpenXR é carregado e, em seguida, vários itens aparecem abaixo do OpenXR. Selecione o grupo de recursos Microsoft HoloLens.

    Captura de tela da janela Configurações do projeto com o plug-in OpenXR e o Microsoft HoloLens Feature Group realçado.

Observe que há um triângulo de aviso amarelo ao lado do OpenXR. Isso indica que você tem configurações incompatíveis que precisam ser resolvidas. Para saber como resolver isso, ignore a próxima seção sobre como configurar para RV e continue com a seção a seguir, Resolvendo configurações incompatíveis.

Configurar o projeto para VR de desktop via Validação de Projeto (MR OpenXR 1.9+)

  1. Na barra de menus, clique em Mixed Reality Project > Validation Settings > Win32 Application (Standalone) para ativar as regras de validação para um aplicativo XR da área de trabalho.
  2. Na janela de validação do projeto que aparece, verifique se você está na guia Plataforma autônoma e clique em Corrigir tudo para resolver os problemas de validação. Observe que pode haver problemas que permanecem depois de clicar em Corrigir tudo. Nesse caso, tente clicar em Corrigir tudo novamente, ignore quaisquer problemas marcados como "específicos da cena" (se houver) e analise o restante dos problemas (se houver) para ver se há alguma alteração sugerida que você deseja fazer.

Configurar o projeto para VR da área de trabalho manualmente

  1. Verifique se a janela Configurações do projeto está aberta. Caso contrário, vá para a barra de menus, selecione Editar>configurações do projeto.

  2. Na janela Configurações do projeto, verifique se você está na página Gerenciamento de plug-in XR e na guia PC, Mac & Linux Standalone.

    Captura de tela da janela Configurações do projeto aberta na página de gerenciamento de plug-ins XR e na guia Autônomo PC, Mac & Linux.

  3. Verifique se a opção Inicializar XR na inicialização está selecionada e, em Provedores de plug-ins, clique em OpenXR.

    Captura de tela da janela Configurações do projeto, dentro do PC, guia Mac & Linux Standalone, com Initialize XR on Startup selecionado e o plug-in OpenXR realçado.

  4. O plug-in OpenXR é carregado e, em seguida, dois itens aparecem abaixo do OpenXR. Selecione o primeiro, o grupo de recursos Windows Mixed Reality.

    Captura de tela da janela Configurações do projeto, o plug-in OpenXR e o grupo de recursos Windows Mixed Reality destacados.

Observe que agora há um triângulo de aviso amarelo ao lado do OpenXR. Isso indica que você tem configurações incompatíveis que precisam ser resolvidas. Para saber como resolver isso, continue para a próxima seção, Resolvendo configurações incompatíveis.

Resolvendo configurações incompatíveis

Importante

As imagens nesta seção mostram as opções na guia Plataforma Universal do Windows. No entanto, as instruções são as mesmas para a guia Desktop VR, exceto onde indicado.

  1. Passe o cursor sobre o triângulo de aviso amarelo ao lado de OpenXR, leia a mensagem no pop-up e selecione o triângulo.

    Captura de tela de aviso sobre configurações incompatíveis.

  2. Na janela Validação do projeto OpenXR, há vários problemas listados. Selecione o botão Corrigir tudo . NOTA: Esta lista pode ter um aspeto diferente dependendo do separador em que se encontra.

    Captura de tela do botão Corrigir tudo na janela Validação do projeto OpenXR.

  3. Um problema permanece e diz que você deve adicionar pelo menos um perfil de interação. Para fazer isso, clique em Editar. Isso leva você às configurações do plug-in OpenXR na janela Configurações do projeto.

    Captura de tela da janela Configurações do projeto com as configurações do OpenXR exibidas.

  4. Por baixo de Perfis de Interação, anote o botão de sinal de adição (+).

    Captura de ecrã do botão Adicionar Perfil de Interação.

  5. Clique no botão três vezes, cada vez escolhendo um perfil diferente:

    Perfil de Interação do Olhar

    Perfil de interação do Microsoft Hand

    Perfil do controlador de movimento da Microsoft

    Captura de tela dos perfis de interação que devem ser adicionados.

    Se o Perfil de Interação do Olhar Ocular, ou qualquer outro perfil, aparecer com um triângulo amarelo ao lado, selecione o triângulo e, na janela Validação do Projeto OpenXR, clique no botão Corrigir. Quando terminar, feche a janela Validação do projeto OpenXR.

    Captura de ecrã do botão Corrigir para o perfil de interação Olhar para os olhos.

  6. Na janela Configurações do projeto, em Grupos de recursos do OpenXR, verifique se as seguintes opções estão selecionadas:

    Se você estiver na guia VR da área de trabalho:

    Realidade mista do Windows

    Rastreamento de mãos

    Modelo do controlador de movimento

    Captura de ecrã dos Grupos de Funcionalidades OpenXR para o separador Desktop VR.

    Se você estiver na guia Plataforma Universal do Windows:

    Microsoft HoloLens

    Rastreamento de mãos

    Modelo do controlador de movimento

    Captura de tela dos recursos selecionados para OpenXR.

  7. Clique na lista suspensa Modo de envio de profundidade e selecione Profundidade de 16 bits.

    Captura de tela da profundidade de 16 bits selecionada para o modo de envio de profundidade.

    Gorjeta

    Reduzir o formato de profundidade para 16 bits é opcional, mas pode melhorar o desempenho gráfico em seu projeto. Para saber mais, consulte Compartilhamento de buffer de profundidade (HoloLens).

    Nota

    A configuração Modo de Renderização, localizada logo acima do Modo de Envio de Profundidade, é definida por padrão como Instância de Passagem Única. Em aplicativos de realidade mista, a cena é renderizada duas vezes: uma para cada olho. O resultado é a "visão estereoscópica". Isso dobra a quantidade de computação necessária, por isso é importante selecionar o caminho de renderização mais eficiente no Unity para economizar tempo de CPU e GPU. A renderização com instância de passagem única é a melhor opção aqui - recomendamos que você a habilite por padrão para cada projeto. Para saber mais sobre isso, consulte a documentação do Unity.

Definir definições do Media Player

  1. Na coluna do lado esquerdo da janela Configurações do projeto, selecione Player.

  2. Observe que na janela do Player, a caixa Nome do Produto já está preenchida. Isso é retirado do nome do seu projeto e será o nome exibido no menu Iniciar do HoloLens.

    Captura de tela das Configurações de publicação do Unity com a caixa Nome do projeto preenchida.

    Gorjeta

    Para facilitar a localização do aplicativo durante o desenvolvimento, adicione um sublinhado na frente do nome para classificá-lo no topo de qualquer lista.

  3. Clique na lista suspensa Configurações de publicação e, no campo Nome do pacote , insira um nome adequado.

    Captura de tela das Configurações de publicação do Unity com a caixa de nome do pacote preenchida.

    Nota

    O nome do pacote é o identificador exclusivo do aplicativo. Se quiser evitar substituir versões instaladas anteriormente do aplicativo com o mesmo nome, altere esse identificador antes de implantar o aplicativo.

  4. Feche a janela Configurações do projeto.

Agora você está pronto para começar a desenvolver com OpenXR em Unity!

Projetos de exemplo Unity

Confira o repositório de amostras de Realidade Mista do OpenXR para exemplos de projetos Unity, mostrando como criar aplicativos Unity para fones de ouvido HoloLens 2 ou Mixed Reality usando o plug-in OpenXR de Realidade Mista.

Consulte também