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 en el proyecto, usaremos la herramienta de características de Mixed Reality, que 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.

    Screenshot of the Mixed Reality Feature Tool opening screen.

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

    Screenshot of the Select Project screen.

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

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  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.

    Screenshot of the main groups of packages in the Mixed Reality Feature Tool.

  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.

    Screenshot of package selections in the Mixed Reality Feature Tool.

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

    Screenshot of selecting all feature of 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 .

    Screenshot of Unity Restart Option.

  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.

    Screenshot of updating methods in the 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.

    Screenshot of Initialize XR on Startup.

  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.

    Screenshot of Open XR option.

  6. Seleccione Corregir todo.

    Screenshot of Fix All.

    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.

    Screenshot of Add Interaction Profiles.

  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.

    Screenshot of MRTK profile.

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.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    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:

    Screenshot of Unity Publishing Settings with the package name box filled in.

    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.

    Screenshot of the adding MRTK XR Rig in the Inspector.

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

    Screenshot of the Mixed Reality Toolkit in the 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, aunque necesario para las simulaciones en el editor.

    Screenshot of the input simulator.

  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.