Introducción a MRTK2 y SDK de XR

El SDK de XR es la nueva canalización XR de Unity en Unity 2019.3 y versiones posteriores. En Unity 2019, proporciona una alternativa a la canalización XR existente. En Unity 2020, es la única canalización XR en Unity.

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

La canalización del SDK de XR admite actualmente tres plataformas: Windows Mixed Reality, Oculus y OpenXR. En las secciones siguientes se describen los pasos necesarios para configurar el SDK de XR para cada plataforma.

Windows Mixed Reality

Vaya al Administrador de paquetes de Unity e instale el paquete del complemento XR de Windows, que agrega compatibilidad con Windows Mixed Reality en el SDK de XR. Esto también extraerá algunos paquetes de dependencia.

1. Asegúrese de que lo siguiente se ha instalado correctamente:

   • Administración de complementos XR
   • Complemento XR de Windows
   • Asistentes de entrada heredados de XR

2. Vaya a Editar > configuración del proyecto.

3. Haga clic en la pestaña Administración de complementos XR en la ventana Configuración del proyecto.

4. Vaya a la configuración de Plataforma universal de Windows y asegúrese de que Windows Mixed Reality esté activada en Proveedores de complementos.

5. Asegúrese de que inicializar XR al iniciar está activado.

6. (Requerido para la comunicación remota de HoloLens en el editor, de lo contrario, opcional) Vaya a la configuración independiente y asegúrese de que Windows Mixed Reality está activada en Proveedores de complementos. Asegúrese también de que la opción Inicializar XR en el inicio esté activada.

   

7. (Opcional) Haga clic en la pestaña Windows Mixed Reality en Administración de complementos XR y cree un perfil de configuración personalizado para cambiar los valores predeterminados. Si la lista de configuraciones ya está allí, no es necesario crear ningún perfil.

   

Oculus

1. Siga la guía How to configure Oculus Quest in MRTK using the XR SDK pipeline guide to the end (Cómo configurar Oculus Quest en MRTK mediante la guía de canalización del SDK de XR ). En la guía se describen los pasos necesarios para configurar Unity y MRTK para usar la canalización del SDK de XR para Oculus Quest.

OpenXR

Importante

OpenXR en Unity solo se admite en Unity 2020.2 y versiones posteriores. También solo admite compilaciones de x64, ARM y ARM64.

1. Siga las instrucciones de Configuración de un nuevo proyecto de OpenXR con MRTK para agregar el complemento OpenXR al proyecto. Asegúrese de que lo siguiente se ha instalado correctamente:

   1. Administración de complementos XR
   2. Complemento OpenXR
   3. complemento Mixed Reality OpenXR

2. Vaya a Editar > configuración del proyecto.

3. Haga clic en la pestaña Administración de complementos XR en la ventana Configuración del proyecto.

4. Asegúrese de que inicializar XR al iniciar está activado.

5. (Opcional) Si tiene como destino HoloLens 2, asegúrese de que está en la plataforma de UWP y seleccione "Microsoft HoloLens grupo de características".

6. (Opcional) Si tiene como destino Quest 2, asegúrese de que está en la plataforma Android y seleccione "Seguimiento de manos" y "Soporte Meta Quest".

   

Nota

Si tiene un proyecto preexistente que usa MRTK desde UPM, asegúrese de que la siguiente línea está en el archivo link.xml ubicado en la carpeta MixedRealityToolkit.Generated.

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

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

Use cualquiera de los perfiles de MRTK predeterminados, que están configurados en las canalizaciones XR de Unity. Los valores anteriores "DefaultOpenXRConfigurationProfile" y "DefaultXRSDKConfigurationProfile" ahora se etiquetan obsoletos.

Para migrar un perfil existente al SDK de XR, se deben actualizar los siguientes servicios y proveedores de datos.

Podrá ver los nuevos proveedores de datos en la pestaña SDK de XR en Unity 2019 o en la vista principal o solo en Unity 2020+, donde XR heredado no existe.

Cámara

Agregar los siguientes proveedores de datos

Complemento OpenXR	Complemento XR de Windows
XRSDK.OpenXR.OpenXRCameraSettings	XRSDK.WindowsMixedReality.WindowsMixedRealityCameraSettings
GenericXRSDKCameraSettings	GenericXRSDKCameraSettings

Input

Agregar los siguientes proveedores de datos

Complemento OpenXR	Complemento XR de Windows
OpenXRDeviceManager	XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

Windows Mixed Reality:

Límite

Agregar los siguientes proveedores de datos

Complemento OpenXR	Complemento XR de Windows
XRSDKBoundarySystem	XRSDKBoundarySystem

Reconocimiento espacial

Agregar los siguientes proveedores de datos

Complemento OpenXR	Complemento XR de Windows
XRSDK.OpenXR.OpenXRSpatialAwarenessMeshObserver (para UWP)	XRSDK.WindowsMixedReality.WindowsMixedRealitySpatialMeshObserver (para UWP)
XRSDK.GenericXRSDKSpatialMeshObserver (para no UWP)

Asignaciones de controladores

Si usa perfiles de asignación de controladores personalizados, abra uno de ellos y ejecute el elemento de menú Kit de herramientas de Mixed Reality -> Utilidades -> Actualización -> Perfiles de asignación de controladores para asegurarse de que se definen los nuevos tipos de controlador del SDK de XR.

Vea también

• Introducción al desarrollo de AR en Unity
• Introducción al desarrollo de VR en Unity