Implementación en Quest: MRTK2

Se requiere un Meta Quest (1 o 2).

Configuración del proyecto para quest

1. Siga estos pasos para asegurarse de que el proyecto está listo para implementarse en Quest.
2. Asegúrese de que el modo de desarrollador está habilitado en el dispositivo. La instalación de los controladores de Oculus ADB es opcional.

Configuración de la escena

1. Cree una nueva escena de Unity o abra una escena preexistente como HandInteractionExamples.
   1. Si crea una nueva escena, agregue MRTK a la escena; para ello, vaya a Mixed Reality Toolkit>Add to Scene and Configure (Agregar a escena y configurar).

Integración con MRTK

OpenXR (SDK de XR)

La compatibilidad de MRTK con dispositivos Quest se ofrece a través de dos orígenes diferentes: el paquete de complementos OpenXR de Unity para la canalización del SDK de XR y el paquete de complementos Mixed Reality OpenXR. El proveedor de datos XRSDK de OpenXR permite el uso de ambos orígenes y debe usarse para implementar MRTK en quest.

Puede usar el complemento Mixed Reality OpenXR para implementar aplicaciones MRTK en Quest. Después de habilitar OpenXR, asegúrese de que las características necesarias estén habilitadas (probablemente "Seguimiento de manos" y "Soporte técnico de Meta Quest").

Asegúrese de que el perfil (si no usa el valor predeterminado de MRTK) está configurado con el Administrador de dispositivos OpenXR. Consulte Configuración de MRTK para la canalización del SDK de XR para obtener más información sobre cómo asegurarse de que el perfil está listo para OpenXR.

Oculus (SDK de XR)

La compatibilidad de MRTK con dispositivos Quest se ofrece a través de dos orígenes diferentes: el paquete Oculus Plugin de Unity para la canalización del SDK de XR y el paquete de Oculus Integration Unity. El proveedor de datos Oculus XRSDK permite el uso de ambos orígenes y debe usarse para implementar MRTK en Oculus Quest.

La canalización del SDK de XR de Unity permite el uso de controladores Oculus Touch y seguimiento de la cabeza con quest. Esta canalización es el estándar para desarrollar aplicaciones XR en Unity 2019.3 y versiones posteriores. Para usar esta canalización, asegúrese de usar Unity 2019.3 o una versión posterior. Esto es necesario para implementar aplicaciones MRTK en Quest.

El paquete Oculus Integration Unity permite el uso de modelos de control y seguimiento manual con Quest.

Configuración de la canalización del SDK de XR para Quest

1. Asegúrese de que el complemento Oculus XR está instalado en Ventana --> Administrador de paquetes

   

2. Asegúrese de que el proveedor de complementos de Oculus está incluido en el proyecto. Para ello, vaya a Editar --> Configuración del proyecto --> Administración de complementos XR --> Proveedores de complementos

   

Configuración del paquete de Oculus Integration Unity para habilitar el seguimiento manual

1. Descargue e importe Oculus Integration desde el Asset Store de Unity. La versión más reciente probada para funcionar es la 39.0.0. Las versiones anteriores no funcionarán debido al cambio realizado en la API de Oculus. Todas las versiones del paquete de integración de Oculus se pueden encontrar en este archivo.

2. Vaya a Mixed Reality Toolkit > Utilities > Oculus > Integrate Oculus Integration Unity Modules (Integrar módulos de Oculus Integration Unity). Al hacerlo, se actualizarán las definiciones de asmdefs con las definiciones y referencias necesarias para que funcione el código de Quest pertinente. También actualizará el archivo csc para filtrar las advertencias obsoletas generadas por los recursos de integración de Oculus. El repositorio MRTK contiene un archivo csc que convierte las advertencias en errores; esta conversión detiene el proceso de configuración de MRTK-Quest.

   

3. En la carpeta Oculus importada (debe encontrarse en Assets/Oculus), hay un objeto con script denominado OculusProjectConfig. En ese archivo de configuración, debe establecer HandTrackingSupport en "Controllers and Hands".

   

Uso del proveedor de datos del SDK de XR de Oculus

1. Configuración del perfil para usar el proveedor de datos del SDK de XR de Oculus
   • Si no tiene intención de modificar los perfiles de configuración
     • Use cualquiera de los perfiles de MRTK predeterminados, que están configurados en las canalizaciones XR de Unity. El defaultXRSDKConfigurationProfile anterior ahora está etiquetado como obsoleto.
     • Vaya a Compilación e implementación del proyecto en Quest.
   • De lo contrario, siga estos pasos:

     • Seleccione el objeto de juego MixedRealityToolkit en la jerarquía y seleccione Copiar y personalizar para clonar el perfil de realidad mixta predeterminado.

       

     • Seleccione el perfil de configuración de entrada .

       

     • Seleccione Clonar en el perfil del sistema de entrada para habilitar la modificación.

       

     • Abra la sección Proveedores de datos de entrada , seleccione Agregar proveedor de datos en la parte superior y se agregará un nuevo proveedor de datos al final de la lista. Abra el nuevo proveedor de datos y establezca Type en Microsoft.MixedReality.Toolkit.XRSDK.Oculus OculusXRSDKDeviceManager>.

       

1. El proveedor de datos del SDK de Oculus XR incluye un prefabricado de plataforma de cámara OVR que configura automáticamente el proyecto con un equipo de cámara OVR y manos OVR para enrutar correctamente la entrada. Agregar manualmente un equipo de cámara OVR a la escena requerirá una configuración manual de la configuración y la entrada.

Eliminación de la integración de Oculus del proyecto

1. Vaya a Mixed Reality Toolkit > Oculus > Separate Oculus Integration Unity Modules
2. Deje que Unity se actualice como referencias en Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef y otros archivos se modifican en este paso.
3. Cerrar Unity
4. Cierre Visual Studio, si está abierto
5. Abra Explorador de archivos y vaya a la raíz del proyecto de MRTK Unity.
6. Eliminar el directorio UnityProjectName/Library
7. Eliminar el directorio UnityProjectName/Assets/Oculus
8. Eliminar el archivo UnityProjectName/Assets/Oculus.meta
9. Volver a abrir Unity

Compilación e implementación del proyecto en Quest

1. Conecta tu Quest a través de un cable USB 3.0 -> USB C

2. Vaya a Configuración de compilación de archivos>.

3. Cambio de la implementación a Android

4. Asegúrese de que la búsqueda está seleccionada como el dispositivo de ejecución aplicable.

   

5. Seleccione Compilar y ejecutar

   • Puede encontrar el siguiente conjunto de errores de compilación al seleccionar Compilar y ejecutar la primera vez. No debe impedir la implementación. Consulte el problema 10449 para obtener más información y posibles opciones de mitigación.

   

6. Aceptar el mensaje Permitir depuración USB desde dentro de la misión

7. Ver la escena dentro de la misión

Errores frecuentes

Búsqueda no reconocida por Unity

Asegúrese de que las rutas de acceso de Android están configuradas correctamente. Si sigue teniendo problemas, siga esta guía.

Busque en Editar > preferencias Herramientas > externas > Android: