Ejercicio: Importación y configuración de recursos

  • 10 minutos

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. La herramienta 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 finalizada la descarga, abra el archivo ejecutable MixedRealityFeatureTool.exe y ú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 la siguiente imagen), navegue hasta su proyecto y ábralo.

    Open your project

    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 Descubrir características, observe que hay una lista de grupos de paquetes disponibles.

    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 Aprobar, después seleccione Salir.

  12. 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 Sí.

    Screenshot of Unity Restart Option.

  2. Unity puede pedirle que actualice los métodos en el XR InteractionLayerMask. Seleccione el botón He hecho 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 Editar>Configuración del proyecto. Seleccione Gestión del complemento XR. Asegúrese de que Inicializar XR al arrancar está seleccionado y después marque la casilla de Abrir XR en Proveedores de complementos.

    Screenshot of Initialize XR on Startup.

  4. El complemento OpenXR se carga y dos elementos aparecen en OpenXR. Marque la casilla del primero, Grupo de características de Microsoft HoloLens. Seleccione el signo de exclamación amarillo.

    Screenshot of Open XR option.

  5. Seleccione Corregir todo.

    Screenshot of Fix All.

    Algunas advertencias pueden permanecer. Ignórelas por ahora.

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

  7. En Perfiles de interacción, seleccione +, después agregue Perfil de interacción de mano de Microsoft y Perfil de interacción de mirada si aún no están agregados.

    Screenshot of Add Interaction Profiles.

  8. 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.

  9. Seleccione el signo de exclamación amarillo junto a Perfil de interacción de mirada para que vuelva a aparecer el periodo de 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 algunos problemas pueden permanecer. 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.

  10. En la ventana Configuración del proyecto, seleccione MRTK3 y compruebe si existe 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 ventana Configuración del proyecto, seleccione Reproductor.

  3. Observe que en la ventana del Reproductor, el Nombre del producto es Tutorial MRTK. Esto se toma del nombre del proyecto y será el nombre que se muestra en el menú 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, 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, navegue hasta la carpeta Paquetes>Entrada de MRTK>Recursos>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 Plataforma de XR de MRTK 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 Archivo>Guardar como.

  6. Navegue hasta la carpeta Recursos>Escenas, después asigne un nombre a su proyecto y guárdelo.