Implantação no Oculus Quest – MRTK2

Um Oculus Quest é necessário.

O suporte do MRTK para o Oculus Quest vem por meio de duas fontes diferentes, o pipeline do SDK XR do Unity e o pacote do 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 o Oculus Quest. Esse pipeline é o padrão para desenvolver aplicativos XR no Unity 2019.3 e além. Para usar esse pipeline, certifique-se de usar o Unity 2019.3 ou mais recente. Isso é necessário para implantar aplicativos MRTK no Oculus Quest.

O pacote do Oculus Integration Unity permite o uso de modelos de controle manual e controlador com o Oculus Quest.

Configurando o projeto para o Oculus Quest

  1. Siga estas etapas para garantir que seu projeto esteja pronto para ser implantado no Oculus Quest.

  2. Verifique se o modo de desenvolvedor está habilitado em seu dispositivo. Instalar os Drivers do Oculus ADB é opcional.

Configurando o pipeline do SDK do XR para o Oculus Quest

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

    Pacote de plug-in do Oculus XR

  2. Certifique-se de que o Provedor de Plug-in do Oculus esteja incluído em seu projeto, indo para Editar --> Configurações do Projeto --> Gerenciamento de Plug-in XR --> Provedores de Plug-in

    Provedor de plug-in do Oculus

Importante

Você pode usar o Plug-in OpenXR para implantar aplicativos MRTK no Oculus Quest. No entanto, atualmente, não há suporte para visualização do controlador e acompanhamento manual no OpenXR.

É recomendável que você use o Plug-in Oculus XR até que o suporte total esteja disponível com o pacote Oculus Integration.

Configurando o pacote do Oculus Integration Unity para habilitar o rastreamento manual

  1. Baixe e importe o Oculus Integration do Unity Asset Store. A versão mais recente testada para funcionar é a 39.0.0. As versões anteriores não funcionarão devido à alteração feita na API do Oculus. Todas as versões do Pacote de Integração do Oculus podem ser encontradas neste arquivo.

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

    Oculus Integration Asmdef

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

    Controlador e mãos de integração do Oculus

Configurando a cena

  1. Crie uma nova cena do Unity ou abra uma cena pré-existente, como HandInteractionExamples.
  2. Adicione o MRTK à cena navegando até Realidade MisturadaAdicionar à Cena doKit de Ferramentas> e Configurar.

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 pretender modificar os perfis de configuração

      • Use qualquer um dos perfis padrão do MRTK, que estão todos configurados nos pipelines XR do Unity. O DefaultXRSDKConfigurationProfile anterior agora está rotulado como obsoleto.
      • Vá para Compilar e implantar seu projeto no Oculus Quest.
    • 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.

      Clonar Perfil

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

      Perfil de Configuração de Entrada

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

      Clonar Perfil do Sistema de Entrada

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

      Oculus Add XRSDK Data Provider

  1. Configurar seu perfil para usar o provedor de dados do SDK do Oculus XR
    • Se não pretender modificar os perfis de configuraçã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.

      Clonar Perfil

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

      Perfil de Configuração de Entrada

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

      Clonar Perfil do Sistema de Entrada

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

      Oculus Add XRSDK Data Provider

  1. O Provedor de Dados do SDK do Oculus XR inclui um pré-fabricado de plataforma de câmera OVR que configura automaticamente o projeto com uma Plataforma de Câmera OVR e mãos OVR para rotear corretamente a entrada. Adicionar manualmente um OVR Camera Rig à cena exigirá a configuração manual de configurações e entradas.

Compilar e implantar seu projeto no Oculus Quest

  1. Conecte seu Oculus Quest 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 o Oculus Quest está selecionado como o dispositivo de execução aplicável

    Dispositivo Oculus Run

  5. Selecionar Compilar e Executar

    • Você provavelmente encontrará o seguinte conjunto de erros de build ao selecionar Compilar e Executar na primeira vez. Você deve ser capaz de implantar com êxito ao selecionar Compilar e Executar novamente.

    Erros de build esperados da Oculus

  6. Aceitar o prompt permitir de depuração USB de dentro da busca

  7. Veja sua cena dentro do Oculus Quest

Removendo a integração do Oculus do projeto

  1. Navegue até Realidade Misturada Oculus > Separate Oculus > Integration Unity Modules Oculus Separation Asmdef
  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

Erros comuns

Busca não reconhecida pelo Unity

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

Editar > Ferramentas Externas de Preferências >> Android

Configuração de Ferramentas do Android