Exercício – Importar e configurar recursos

  • 10 minutos

Instalar a ferramenta de recurso de realidade mista

Para importar o Kit de Ferramentas de Realidade Mista para seu projeto, você usará a Ferramenta de Recursos de Realidade Mista. A ferramenta permite que os desenvolvedores descubram, atualizem e importem pacotes de recursos. 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, abra o arquivo MixedRealityFeatureTool.exe executável e use-o para iniciar a Mixed Reality Feature Tool.

    Nota

    Antes de executar a Mixed Reality Feature Tool, talvez seja necessário instalar o tempo de execução do .NET 6.0.

Importar o pacote de fundação MRTK Unity

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

    Screenshot of the Mixed Reality Feature Tool opening screen.

  2. Selecione o botão Procurar (é o botão ... na imagem a seguir), navegue até seu projeto e abra-o.

    Open your project

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

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  3. Selecione Descobrir recursos.

    Nota: 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 grupos de pacotes disponíveis.

    The main groups of packages in the Mixed Reality Feature Tool

  5. Selecione o + botão à esquerda de Suporte à plataforma (0 de 5) e, em seguida, selecione a versão mais recente do Mixed Reality OpenXR Plugin.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Selecione o botão Selecionar tudo à direita do MRTK3 para que todos os recursos sejam selecionados.

    Screenshot of selecting all feature of MRTK3.

    Nota

    Se vir quaisquer pacotes marcados como obsoletos, deve removê-los e certificar-se de que a opção Funcionalidade > de Definições > Mostrar pacotes preteridos está desmarcada.

  7. Depois de fazer a(s) sua(s) seleção(ões), selecione 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, selecione OK.

  9. Na página Importar Recursos, a coluna do lado esquerdo, Recursos, exibe os pacotes selecionados. A coluna do lado direito, Dependências necessárias, exibe todas as dependências. Você pode selecionar o link Detalhes para 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 e, em seguida, selecione Sair.

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

Configurar o projeto Unity

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

    Screenshot of Unity Restart Option.

  2. Unity pode perguntar sobre a atualização de métodos no XR InteractionLayerMask. Selecione o botão Eu fiz um backup, vá em frente! e aguarde até que o Unity reinicie.

    Screenshot of updating methods in the XR InteractionLayerMask.

  3. Na barra de menus, selecione Editar>configurações do projeto. Selecione XR Plugin-in Management. Verifique se a opção Inicializar XR na inicialização está selecionada e marque a caixa de seleção Abrir XR em Provedores de plug-in.

    Screenshot of Initialize XR on Startup.

  4. O plug-in OpenXR é carregado e dois itens aparecem em OpenXR. Marque a caixa para o primeiro, Microsoft HoloLens feature group. Selecione o ponto de exclamação amarelo.

    Screenshot of Open XR option.

  5. Selecione Corrigir tudo.

    Screenshot of Fix All.

    Alguns avisos podem permanecer. Ignore-os por enquanto.

  6. Selecione OpenXR em Gerenciamento de plug-in XR.

  7. Em Perfis de Interação, selecione +e, em seguida, adicione o Perfil de Interação da Mão da Microsoft e o Perfil de Interação do Olhar dos Olhos, caso ainda não tenham sido adicionados.

    Screenshot of Add Interaction Profiles.

  8. Verifique se Microsoft Hololens à esquerda está selecionado e Rastreamento de mãos, Recursos de realidade mista e Modelo de controlador de movimento à direita estão selecionados.

  9. Selecione o ponto de exclamação amarelo ao lado de Perfil de interação do Olhar Ocular para recuperar a janela Validação do projeto. Verifique se você está na guia Plataforma UWP (a guia exibe o logotipo do Windows) e selecione Corrigir tudo para resolver os problemas de validação. Observe que alguns problemas podem permanecer. Nesse caso, selecione Corrigir tudo novamente, ignore todos os problemas marcados como específicos da cena e, em seguida, leia as recomendações para os problemas restantes (se houver) e faça as alterações desejadas.

  10. Na janela Configurações do projeto, selecione MRTK3 e verifique se há um perfil válido. Se não houver, procure por MRTKProfile nos Pacotes do projeto (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset ) e atribua-o ao Perfil.

    Screenshot of MRTK profile.

Definir configurações do projeto

  1. Na barra de menus, selecione Editar>configurações do projeto.

  2. Na janela Definições do Projeto, selecione Leitor.

  3. Observe que na janela do Player, o Nome do Produto é Tutorial MRTK. Isso é retirado do nome do seu projeto e será o nome exibido no menu Iniciar do HoloLens.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    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.

  4. Selecione a lista suspensa Configurações de publicação e, em seguida, no campo Nome do pacote , insira um nome adequado, por exemplo, MRTK-Tutorials-Getting-Started:

    Screenshot of Unity Publishing Settings with the package name box filled in.

    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.

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

Criar a cena e configurar o MRTK

  1. Na barra de menus, selecione Arquivo>Nova Cena. Selecione a opção Básico (incorporado) e, em seguida, selecione Criar.

  2. Na janela Projeto, navegue até a pasta Packages>MRTK Input>Assets>Prefabs. Arraste o MRTK XR Rig pré-fabricado para a hierarquia da cena.

    Screenshot of the adding MRTK XR Rig in the Inspector.

  3. Remova o objeto de jogo Main Camera, porque o objeto de jogo MRTK XR Rig já contém uma câmera.

    Screenshot of the Mixed Reality Toolkit in the Inspector.

  4. Adicione o simulador de entrada MRTK (pacotes>MRTK Input>Simulation>Prefabs) pré-fabricado à sua cena.

    Nota

    Esta etapa é opcional, mas exigida por simulações no editor.

    Screenshot of the input simulator.

  5. Na barra de menus, selecione Arquivo>Salvar como.

  6. Navegue até a pasta Cenas de ativos>, nomeie e salve seu projeto.