Exercício – importar e configurar recursos

  • 10 minutos

Instale a Ferramenta de Recursos de Realidade Misturada

Para importar o Kit de Ferramentas de Realidade Misturada para seu projeto, você usará a Ferramenta de Recursos de Realidade Misturada. A ferramenta Recurso de Realidade Misturada permite que os desenvolvedores descubram, atualizem e importem pacotes de recursos. Você pode pesquisar pacotes por nome ou categoria, ver suas dependências e visualizar as alterações propostas no arquivo de manifesto do seu projeto antes de importar.

  1. Baixe a última versão da Ferramenta de Recursos de Realidade Misturada do Centro de Download da Microsoft.

  2. Após o download terminar, abra o arquivo MixedRealityFeatureTool.exe e use-o para iniciar a Ferramenta de Recurso de Realidade Misturada.

    Observação

    Antes de poder executar a Ferramenta Recursos de Realidade Misturada, você precisa instalar o runtime .NET 6.0.

Importar o pacote Foundation do MRTK Unity

  1. Na Ferramenta de Recurso de Realidade Misturada, selecione Iniciar.

    Captura de tela da tela de abertura da Ferramenta de Recursos de Realidade Misturada.

  2. Selecione o botão Procurar (é o botão de "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 do Unity válida.

    Captura de tela da tela do Caminho do projeto da ferramenta de recursos da Realidade Misturada.

  3. Selecione Descobrir Recursos.

    Observação

    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 Ferramenta de Recursos de Realidade Misturada.

  5. Selecione o botão + à esquerda de Suporte da Plataforma (0 de 5) e, em seguida, selecione a versão mais recente do Plug-in OpenXR de Realidade Misturada.

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

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

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

    Observação

    Se você vir algum pacote marcado como preterido, deverá removê-lo e verificar se Configurações > Recurso > Mostrar pacotes obsoletos está desmarcado.

  7. Depois de fazer suas seleções, selecione Obter recursos.

  8. Selecione Validar para validar o pacote. Você deverá ver uma caixa de diálogo informando que Nenhum problema de validação foi detectado. Ao fazer isso, selecione OK.

  9. Na página Importar recursos, a coluna do lado esquerdo, Recursos, exibe os pacotes que você selecionou. A coluna do lado direito, Dependências Necessárias, exibe as dependências. Você pode selecionar o link Detalhes de qualquer um desses itens para saber mais sobre eles.

  10. Quando estiver pronto para continuar, selecione Importar. Na página Examinar e Aprovar, você pode revisar as informações sobre os pacotes.

  11. Selecione Aprovar.

  12. Selecione Sair.

  13. Retorne ao Unity Editor 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 do 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 na barra superior.

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

  2. O Unity perguntará a você sobre a atualização de métodos no XR InteractionLayerMask, selecione o botão Fiz um backup, prossiga! e aguarde o Unity reiniciar.

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

  3. Na barra de menu, selecione Realidade Misturada>Projeto>Aplicar as configurações de projeto recomendadas para o HoloLens.

  4. Na barra de menus, selecione Editar>Configurações do projeto.... Selecione Gerenciamento do Plug-in XR. Certifique-se de que a opção Inicializar XR na Inicialização esteja selecionada e, em Provedores de plug-in, selecione Abrir XR.

    Captura de tela de inicializar XR na inicialização.

  5. O Plug-in do OpenXR é carregado e dois itens aparecem abaixo de OpenXR. Selecione o primeiro, Grupo de Recursos do Microsoft HoloLens. Selecione o ponto de exclamação amarelo.

    Captura de tela da opção Abrir XR.

  6. Selecione Corrigir tudo.

    Captura de tela de Corrigir tudo.

    Alguns avisos podem permanecer. Ignore-os por enquanto.

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

  8. Em Perfis de interação, adicione Interação da Mão da Microsoft e Perfil de Interação do Foco Ocular se eles não tiverem sido adicionados.

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

  9. Verifique se Microsoft Hololens à esquerda está selecionado e Rastreamento da Mão, Recursos de Realidade Misturada e Modelo do Controlador de Movimento à direita estão selecionados.

  10. Selecione o sinal de aviso ao lado de Perfil de Interação por Foco Ocular para retornar à janela de Validação do Projeto. Verifique se você está na guia da Plataforma UWP (a guia exibe o logotipo do Windows) e, em seguida, 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 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 que desejar.

  11. Em Configurações do projeto, selecione MRTK3 e verifique se há um perfil válido. Se não houver nenhum, pesquise MRTKProfile nos pacotes do projeto (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) e atribua-o ao perfil.

    Captura de tela do perfil do MRTK.

Definir as configurações do projeto

  1. Na barra de menu, selecione Editar>Configurações do projeto.

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

  3. Observe que, na janela do Player, o Nome do Produto é "Tutorial de MRTK", que é obtido do nome do projeto e será o nome exibido no menu Iniciar 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 na parte superior de qualquer lista.

  4. Selecione o menu suspenso Configurações de Publicação e, no campo Nome do pacote, digite um nome adequado; por exemplo, MRTK-Tutorials-Getting-Started:

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

    Observação

    O nome do pacote é o identificador exclusivo do aplicativo. Para evitar a substituição de versões instaladas anteriormente do aplicativo com o mesmo nome, altere esse identificador antes de implantar o aplicativo.

  5. Feche a janela Configurações de Projeto.

Criar a cena e configurar o MRTK

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

  2. Na janela Projeto, navegue até a pasta Pacotes>Entrada do MRTK>Ativos>Pré-fabricados. 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 Câmera principal porque o objeto de jogo MRTK XR Rig já contém uma câmera.

    Captura de tela do Kit de ferramentas da Realidade Misturada no Inspetor.

  4. Adicione o pré-fabricado Simulador de entrada do MRTK (Pacotes>Entrada do MRTK>Simulação>Pré-fabricados) à sua cena.

    Observação

    Essa etapa é opcional, mas exigida para simulações no editor.

    Captura de tela do simulador de entrada.

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

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