Exercício – Importar e configurar recursos

  • 10 minutos

Instalar a Ferramenta de Funcionalidades 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 Mixed Reality Feature Tool 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. Depois que o download terminar, abra o arquivo MixedRealityFeatureTool.exe e use-o para iniciar a Ferramenta de Recursos de Realidade Mista.

    Nota

    Antes de poder executar a Mixed Reality Feature Tool, talvez seja necessário instalar o runtime do .NET 6.0.

Importar o pacote de base do MRTK Unity

  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.

    Captura de tela da tela Selecionar projeto.

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

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

  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.

    Captura de tela dos principais grupos de pacotes na 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.

    Captura de ecrã das seleções de pacotes na Ferramenta de Realidade Mista.

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

    Captura de tela da seleção de todos os recursos do 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.

  12. Selecione Sair.

  13. 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).

    Captura de ecrã da opção Unity Restart.

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

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

  3. Na barra de menus, selecione Mixed Reality>Projeto>Aplicar configurações de projeto recomendadas para HoloLens.

  4. Na barra de menus, selecione Editar>configurações do projeto.... Selecione XR Plugin-in Management. Certifique-se de que Inicializar XR na Inicialização está selecionado e, em seguida, em Provedores de Plug-in, selecione Open XR.

    Captura de ecrã de inicialização do XR ao arranque.

  5. O plug-in OpenXR é carregado e, em seguida, dois itens aparecem abaixo do OpenXR. Selecione o primeiro, Microsoft HoloLens feature group. Selecione o ponto de exclamação amarelo.

    Screenshot da opção Open XR.

  6. Selecione Corrigir tudo.

    Captura de ecrã de Fix All.

    Alguns avisos podem permanecer. Ignore-os por enquanto.

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

  8. Em Perfis de interação, adicione Microsoft Hand Interaction e Eye Gaze Interaction Profile se não tiverem sido adicionados.

    Captura de ecrã de Adicionar perfis de interação.

  9. 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.

  10. Selecione o sinal de alerta ao lado do Perfil de Interação com Olhar para trazer de volta a janela de 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 pode haver problemas que permanecem depois de selecionar Corrigir tudo. 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.

  11. Em 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 do perfil MRTK.

Definir configurações do projeto

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

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

  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.

    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.

  4. Selecione o menu pendente Configurações de Publicação e, em seguida, 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.

    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.

Crie a cena e configure o MRTK

  1. Na barra de menus, selecione Ficheiro>Nova Cena. Selecione a opção Basic (Built-in) e, em seguida , Create.

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

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

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

    Captura de ecrã do Kit de Ferramentas de Realidade Mista no Inspetor.

  4. Adicione o Simulador de Entrada MRTK (Pacotes>MRTK Input>Simulação>Prefabs) pré-fabricado à sua cena.

    Nota

    Esta etapa é opcional, mas necessária para simulações no editor.

    Captura de tela do simulador de entrada.

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

  6. Navegue até à pasta Assets>Scenes, nomeie o seu projeto e depois guarde-o.