Implantação para Oculus Quest

É necessário um Oculus Quest.

O apoio do MRTK ao Oculus Quest vem através de duas fontes diferentes, o oleoduto XR SDK da Unidade e o pacote Oculus Integration Unitity. O Oculus XRSDK Data Provider permite a utilização de ambas as fontes e deve ser usado para implantar MRTK na Oculus Quest.

O Pipeline Unity XR SDK permite a utilização de controladores Oculus Touch e o rastreio de cabeça com o Oculus Quest. Este oleoduto é o padrão para o desenvolvimento de aplicações XR na Unidade 2019.3 e não só. Para utilizar este oleoduto, certifique-se de que utiliza a Unidade 2019.3 ou mais recente. Isto é necessário para implementar aplicações MRTK para o Oculus Quest.

O pacote Oculus Integration Unitity permite o uso de rastreio manual com o Oculus Quest. Este fornecedor de dados NÃO utiliza o Gasoduto XR SDK da Unidade ou o Gasoduto Legacy XR.

Criação de projeto para o Oculus Quest

  1. Siga estes passos para garantir que o seu projeto está pronto para ser implantado na Oculus Quest.

  2. Certifique-se de que o modo de desenvolvimento está ativado no seu dispositivo. A instalação dos Condutores Oculus ADB é opcional.

Configuração do Pipeline XR SDK para Oculus Quest

  1. Certifique-se de que o Plugin Oculus XR está instalado sob a Janela -- Gestor de Pacotes

    Pacote Oculus XR Plugin

  2. Certifique-se de que o Fornecedor Oculus Plug-in está incluído no seu projeto indo para Editar -- Project Definições -- > XR Gestão Plug-in -- > Fornecedores plug-in

    Provedor oculus plugin

Criação do pacote Oculus Integration Unitity para permitir o rastreio manual

  1. Descarregue e importe a Oculus Integration da Unity Asset Store. A versão mais recente testada para trabalhar é 20.0.0. Versões mais antigas podem ser encontradas a partir deste arquivo.

  2. Navegue para utilitários de ferramentas de realidade mista >> Oculus > Integrar módulos de unidade de integração oculus. Ao fazê-lo, atualizará os asmdefs com definições e referências necessárias para que o código Oculus Quest relevante funcione. Também atualizará o ficheiro CSC para filtrar os avisos obsoletos produzidos pelos ativos da Oculus Integration. O repo MRTK contém um ficheiro CSC que converte avisos em erros, esta conversão interrompe o processo de configuração MRTK-Quest.

    Integração Oculus Asmdef

  3. Na pasta Oculus importada (deve ser encontrada em Ativos/Oculus), existe um objeto scriptable chamado OculusProjectConfig. Nesse ficheiro config, é necessário definir o handTrackingSupport para "Controladores e Mãos".

    Controlador de integração oculus e mãos

Preparando a cena

  1. Crie uma nova cena de Unidade ou abra uma cena pré-existente como HandInteractionExamples.
  2. Adicione MRTK à cena navegando para Mixed Reality ToolkitAdicionar à Cena e Configurar.

Utilizando o Fornecedor de Dados Oculus XR SDK

  1. Configure o seu perfil para utilizar o Fornecedor de Dados Oculus XR SDK
    • 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 Copy and Personalize para clonar o perfil de realidade mista padrão.

      Perfil do Clone

      • Selecione o perfil de configuração de entrada.

      Perfil de configuração de entrada

      • Selecione Clone no perfil do sistema de entrada para ativar a modificação.

      Perfil do sistema de entrada de clone

      • Abra a secção de Fornecedores de Dados de Entrada, selecione Add Data Provider no topo e será adicionado um novo fornecedor de dados no final da lista. Abra o novo fornecedor de dados e desembrote o tipo para Microsoft.MixedReality.Toolkit.XRSDK.Oculus OculusXRSDKDeviceManager.

      Provedor de dados Oculus Add XRSdk

  1. Configure o seu perfil para utilizar o Fornecedor de Dados Oculus XR SDK
    • 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 Copy and Personalize para clonar o perfil de realidade mista padrão.

      Perfil do Clone

      • Selecione o perfil de configuração de entrada.

      Perfil de configuração de entrada

      • Selecione Clone no perfil do sistema de entrada para ativar a modificação.

      Perfil do sistema de entrada de clone

      • Abra a secção de Fornecedores de Dados de Entrada, selecione Add Data Provider no topo e será adicionado um novo fornecedor de dados no final da lista. Abra o novo fornecedor de dados e desembrote o tipo para Microsoft.MixedReality.Toolkit.XRSDK.Oculus OculusXRSDKDeviceManager.

      Provedor de dados Oculus Add XRSdk

  1. O Oculus XR SDK Data Provider inclui um Prefab de equipamento de câmara OVR que configura automaticamente o projeto com uma Plataforma de Câmara OVR e Mãos OVR para encaminhar corretamente a entrada. A adição manual de uma plataforma de câmara OVR à cena requer uma configuração manual das definições e entrada.

Construa e implemente o seu projeto para o Oculus Quest

  1. Ligue o seu Oculus Quest através de um cabo USB 3.0 - > USB C

  2. Navegue para a construção de Definições de ficheiros

  3. Alterar a implementação para Android

  4. Certifique-se de que o Oculus Quest é selecionado como o dispositivo de execução aplicável

    Dispositivo de execução oculus

  5. Selecione Construir e Executar

    • É provável que encontre o seguinte conjunto de erros de construção quando selecionar Construir e Executar pela primeira vez. Deverá ser capaz de implementar com sucesso ao selecionar Build and Run novamente.

    Oculus Expect Build Errors

  6. Aceite o pedido de depuração de depuração USB de dentro da missão

  7. Veja a sua cena dentro do Oculus Quest

Remoção da integração da Oculus do Project

  1. Navegue para o Conjunto de Ferramentas de Realidade Mista > Oculus > Separar módulos de unidade de integração >
  2. Deixe a Unidade refrescar-se como referências no Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef e outros ficheiros são modificados neste passo
  3. Unidade Próxima
  4. Perto Visual Studio, se estiver aberto.
  5. Abra o Explorador de Arquivos e navegue até à raiz do projeto MRTK Unitity
  6. Apagar o Diretório de Nome/Biblioteca do UnityProject
  7. Eliminar o Nome/Ativo da Unidade/Oculus
  8. Eliminar o ficheiro UnityProjectName/Assets/Oculus.meta
  9. Reabrir Unidade

Erros comuns

Missão não reconhecida pela Unidade

Certifique-se de que os seus caminhos Android estão devidamente configurados. Se continuar a encontrar problemas, siga este guia

Editar Preferências > Ferramentas Externas > Android

Ferramentas Android Config