Exercício - Importar e configurar recursos

  • 10 minutos

Instalar a ferramenta de funcionalidade 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 executável MixedRealityFeatureTool.exe e use-o para iniciar a Ferramenta de Recursos de Realidade Mista.

    Observação

    Antes de poder executar a Ferramenta de Recursos de Realidade Mista, talvez seja necessário instalar o runtime do .NET 6.0 .

Importar o pacote de MRTK Unity Foundation

  1. Na Ferramenta de Funcionalidade 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 ... na imagem a seguir), navegue até seu projeto e abra-o.

    Abra seu projeto

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

    Captura de tela do ecrã do Caminho do Projeto da Ferramenta de Realidade Mista.

  3. Selecione Descobrir Funcionalidades.

    Nota: Talvez seja necessário aguardar alguns segundos enquanto a ferramenta atualiza os pacotes dos feeds.

  4. Na página Descobrir Funcionalidades, note que há uma lista de grupos de pacotes disponíveis.

    Os principais grupos de pacotes na Mixed Reality Feature Tool

  5. Selecione o botão + à esquerda do Platform Support (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.

  6. Selecione o botão Selecionar tudo à direita de MRTK3 para selecionar todos os recursos.

    Captura de tela da seleção de todos os recursos do MRTK3.

    Observação

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

  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 de 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 Revisão e Aprovação, você pode revisar as informações sobre os pacotes.

  11. Selecione Aprovare, 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 Sim.

    captura de tela da opção de reinicialização do Unity.

  2. Unity pode perguntar sobre a atualização de métodos no XR InteractionLayerMask. Selecione o botão "I Made a Backup, Go Ahead!" e aguarde até que o Unity reinicie.

    Captura de tela de métodos de atualização no XR InteractionLayerMask.

  3. Na barra de menu, selecione Editar>Configurações do Projeto. Selecione Gerenciamento de Plugin XR. Verifique se Inicializar XR na inicialização está selecionado e, em seguida, marque a caixa de seleção para Abrir XR sob Provedores de plug-in.

    captura de tela de Initialize XR on Startup.

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

    Screenshot da opção Open XR.

  5. Selecione Corrigir todos os.

    Captura de ecrã da 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 +, depois adicione Perfil de Interação Microsoft Hand e Perfil de Interação Eye Gaze se ainda não tiverem sido adicionados.

    Captura de tela do Adicionar perfis de interação.

  8. Certifique-se de Microsoft Hololens à esquerda está selecionado e de Rastreamento de Mãos , Recursos de Realidade Mista e Modelo do Controlador de Movimento à direita estão selecionados.

  9. Selecione o ponto de exclamação amarelo ao lado de Perfil de Interação de Olhar para recuperar a janela Validação do Projeto. Verifica se estás no separador da plataforma UWP (o separador exibe o logotipo do Windows) e seleciona Resolver Tudo para solucionar os problemas de validação. Observe que alguns problemas podem permanecer. Nesse caso, selecione Corrigir Tudo novamente, ignore todos os problemas marcados como sendo 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 de Configurações do Projeto , selecione MRTK3 e verifique se há um Perfilvá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 do perfil MRTK.

Definir configurações do projeto

  1. Na barra de menus, selecione Editar>Configurações do Projeto.

  2. Na janela de Configurações do Projeto , selecione Player.

  3. Observe que na janela do Player, a Nome do Produto é Tutorial MRTK. 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.

    Dica

    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 o menu suspenso Configurações de publicação e, depois, no campo Nome do pacote, insira um nome adequado; por exemplo, MRTK-Tutorials-Getting-Started.

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

    Observação

    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 Basic (Built-in) e, em seguida, selecione Create.

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

    Captura de ecrã da adição do MRTK XR Rig no Inspetor.

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

    Captura de tela do Kit de Ferramentas de Realidade Mista no Inspetor.

  4. Adicione o MRTK Input Simulator (Packages>MRTK Input>Simulation>Prefabs) prefab à sua cena.

    Observação

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

    Captura de tela do simulador de entrada.

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

  6. Navegue até à pasta Recursos>Cenas e, em seguida, nomeie e salve o seu projeto.