Ejercicio: Importación y configuración de recursos

Completado

Instalar la herramienta de características de Mixed Reality

Para importar el Kit de herramientas de Mixed Reality a su proyecto, usará la Herramienta de características de Mixed Reality. Mixed Reality Feature Tool permite a los desarrolladores detectar, actualizar e importar paquetes de características. Puede buscar paquetes por nombre o categoría, consultar sus dependencias e incluso ver los cambios propuestos en el archivo de manifiesto de sus proyectos antes de realizar la importación.

  1. Descargue la última versión de la herramienta de características de Mixed Reality del Centro de descargas de Microsoft.

  2. Una vez que finalice la descarga, abra el archivo MixedRealityFeatureTool.exe y a continuación, úselo para iniciar la herramienta de características de Mixed Reality.

    Nota:

    Para poder ejecutar la herramienta de características de Mixed Reality, podría necesitar instalar el runtime de .NET 6.0.

Importación del paquete base de MRTK Unity

  1. Seleccione Start (Iniciar) para iniciar la herramienta de características de Mixed Reality.

    Captura de pantalla de la ventana de inicio de la herramienta de características de Mixed Reality.

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

    Captura de pantalla de la pantalla Seleccionar proyecto.

    Después de seleccionar una carpeta, la herramienta comprueba que se trata de una carpeta de proyecto de Unity válida.

    Captura de pantalla de la ventana de la ruta del proyecto de la herramienta de características de Mixed Reality.

  3. Seleccione Discover Features (Descubrir 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 Discover Features (Descubrir características), observe que hay una lista de grupos de paquetes disponibles.

    Captura de pantalla de los grupos principales de paquetes en la herramienta de características de Mixed Reality.

  5. Seleccione el botón + situado a la izquierda de Compatibilidad con la plataforma (0 de 5) y seleccione la versión más reciente de Plugin OpenXR de Mixed Reality.

    Captura de pantalla de las selecciones de paquete en la herramienta de características de Mixed Reality.

  6. Seleccione el botón Seleccionar todo situado a la derecha de MRTK3 para que se seleccionen todas las características.

    Captura de pantalla de selección de todas las funciones de MRTK3.

    Nota:

    Si ve paquetes marcados como en desuso, debería quitarlos y asegurarse de que Configuración > Características > Mostrar paquetes en desuso esté deseleccionado.

  7. Después de realizar las selecciones, seleccione Obtener características.

  8. Seleccione Validate (Validar) para validar los paquetes seleccionados. Debería ver un cuadro de diálogo que indica No validation issues were detected (No se detectaron problemas de validación). Al hacerlo, seleccione Aceptar.

  9. En la página Importar características, la columna del lado izquierdo, Características, muestra los paquetes que seleccionó. La columna del lado derecho, Required dependencies (Dependencias necesarias), muestra todas las dependencias. Puede seleccionar el vínculo Detalles de cualquiera de estos elementos para obtener más información sobre ellos.

  10. Cuando esté listo para seguir adelante, seleccione Import (Importar). En la página Review and Approve (Revisar y aprobar), puede revisar información sobre los paquetes.

  11. Seleccione Approve (Aprobar).

  12. Seleccione Salir.

  13. Vuelva al editor de Unity y seleccione un área en blanco de la interfaz de usuario. Verá una barra de progreso que muestra que los paquetes se están importando.

Configuración del proyecto de Unity

  1. Después de que Unity haya importado los paquetes, aparece una advertencia que le pregunta si desea habilitar los back-end reiniciando el editor. Seleccione .

    Captura de pantalla de la opción de reinicio de Unity.

  2. Unity le preguntará sobre cómo actualizar métodos en XR InteractionLayerMask, seleccione el botón He realizado una copia de seguridad, ¡adelante! y espere a que Unity se reinicie.

    Captura de pantalla de los métodos de actualización en XR InteractionLayerMask.

  3. En la barra de menús, seleccione Mixed Reality>Proyecto>Aplicar la configuración de proyectos recomendada para HoloLens.

  4. En la barra de menús, seleccione Editar>Configuración del proyecto.... Seleccione Administración de complementos XR. Asegúrese de que Inicializar XR al iniciar está seleccionado y, después, en Proveedores de complementos, haga clic en Abrir XR.

    Captura de pantalla de Inicializar XR al iniciar.

  5. Se carga el complemento OpenXR y, a continuación, aparecen dos elementos debajo de OpenXR. Seleccione el primero, Microsoft HoloLens feature group (Grupo de características de Microsoft HoloLens). Seleccione la marca de exclamación amarilla.

    Captura de pantalla de la opción Open XR.

  6. Seleccione Corregir todo.

    Captura de pantalla de Corregir todo.

    Pueden quedar algunas advertencias. Ignórelas por ahora.

  7. Seleccione OpenXR en Administración de complementos XR.

  8. En Perfiles de interacción, agregue Interacción manual de Microsoft y Perfil de interacción con los ojos si no se ha agregado.

    Captura de pantalla de Agregar perfiles de interacción.

  9. Asegúrese de que Microsoft Hololens, a la izquierda, esté seleccionado y Seguimiento de manos, Características de Mixed Reality y Modelo de controlador de movimiento, a la derecha, estén seleccionados.

  10. Seleccione el signo de advertencia situado junto a Perfil de interacción con la mirada para traer de vuelta la ventana Validación del proyecto. Asegúrese de estar en la pestaña Plataforma para UWP (la pestaña muestra el logotipo de Windows) y, después, seleccione Corregir todo para resolver los problemas de validación. Tenga en cuenta que podría haber problemas remanentes después de seleccionar Corregir todo. En ese caso, seleccione Corregir todo de nuevo, omita los problemas marcados como Específicos de la escena y, a continuación, lea las recomendaciones para los problemas restantes (si los hay) y realice los cambios que desee.

  11. En Configuración del proyecto, seleccione MRTK3 y compruebe si hay un perfil válido. Si no hubiera ninguno, busque MRTKProfile en los Paquetes del proyecto (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) y asígnelo al perfil.

    Captura de pantalla del perfil MRTK.

Configuración de las opciones del proyecto

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

  2. En la columna de la izquierda de la ventana Project Settings (Configuración del proyecto), seleccione Player (Reproductor).

  3. Observe que en la ventana Player (Reproductor), Product Name (Nombre del producto) es "MRTK Tutorial" (Tutorial de MRTK). Se toma del nombre de su proyecto y será el nombre que aparezca en el menú de inicio de HoloLens.

    Captura de pantalla de la Configuración de publicación de Unity con la casilla Nombre de proyecto rellenada.

    Sugerencia

    Para facilitar la búsqueda de la aplicación durante el desarrollo, agregue un carácter de subrayado delante del nombre para que aparezca en la parte superior de cualquier lista.

  4. Seleccione el menú desplegable Configuración de la publicación y, a continuación, en el campo Nombre del paquete, escriba un nombre adecuado como, por ejemplo, MRTK-Tutoriales-Inicio:

    Captura de pantalla de la Configuración de publicación de Unity con la casilla de nombre del paquete rellenada.

    Nota

    El nombre del paquete es el identificador único de la aplicación. Si desea evitar sobrescribir las versiones instaladas previamente de la aplicación con el mismo nombre, debe cambiar este identificador antes de implementar la aplicación.

  5. Cierre la ventana Configuración del proyecto.

Creación de la escena y configuración de MRTK

  1. En la barra de menús, haga clic en File (Archivo)>New Scene (Nueva escena). Seleccione la opción Básico (integrado) y, a continuación, Crear.

  2. En la ventana Proyecto, vaya a la carpeta Paquetes>Entrada de MRTK>Activos>Objetos prefabricados. Arrastre el objeto prefabricado MRTK XR Rig a la escena Jerarquía.

    Captura de pantalla de la adición de MRTK XR Rig en el Inspector.

  3. Quite el objeto de juego Cámara principal, puesto que el objeto de juego MRTK XR Rig ya contiene una cámara.

    Captura de pantalla del kit de herramientas de Mixed Reality en Inspector.

  4. Agregue el objeto prefabricado Simulador de entrada MRTK (Paquetes>Entrada MRTK>Simulación>Objetos prefabricados) a la escena.

    Nota:

    Este paso es opcional, pero es necesario para simulaciones en el editor.

    Captura de pantalla del simulador de entrada.

  5. En la barra de menús, seleccione File (Archivo)>Save As... (Guardar como...).

  6. Vaya a la carpeta Assets (Recursos)>Scenes (Escenas), asigne un nombre al proyecto y guarde el proyecto.