Configuração inicial para MRTK3

Bem-vindo à versão prévia pública do MRTK3! Como MRTK3 é uma coleção de pacotes minimamente acoplados, consumir MRTK3 é diferente de consumir MRTK 2.x. Não enviamos o MRTK como um projeto do Unity, portanto, espera-se que você use nosso projeto de modelo de exemplo, que é pré-configurado para consumir todos os pacotes MRTK (mais fácil de começar) ou começar de novo com um novo projeto (oferece mais controle, recomendado).

Não se espera que você consuma todos os pacotes MRTK. Veja quais recursos são úteis para você e adicione apenas as dependências importantes.

Instalar as ferramentas

Verifique se você tem todas as ferramentas neste link antes de iniciar:

Caminho 1: clonar o repositório e testar o exemplo de projeto do Unity

A maneira mais fácil de adquirir e experimentar o MRTK3 é fazer isso por meio de nosso projeto pré-configurado com referências a todos os pacotes MRTK3 atuais. Clone nosso projeto em nosso repositório GitHub e faça check-out do mrtk3 branch. Depois disso, você pode simplesmente iniciar o Unity (2020.3.35f1 ou mais recente/2021.3.4f1 ou mais recente) no projeto MRTKDevTemplate em UnityProjects e começar a executar as cenas de exemplo no Editor, por meio da comunicação remota ou implantada em dispositivos.

Para obter informações sobre as cenas de exemplo incluídas na visualização, consulte Usar e criar cenas.

Caminho 2: adicionar MRTK3 a um novo projeto do Unity

1. Criar um novo projeto do Unity

Crie um novo projeto do Unity com o Unity 2020.3.35f1 ou mais recente/Unity 2021.3.4f1 ou mais recente. Feche o projeto do Unity antes de prosseguir para a próxima etapa.

2. Importar dependências necessárias e pacotes MRTK3 com a Ferramenta de Recurso da Realidade Misturada

Observação

Baixe primeiro a versão mais recente da Ferramenta de Recursos do Realidade Misturada. Após iniciar a ferramenta de recursos, clique no botão de configurações no canto inferior esquerdo e vá para a guia Feature. Verifique se Show preview releases está marcado, clique em OK e depois clique em Startpara continuar. Agora é possível ver uma categoria MRTK3 listada na página Discover Features.

Há um punhado de pacotes que o MRTK3 usa que não fazem parte desta versão prévia. Para obtê-los, use Mixed Reality Feature Tool e selecione as versões mais recentes do seguinte na etapa Descobrir Recursos:

  • Suporte à plataforma → Realidade Misturada Plug-in OpenXR
  • [Opcional]Áudio espacial → Microsoft Spatializer

Para pacotes MRTK3, consulte a página de visão geral do pacote para obter informações sobre pacotes e selecione os que atendem às suas necessidades.

Quando terminar de selecionar pacotes, clique em Obter recursos e siga a Ferramenta de Recursos Realidade Misturada para importar os pacotes selecionados para o projeto do Unity.

3. Criar o projeto do Unity

Abra o projeto do Unity e aguarde o Unity concluir a importação dos pacotes recém-adicionados. Pode haver dois pop-ups nesse processo:

  1. O primeiro pop-up pergunta se você deseja habilitar o novo back-end de entrada. Certifique-se de pressionar "sim".
  2. O segundo pop-up pergunta se você deseja atualizar o XR InteractionLayerMask. Certifique-se de pressionar "Não Obrigado".

O Unity pode reiniciar algumas vezes nesse processo e aguarde até que ele seja concluído antes de prosseguir.

4. Configurar o perfil do MRTK após a importação

Depois de importado, o MRTK3 exige que um perfil seja definido como autônomo e cada plataforma de destino adicional.

  1. Acesse Editar > Configurações do Projeto

  2. Em Configurações do Projeto, vá em MRTK3 e alterne para a guia autônoma. Observe que o perfil não é especificado inicialmente.

  3. Preencha o campo com o perfil MRTK padrão que vem com o pacote principal. Você pode digitar a palavra-chave "MRTKprofile" na barra de pesquisa da janela do projeto, certifique-se de pesquisar emAll. Como alternativa, você pode encontrar o perfil em Packages/com.microsoft.mrtk.core/Configuration/Default Profiles/MRTKProfile.asset.

    Observação

    Nem todos os subsistemas MRTK são mostrados na captura de tela abaixo. Os subsistemas MRTK que você vê podem ser diferentes, dependendo dos pacotes MRTK3 adicionados ao projeto.

    assign the default MRTK profile

  4. Alterne para as guias de outros destinos de build que você deseja usar (por exemplo, UWP, Android) e verifique se o perfil está atribuído. Caso contrário, repita a etapa anterior na guia atual.

Depois de importado, o MRTK3 exigirá alguma configuração no OpenXR se você estiver direcionando um dispositivo XR, como HoloLens 2 ou Quest.

Observação

As instruções a seguir se aplicam a headsets HoloLens 2 ou WMR. Se você estiver direcionando Quest, consulte as instruções na página de implantação do Quest.

  1. Acesse Editar > Configurações do Projeto

  2. Em Configurações do Projeto, vá em Gerenciamento de Plug-in XR e habilite o OpenXR nas guias Autônoma e UWP. Em cada guia, verifique se Inicializar XR na Inicialização está selecionado e se o grupo de recursos Windows Mixed Reality em Autônomo e o grupo de recursos Microsoft HoloLens em UWP estão habilitados.

    Observação

    Um ícone de aviso amarelo pode aparecer depois de verificar a opção OpenXR. Clique nesse ícone para abrir a ferramenta OpenXR Project Validation. Clique em corrigir tudo e ignorar o problema de perfil de interação que não pode ser corrigido automaticamente. Os perfis serão adicionados na etapa abaixo.

    Para autônomo:

    Standalone XR Plug-in Management window

    Para UWP:

    UWP XR Plug-in Management window

  3. Em Configurações do Projeto, vá em Gerenciamento de Plug-in XR > OpenXR> Perfis de Interação e adicione os três perfis a seguir para UWP e Autônomo:

    • Perfil de Interação do Foco Ocular
    • Perfil de Interação Manual da Microsoft
    • Perfil do Controlador de Movimento da Microsoft

    Observação

    Talvez seja necessário usar a ferramenta OpenXR Project Validation para eliminar o triângulo amarelo.

    Para autônomo:

    Standalone OpenXR

    Para UWP:

    UWP OpenXR

  4. Para HoloLens 2, é recomendável usar o envio de profundidade de 16 bits nas configurações acima. Para fones de ouvido imersivos, você pode usar o envio de profundidade de 24 bits. Consulte os documentos de desenvolvimento da Microsoft para Unity para obter mais informações.

6. Parabéns, a instalação do projeto foi concluída!

Prossiga para criar uma nova cena MRTK3.

Próximas etapas