Implantação no Oculus Quest

Uma Quest Oculus é necessária.

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

O pipeline do SDK do Unity XR permite o uso de controladores de toque Oculus e acompanhamento de cabeçalho com o Oculus Quest. Esse pipeline é o padrão para desenvolver aplicativos XR no Unity 2019,3 e posterior. 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 rastreamento manual e modelos de 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. A instalação dos drivers Oculus ADB é opcional.

Configurando o pipeline do SDK do XR para Oculus Quest

  1. verifique se o plug-in Oculus XR está instalado em Window-- Gerenciador de Pacotes

    Pacote de plug-in Oculus XR

  2. verifique se o provedor de plug-in do Oculus está incluído no seu projeto acessando editar-- Project Configurações-- > XR gerenciamento de plug-in-- > provedores de plug-in

    Provedor de plug-in Oculus

Importante

Você pode usar o plug-in OpenXR para implantar aplicativos MRTK no Oculus Quest. No entanto, a visualização do controlador e o acompanhamento manual não têm suporte no momento no OpenXR.

É recomendável que você use o plug-in Oculus XR até que o suporte completo esteja disponível com o pacote de integração do Oculus.

Configurando o pacote do Oculus Integration Unity para habilitar o handtracking

  1. Baixe e importe a integração do Oculus do repositório de ativos do Unity. A versão mais recente testada para o trabalho é 35.0.0. Versões mais antigas podem ser encontradas neste arquivo morto.

  2. navegue até a realidade misturada Toolkit > Utilities > Oculus > integrar módulos do Oculus Integration Unity. Isso atualizará o asmdefs com definições e referências necessárias para que o código relevante da Quest Oculus funcione. Ele também atualizará o arquivo csc para filtrar os avisos obsoletos produzidos pelos ativos de integração do Oculus. 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.

    Integração do Oculus Asmdef

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

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

Configurando a cena

  1. Crie uma nova cena do Unity ou abra uma cena já existente como HandInteractionExamples.
  2. adicione MRTK à cena navegando até a realidade misturada Toolkitadicionar à cena e configurar.

usando o SDK do Oculus XR Provedor de Dados

  1. configurar seu perfil para usar o SDK do Oculus XR Provedor de Dados
    • Se não pretende 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. Oculus OculusXRSDKDeviceManager.

      Oculus adicionar XRSDK Provedor de Dados

  1. configurar seu perfil para usar o SDK do Oculus XR Provedor de Dados
    • Se não pretende 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. Oculus OculusXRSDKDeviceManager.

      Oculus adicionar XRSDK Provedor de Dados

  1. o SDK do Oculus XR Provedor de Dados inclui um rig da câmera ovr pré-fabricado que configura automaticamente o projeto com um dispositivo de câmera ovr e as mãos de ovr para rotear corretamente a entrada. Adicionar manualmente um Rig da câmera OVR à cena exigirá a configuração manual de configurações e de entrada.

Criar e implantar seu projeto no Oculus Quest

  1. Conecte seu Oculus Quest por meio de um cabo USB 3,0- > USB C

  2. navegue até o arquivo criar Configurações

  3. Alterar a implantação para Android

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

    Oculus executar dispositivo

  5. Selecione compilar e executar

    • Você provavelmente encontrará o seguinte conjunto de erros de compilação ao selecionar Compilar e executar a primeira vez. Você deve ser capaz de implantar com êxito ao selecionar Compilar e executar novamente.

    Oculus erros de compilação esperados

  6. Aceite o prompt permitir depuração de USB de dentro do Quest

  7. Veja sua cena dentro do Oculus Quest

Removendo a integração do Oculus do Project

  1. navegue até a realidade misturada Toolkit > Oculus > separar Oculus integração módulos do Unity >
  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 Visual Studio, se estiver aberto
  5. Abra o explorador de arquivos e navegue até a raiz do projeto do MRTK Unity
  6. Excluir o diretório de UnityProjectName/biblioteca
  7. Excluir o diretório UnityProjectName/assets/Oculus
  8. Excluir o arquivo UnityProjectName/assets/Oculus. meta
  9. Reabrir o Unity

Erros comuns

Quest 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 preferências > Ferramentas externas > Android

Configuração de ferramentas do Android