Introducción a MRTK y al SDK de XR

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

Requisitos previos

Para empezar a trabajar con el Mixed Reality Toolkit, siga los pasos proporcionados para agregar MRTK a un proyecto.

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

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

Windows Mixed Reality

Vaya a unity's Administrador de paquetes e instale el paquete Windows complemento XR, que agrega compatibilidad con Windows Mixed Reality SDK de XR. Esto también extraerá algunos paquetes de dependencia.

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

    • Administración de complementos XR
    • Windows Complemento XR
    • Asistentes de entrada heredados de XR
  2. Ve a Edit > Project Settings (Editar > Configuración del proyecto).

  3. Haga clic en la pestaña XR Plug-in Management (Administración de complementos XR) en Project Configuración ventana.

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

  5. Asegúrese de que initialize XR on Startup (Inicializar XR al iniciar) está activado.

  6. (Obligatorio para la comunicación remota en HoloLens editor; de lo contrario, opcional ) Vaya a la configuración independiente y asegúrese de que Windows Mixed Reality en Proveedores de complementos. Asegúrese también de que initialize XR on Startup (Inicializar XR al iniciar) está activado.

    Administración de complementos XR con la pestaña Independiente seleccionada

  7. (Opcional) Haga clic en 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á ahí, no es necesario crear ningún perfil.

    Administración de complementos XR con Windows pestaña seleccionada

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 canalización del SDK de XR hasta el final). 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 Unity.

OpenXR

Importante

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

  1. Siga la guía Uso del complemento OpenXR de Mixed Reality para Unity, incluidos los pasos para configurar la administración y optimización de complementos XR para instalar el complemento OpenXR en el proyecto. Asegúrese de que lo siguiente se ha instalado correctamente:
    1. Administración de complementos XR
    2. Complemento OpenXR
    3. Mixed Reality complemento OpenXR
  2. Vaya a Editar > Project Configuración.
  3. Haga clic en la pestaña XR Plug-in Management (Administración de complementos XR) en Project Configuración ventana.
  4. Asegúrese de que initialize XR on Startup (Inicializar XR al iniciar) está activado.
  5. (Opcional) Si el destino HoloLens 2, asegúrese de que está en la plataforma para UWP y seleccione Microsoft HoloLens conjunto de características.

Administración de complementos OpenXR

Nota

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

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

Nota

Para la versión inicial de MRTK y OpenXR, solo se admiten de forma nativa las HoloLens 2 y Windows Mixed Reality de movimiento. En las próximas versiones se agregará compatibilidad con hardware adicional.

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 están etiquetados como obsoletos.

Si usa OpenXR, elija "DefaultOpenXRConfigurationProfile" como perfil activo o clone para realizar personalizaciones.

Si usa otros entornos de ejecución de XR en la configuración de administración de complementos de XR, como Windows Mixed Reality u Oculus, elija "DefaultXRSDKConfigurationProfile" como perfil activo o clone para realizar personalizaciones.

Estos perfiles se establecen con los sistemas y proveedores correctos, cuando sea necesario. Consulte los documentos de perfiles para obtener más información sobre el perfil y la compatibilidad de ejemplo con el SDK de XR.

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 única de Unity 2020+, donde no existe la XR heredada.

Pestaña SDK de XR

Cámara

Agregue los siguientes proveedores de datos

Configuración de la cámara del SDK de XR

Entrada

Agregue los siguientes proveedores de datos

Complemento OpenXR Windows Complemento XR
OpenXRDeviceManager XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

Configuración de entrada de OpenXR

Windows Mixed Reality:

Configuración de entrada del SDK de XR

Límite

Agregue los siguientes proveedores de datos

Complemento OpenXR Windows Complemento XR
XRSDKBoundarySystem XRSDKBoundarySystem

Configuración de límites del SDK de XR

Reconocimiento espacial

Agregue los siguientes proveedores de datos

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

Configuración de reconocimiento espacial del SDK de XR

Asignaciones de controladores

Si usa perfiles de asignación de controladores personalizados, abra uno de ellos y ejecute el elemento de menú Mixed Reality Toolkit -> Utilities -> Update -> Controller Mapping Profiles (Perfiles de asignación de controlador de XR) para asegurarse de que se definen los nuevos tipos de controlador del SDK de XR.

Vea también