Migración de un proyecto de Unity 2019 a Unity 2020 + OpenXR

Para la migración más fluida, se recomienda completar todos los pasos de este artículo en el orden presentado. Esta es una introducción a los pasos principales:

1. Actualice MRTK a la versión estable más reciente.
2. Mueva el proyecto a Administración de complementos XR de Unity 2019.
3. Elija "Windows Mixed Reality".
4. Actualice a Unity 2020.3 LTS.
5. Use la herramienta de características Mixed Reality para instalar más paquetes.
6. Configure la administración de complementos XR para OpenXR.

1. Actualizar MRTK a la versión estable más reciente

Si ya usa MRTK, se recomienda que el primer paso de la migración sea ejecutar la herramienta de características de Mixed Reality y actualizar a la versión estable más reciente de MRTK.

Seleccione las características que desee.

Nota:

Las descripciones e imágenes de esta sección se basan en la versión más reciente de la herramienta. Si las instrucciones no coinciden con lo que ve, compruebe que no usa una versión anterior de la herramienta.

1. Abra la Herramienta de características de Microsoft Mixed Reality y haga clic en el botón Inicio.

   

2. Seleccione el botón Examinar (es el botón "tres puntos" de la imagen siguiente), vaya al proyecto y ábralo.

   

3. Seleccione Detectar características.

   Nota: Es posible que tenga que esperar unos segundos mientras la herramienta actualiza los paquetes de las fuentes.

4. En la página Detectar características , tenga en cuenta que hay una lista de seis grupos de paquetes.

   

5. Haga clic en el botón "+" situado a la izquierda de Mixed Reality Toolkit y, a continuación, seleccione la versión más reciente de Mixed Reality Toolkit Foundation.

Importación de las características

1. Después de realizar las selecciones, haga clic en Obtener características.
2. En la página Importar características , la columna de la izquierda, Características, muestra los paquetes que acaba de seleccionar. La columna del lado derecho, Dependencias requeridas, muestra las dependencias. Puede hacer clic en el vínculo Detalles de cualquiera de estos elementos para obtener más información sobre ellos.
3. Cuando esté listo para continuar, seleccione Importar. En la página Revisar y aprobar , puede revisar la información sobre los paquetes.
4. Seleccione Aprobar. La Herramienta de características muestra un mensaje que indica que el proyecto se ha actualizado.
5. Vuelva al Editor de Unity y haga clic en un área en blanco en la interfaz de usuario. Verá un mensaje que le indica que los paquetes se están importando.

Al realizar esta actualización mientras sigue usando Unity 2019, puede ver el Configurador de proyectos de MRTK y ver las advertencias de "API en desuso" sobre cómo ponerse al día. Las advertencias le indicarán qué cambiar. Si no realiza esta actualización de MRTK primero, es posible que la API anterior se haya ido y no tenga esas advertencias.

Obtenga más información sobre la herramienta de características de Mixed Reality.

2. Mover el proyecto a La administración de complementos XR de Unity 2019

Después de actualizar MRTK, puede indicar a Unity 2019 que use la administración de complementos XR.

1. En el editor de Unity de la barra de menús, seleccione Editar>configuración del proyecto.
2. En la columna del lado izquierdo de la ventana Configuración del proyecto , seleccione Administración de complementos XR.

En este punto, es posible que vea un botón con la etiqueta Install XR Plugin Management (Instalar administración de complementos XR ). Si es así, continúe con los pasos siguientes. Si ya tiene instalado el sistema de administración XR, puede omitir el resto de los pasos de esta sección y continuar con la siguiente sección, "Elija "Windows Mixed Reality".

1. Haga clic en el botón Instalar administración de complementos XR .

2. Aparece un cuadro de diálogo denominado Built in VR Detected (Se detectó vr integrado) y le pregunta si desea quitar el paquete vr integrado. Haga clic en Aceptar.

   

3. Aparece el cuadro de diálogo Integrado en VR Habilitado . Haga clic en Aceptar. Esto deshabilita la realidad virtual integrada.

4. Aparece la ventana Configurador de proyectos de MRTK y solicita que habilite una canalización de XR. Seleccione la segunda opción, XR SDK/SR Management.

5. En la página siguiente del configurador, haga clic en Mostrar configuración.

3. Elija "Windows Mixed Reality"

Todavía no estamos listos para instalar OpenXR, pero este siguiente conjunto de pasos le ayuda a limpiar las API que solo estaban disponibles y admitidas en la ruta de acceso "XR integrada". (Si usa MRTK, la mayor parte de esto se abstrae por usted).

1. En la ventana Configuración del proyecto de Unity Editor, asegúrese de que se encuentra en la página Administración de complementos XR.
2. Realiza una de las siguientes acciones:
   • Si tiene como destino el HoloLens 2:
     Asegúrese de que está en la pestaña Plataforma universal de Windows (es la segunda pestaña y muestra el logotipo de Windows) y, a continuación, en Proveedores de complementos, seleccione Windows Mixed Reality.
   • Si tiene como destino Desktop VR:
     Asegúrese de que está en la pestaña Escritorio (es la primera pestaña y muestra una imagen de un monitor) y, a continuación, en Proveedores de complementos, seleccione Windows Mixed Reality.
3. Vuelve a aparecer la ventana Configurador de proyectos de MRTK . Haga clic en el botón Siguiente y, a continuación, haga clic en Siguiente de nuevo. (Es posible que desee tomarse un momento para leer las explicaciones en estas páginas antes de continuar).
4. Seleccione Importar Essentials TMP.
5. Seleccione Listo. Esto cierra el configurador.
6. Cierre la ventana Configuración del proyecto, guarde el proyecto y salga de Unity.

4. Actualización a Unity 2020.3 LTS

1. Instale la versión de revisión LTS más reciente de Unity 2020.3.
2. Abra el proyecto de Unity 2019 en Unity 2020.3.

Verá un cuadro de diálogo que le preguntará si desea actualizar el proyecto a una versión más reciente de Unity. Haga clic en CONFIRMAR.

Si anteriormente usaba AR Foundation 2.0, el proyecto le llevará automáticamente a AR Foundation 4.0.

5. Use la herramienta de características Mixed Reality para instalar más paquetes.

Use la herramienta de características Mixed Reality para importar los paquetes siguientes.

1. Abra la lista desplegable Soporte técnico de la plataforma y seleccione la versión más reciente de Mixed Reality complemento OpenXR.
2. Después de cargar los paquetes, aparece un cuadro de diálogo Advertencia que le pregunta si desea reiniciar el editor de Unity para habilitar los back-end. Seleccione Sí.
3. Cuando Unity vuelve a abrirse, aparece mrtk project configurator . Dedique un momento a leer las explicaciones de la ventana y, a continuación, seleccione Aplicar.
4. Aparece un cuadro de diálogo que indica que Unity debe reiniciarse para que el sistema de entrada surta efecto. Seleccione Aplicar.

6. Configurar la administración de complementos XR para OpenXR

Después de volver a abrir Unity, puede establecer OpenXR como el entorno de ejecución:

1. En la barra de menús, seleccione Editar>configuración del proyecto.

   Busque en la columna de la izquierda y asegúrese de que está en la página Administración de complementos XR y en la pestaña Plataforma universal de Windows (hay una imagen del logotipo de Windows en la pestaña).

2. En la lista Proveedores de complementos , seleccione OpenXR.

   

3. En la misma sección, seleccione Microsoft HoloLens grupo de características.

4. Tenga en cuenta que ahora hay un triángulo de advertencia amarillo junto a OpenXR. Mantenga el cursor sobre el triángulo, lea el mensaje en el elemento emergente y, a continuación, seleccione el triángulo.

   

5. En la ventana Validación de proyectos de OpenXR , se muestran varios problemas. Seleccione el botón Corregir todo .

   

6. Un problema permanece y le indica que debe agregar al menos un perfil de interacción. Para ello, haga clic en Editar. Esto le llevará a la configuración del complemento OpenXR en la ventana Configuración del proyecto .

   

7. Seleccione el botón signo más (+) tres veces, cada vez que elija un perfil diferente:

   

   Perfil de interacción de mirada ocular

   Perfil de interacción de manos de Microsoft

   Perfil del controlador de movimiento de Microsoft

   

   Si aparece el perfil de interacción mirada ocular o cualquier otro perfil con un triángulo amarillo junto a él, seleccione el triángulo y, a continuación, en la ventana Validación del proyecto OpenXR , haga clic en el botón Corregir .

   

8. En la sección Grupos de características de OpenXR, seleccione Microsoft HoloLens y, a continuación, seleccione Seguimiento de manos y modelo de controlador de movimiento si aún no están seleccionados.

   

9. Haga clic en la lista desplegable Modo de envío de profundidad y, a continuación, seleccione Profundidad de 16 bits.

   

10. Cierre la ventana Configuración del proyecto y cualquier otra ventana que todavía esté abierta.

El proyecto ya está totalmente migrado.

Vea también

• Introducción a OpenXR
• Introducción a OpenXR
• Más información sobre OpenXR
• Especificación de OpenXR 1.0
• Referencia de la API de OpenXR 1.0
• Guía de referencia rápida de OpenXR 1.0