Implementar no Pedido — MRTK2

É necessário um Meta Quest (1 ou 2 ).

Configurar o projeto para o Pedido

1. Siga estes passos para garantir que o projeto está pronto para ser implementado no Pedido.
2. Certifique-se de que o modo de programador está ativado no seu dispositivo. A instalação dos Controladores do Oculus ADB é opcional.

Configurar a cena

1. Crie uma nova cena do Unity ou abra uma cena pré-existente, como HandInteractionExamples.
   1. Se criar uma nova cena, adicione MRTK à cena ao navegar para Mixed Reality Toolkit>Adicionar à Cena e Configurar.

Integração do MRTK

OpenXR (SDK XR)

O suporte do MRTK para dispositivos Quest é fornecido através de duas origens diferentes: o pacote de Plug-in OpenXR do Unity para o pipeline do SDK XR e o pacote de Plug-in OpenXR do Mixed Reality. O Fornecedor de Dados OpenXR XRSDK permite a utilização de ambas as origens e tem de ser utilizado para implementar o MRTK no Pedido.

Pode utilizar o Mixed Reality Plug-in OpenXR para implementar aplicações MRTK no Pedido. Depois de ativar o OpenXR, certifique-se de que todas as funcionalidades necessárias estão ativadas (provavelmente"Controlo Manual" e "Suporte do Meta Quest").

Certifique-se de que o seu perfil (se não estiver a utilizar a predefinição MRTK) está configurado com a Gestor de Dispositivos OpenXR. Veja Configurar o MRTK para o pipeline do SDK XR para obter mais informações sobre como garantir que o seu perfil está pronto para o OpenXR.

Oculus (SDK XR)

O suporte do MRTK para dispositivos Quest é fornecido através de duas origens diferentes: o pacote Oculus Plugin do Unity para o pipeline XR SDK e o pacote Oculus Integration Unity. O Fornecedor de Dados Oculus XRSDK permite a utilização de ambas as origens e tem de ser utilizado para implementar o MRTK no Oculus Quest.

O Pipeline do SDK unity XR permite a utilização de controladores Oculus Touch e controlo de cabeça com o Pedido. Este pipeline é o padrão para desenvolver aplicações XR no Unity 2019.3 e não só. Para utilizar este pipeline, certifique-se de que utiliza o Unity 2019.3 ou mais recente. Isto é necessário para implementar aplicações MRTK no Pedido.

O pacote Oculus Integration Unity permite a utilização de modelos de controlo manual e controlador com o Pedido.

Configurar o Pipeline do SDK XR para o Pedido

1. Certifique-se de que o Plug-in Oculus XR está instalado em Janela --> Gestor de Pacotes

   

2. Certifique-se de que o Fornecedor de Plug-in do Oculus está incluído no seu projeto ao aceder a Editar --> Definições do Projeto --> Gestão de Plug-in XR --> Fornecedores de Plug-in

   

Configurar o pacote Oculus Integration Unity para ativar o controlo manual

1. Transfira e importe a Integração Oculus a partir 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 efetuada à API Oculus. Todas as versões do Pacote de Integração Oculus podem ser encontradas neste arquivo.

2. Navegue para Mixed Reality Toolkit > Utilities > Oculus Integrate Oculus Integration Unity Modules (Módulos Oculus > Integration Unity). Ao fazê-lo, irá atualizar os asmdefs com definições e referências necessárias para que o código do Pedido relevante funcione. Também atualizará o ficheiro csc para filtrar os avisos obsoletos produzidos pelos recursos da Integração Oculus. O repositório MRTK contém um ficheiro csc que converte avisos em erros. Esta conversão interrompe o processo de configuração do MRTK-Quest.

   

3. Na pasta Oculus importada (deve ser encontrada em Assets/Oculus), existe um objeto scriptable chamado OculusProjectConfig. Nesse ficheiro de configuração, tem de definir HandTrackingSupport como "Controladores e Mãos".

   

Utilizar o Fornecedor de Dados SDK Oculus XR

1. Configurar o seu perfil para utilizar o Fornecedor de Dados SDK Oculus XR
   • Se não pretender modificar os perfis de configuração
     • Utilize qualquer um dos perfis MRTK predefinidos, todos configurados nos pipelines XR do Unity. O DefaultXRSDKConfigurationProfile anterior está agora etiquetado como obsoleto.
     • Aceda a Compilar e implementar o seu projeto no Pedido.
   • 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 mista predefinido.

       

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

       

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

       

     • Abra a secção Fornecedores de Dados de Entrada , selecione Adicionar Fornecedor de Dados na parte superior e será adicionado novo fornecedor de dados no final da lista. Abra o novo fornecedor de dados e defina o Tipo como Microsoft.MixedReality.Toolkit.XRSDK.Oculus > OculusXRSDKDeviceManager.

       

1. O Fornecedor de Dados SDK Oculus XR inclui um Pré-fabricado de Plataforma 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. Adicionar manualmente uma Plataforma de Câmara OVR à cena exigirá a configuração manual das definições e das entradas.

Remover a Integração Oculus do Projeto

1. Navegue para Mixed Reality Toolkit > Oculus Separate Oculus > Integration Unity Modules
2. Deixe o Unity atualizar como referências no Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef e outros ficheiros são modificados neste passo
3. Fechar Unidade
4. Feche o Visual Studio, se estiver aberto
5. Abra Explorador de Ficheiros e navegue para a raiz do projeto do Unity do MRTK
6. Eliminar o diretório UnityProjectName/Library
7. Eliminar o diretório UnityProjectName/Assets/Oculus
8. Eliminar o ficheiro UnityProjectName/Assets/Oculus.meta
9. Reabrir o Unity

Criar e implementar o seu projeto no Pedido

1. Ligar o Seu Pedido através de um cabo USB 3.0 -> USB C

2. Navegar para Definições de Compilação de Ficheiros >

3. Alterar a implementação para Android

4. Certifique-se de que o Pedido está selecionado como o dispositivo de execução aplicável

   

5. Selecione Compilar e Executar

   • Poderá encontrar o seguinte conjunto de erros de compilação quando selecionar Compilar e Executar pela primeira vez. Não deve impedir a implementação. Veja o problema n.º 10449 para obter mais informações e potenciais opções de mitigação.

   

6. Aceite o pedido Permitir Depuração USB a partir do Pedido

7. Ver a sua cena dentro do Pedido

Erros comuns

Pedido não reconhecido pelo Unity

Certifique-se de que os caminhos do Android estão configurados corretamente. Se continuar a deparar-se com problemas, siga este guia.

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