Implantando na Solicitação – MRTK2

Uma Meta-Solicitação (1 ou 2) é necessária.

Configurando o projeto para a Solicitação

1. Siga estas etapas para garantir que seu projeto esteja pronto para ser implantado na Solicitação.
2. Verifique se o modo de desenvolvedor está habilitado em seu dispositivo. Instalar os Drivers do Oculus ADB é opcional.

Configurando a cena

1. Crie uma nova cena do Unity ou abra uma cena pré-existente, como HandInteractionExamples.
   1. Se estiver criando uma nova cena, adicione o MRTK à cena navegando até Realidade Misturada Kit de Ferramentas>Adicionar à Cena e Configurar.

Integração do MRTK

OpenXR (SDK do XR)

O suporte do MRTK para dispositivos Quest vem por meio de duas fontes diferentes: o pacote do Plug-in OpenXR do Unity para o pipeline do SDK do XR e o pacote Realidade Misturada Plug-in OpenXR. O Provedor de Dados OpenXR XRSDK permite o uso de ambas as fontes e deve ser usado para implantar o MRTK na Solicitação.

Você pode usar o plug-in Realidade Misturada OpenXR para implantar aplicativos MRTK na Solicitação. Depois de habilitar o OpenXR, verifique se todos os recursos necessários estão habilitados (provavelmente "Acompanhamento manual" e "Suporte à Meta-Solicitação").

Verifique se o seu perfil (se não estiver usando o padrão mrtk) está configurado com o Gerenciador de Dispositivos OpenXR. Consulte Configurando o MRTK para o pipeline do SDK do XR para obter mais informações sobre como garantir que seu perfil esteja pronto para o OpenXR.

Oculus (SDK do XR)

O suporte do MRTK para dispositivos Quest vem por meio de duas fontes diferentes: o pacote Oculus Plugin do Unity para o pipeline do SDK do XR e o pacote Oculus Integration Unity. O Provedor de Dados Oculus XRSDK permite o uso de ambas as fontes e deve ser usado para implantar o MRTK no Oculus Quest.

O Pipeline do SDK do Unity XR permite o uso de controladores Oculus Touch e acompanhamento de cabeçalho com a Solicitação. Esse pipeline é o padrão para desenvolver aplicativos XR no Unity 2019.3 e posterior. Para usar esse pipeline, verifique se você está usando o Unity 2019.3 ou mais recente. Isso é necessário para implantar aplicativos MRTK na Solicitação.

O pacote Oculus Integration Unity permite o uso de modelos de controle manual e controlador com a Solicitação.

Configurando o pipeline do SDK do XR para Solicitação

1. Verifique se o plug-in Oculus XR está instalado em Janela –> Gerenciador de Pacotes

   

2. Verifique se o Provedor de Plug-in do Oculus está incluído em seu projeto acessando Editar –> Configurações do Projeto –> Gerenciamento de Plug-inS XR –> Provedores de Plug-in

   

Configurando o pacote Oculus Integration Unity para habilitar o acompanhamento manual

1. Baixe e importe a Integração do Oculus do Repositório de Ativos do Unity. A versão mais recente testada para funcionar é a 39.0.0. As versões anteriores não funcionarão devido a alterações feitas na API do Oculus. Todas as versões do Pacote de Integração do Oculus podem ser encontradas neste arquivo morto.

2. Navegue até Realidade Misturada Utilitários do Kit de Ferramentas >> Oculus > Integrar Módulos do Oculus Integration Unity. Isso atualizará os asmdefs com definições e referências necessárias para que o código de Solicitação relevante funcione. Ele também atualizará o arquivo csc para filtrar os avisos obsoletos produzidos pelos ativos do Oculus Integration. O repositório do MRTK contém um arquivo csc que converte avisos em erros. Essa conversão interrompe o processo de configuração do MRTK-Quest.

   

3. Na pasta Oculus importada (deve ser encontrada em Assets/Oculus), há um objeto que pode ser gerado por script chamado OculusProjectConfig. Nesse arquivo de configuração, você precisa definir HandTrackingSupport como "Controladores e Mãos".

   

Usando o provedor de dados do SDK do Oculus XR

1. Configurar seu perfil para usar o Provedor de Dados do SDK do Oculus XR
   • Se não pretende modificar os perfis de configuração
     • Use qualquer um dos perfis padrão do MRTK, todos configurados nos pipelines XR do Unity. O DefaultXRSDKConfigurationProfile anterior agora está rotulado como obsoleto.
     • Acesse Compilar e implantar seu projeto na Solicitação.
   • Caso contrário, siga o seguinte:

     • Selecione o objeto de jogo MixedRealityToolkit na hierarquia e selecione Copiar e Personalizar para clonar o perfil de realidade misturada padrão.

       

     • Selecione o Perfil de Configuração de Entrada .

       

     • Selecione Clonar no perfil do sistema de entrada para habilitar a modificação.

       

     • Abra a seção Provedores de Dados de Entrada , selecione Adicionar Provedor de Dados na parte superior e o novo provedor de dados será adicionado no final da lista. Abra o novo provedor de dados e defina o Tipo como Microsoft.MixedReality.Toolkit.XRSDK.OculusXRSDKDeviceManager>.

       

1. O Provedor de Dados do SDK do Oculus XR inclui um OVR Camera Rig Prefab que configura automaticamente o projeto com um OVR Camera Rig e o OVR Hands para rotear corretamente a entrada. Adicionar manualmente um OVR Camera Rig à cena exigirá a configuração manual de configurações e entrada.

Removendo a integração do Oculus do projeto

1. Navegue até Realidade Misturada Toolkit > Oculus Separate Oculus > Integration Unity Modules
2. Deixe o Unity atualizar como referências no Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef e outros arquivos são modificados nesta etapa
3. Fechar o Unity
4. Feche o Visual Studio, se ele estiver aberto
5. Abra Explorador de Arquivos e navegue até a raiz do projeto do MRTK Unity
6. Excluir o diretório UnityProjectName/Library
7. Excluir o diretório UnityProjectName/Assets/Oculus
8. Excluir o arquivo UnityProjectName/Assets/Oculus.meta
9. Reabrir o Unity

Criar e implantar seu projeto na Solicitação

1. Conecte sua solicitação por meio de um cabo USB 3.0 –> USB C

2. Navegar até as Configurações de build de > Arquivo

3. Alterar a implantação para Android

4. Verifique se a Solicitação está selecionada como o dispositivo de execução aplicável

   

5. Selecione Compilar e Executar

   • Você pode encontrar o seguinte conjunto de erros de build ao selecionar Compilar e Executar pela primeira vez. Isso não deve impedir a implantação. Consulte o problema nº 10449 para obter mais informações e possíveis opções de mitigação.

   

6. Aceitar o prompt Permitir Depuração USB de dentro da Solicitação

7. Ver sua cena dentro da Solicitação

Erros comuns

Solicitação não reconhecida pelo Unity

Verifique se os caminhos do Android estão configurados corretamente. Se você continuar a encontrar problemas, siga este guia.

Procure em Editar > Preferências Ferramentas Externas >> Android: