Leer en inglés

Compartir vía

Paquetes MRTK: MRTK2

  • Artículo

Mixed Reality Toolkit (MRTK) es una colección de paquetes que permiten el desarrollo de aplicaciones multiplataforma Mixed Reality proporcionando compatibilidad con hardware y plataformas Mixed Reality.

MRTK está disponible como paquetes de recursos (.unitypackage) y a través del Administrador de paquetes de Unity.

Paquetes de recursos

El recurso MRTK (.unitypackage) se puede descargar desde GitHub.

Algunas de las ventajas del uso de paquetes de recursos incluyen:

  • Disponible para Unity 2018.4 y versiones posteriores
  • Fácil de realizar cambios en MRTK
    • MRTK está en la carpeta Activos

Algunos de los desafíos son:

  • MRTK forma parte de la carpeta Activos del proyecto, lo que conduce a
    • Proyectos más grandes
    • Tiempos de compilación más lentos
  • Sin administración de dependencias
    • Los clientes deben resolver manualmente las dependencias del paquete.
  • Proceso de actualización manual
    • Varios pasos
    • Actualizaciones de control de código fuente grandes (más de 3000 archivos)
    • Riesgo de perder los cambios realizados en MRTK
  • Importar el paquete de ejemplos normalmente significa incluir todos los ejemplos

Los paquetes disponibles son:

Microsoft publica y admite estos paquetes desde el código fuente en GitHub.

Paquete foundation

Mixed Reality Toolkit Foundation es el conjunto de código que permite a la aplicación aprovechar la funcionalidad común en Mixed Reality Plataformas.

Paquete de fundación MRTK foundation de Pakage

El paquete DE MRTK Foundation contiene lo siguiente.

Folder Componente Descripción
MRTK/Core Definiciones de interfaz y tipo, clases base, sombreador estándar.
MRTK/Core/Providers Proveedores de datos independientes de la plataforma
Manos Soporte y servicios de clase base para el seguimiento manual.
InputAnimation Compatibilidad con la grabación de datos de movimiento de la cabeza y seguimiento de manos.
InputSimulation Compatibilidad con la simulación en editor de entrada de manos y ojos.
ObjectMeshObserver Observador de reconocimiento espacial mediante un modelo 3D como datos.
UnityInput Dispositivos de entrada comunes (joystick, mouse, etc.) implementados a través de la API de entrada de Unity.
MRTK/Providers Proveedores de datos específicos de la plataforma
LeapMotion Compatibilidad con el controlador UltraLeap Leap Motion.
OpenVR Compatibilidad con dispositivos OpenVR.
Oculus Compatibilidad con dispositivos Oculus, como quest.
UnityAR (Experimental) Proveedor de configuración de cámara que habilita el uso de MRTK con dispositivos de AR móviles.
WindowsMixedReality Compatibilidad con dispositivos Windows Mixed Reality, incluidos cascos envolventes y Microsoft HoloLens.
Windows Compatibilidad con API específicas de Microsoft Windows, por ejemplo, voz y dictado.
XR SDK (Experimental) Compatibilidad con el nuevo marco XR de Unity en Unity 2019.3 y versiones posteriores.
MRTK/SDK
Experimental Características experimentales, incluidos sombreadores, controles de interfaz de usuario y administradores de sistema individuales.
Características Funcionalidad que se basa en el paquete Foundation.
Perfiles Perfiles predeterminados para los sistemas y servicios de Microsoft Mixed Reality Toolkit.
StandardAssets Recursos comunes; modelos, texturas, materiales, etc.
MRTK/SceneSystemResources Recursos y recursos utilizados por el sistema de escenas
MRTK/Services
BoundarySystem Sistema que implementa compatibilidad con límites de VR.
CameraSystem Sistema que implementa la configuración y la administración de la cámara.
DiagnosticsSystem Implementación del sistema en diagnósticos de aplicaciones, por ejemplo, un generador de perfiles visuales.
InputSystem Sistema que proporciona compatibilidad con el acceso y el control de la entrada del usuario.
SceneSystem Sistema que proporciona compatibilidad con aplicaciones de varias escenas.
SpatialAwarenessSystem Sistema que proporciona compatibilidad para conocer el entorno del usuario.
TeleportSystem Sistema que proporciona soporte para el teletransporte (moverse sobre la experiencia en saltos).
MRTK/StandardAssets MRTK Standard sombreador, materiales básicos y otros recursos estándar para experiencias de realidad mixta

Paquete extensiones

El paquete opcional Microsoft.MixedRealityToolkit.Unity.Extensions incluye servicios adicionales que amplían la funcionalidad de Microsoft Mixed Reality Toolkit.

Nota

El paquete de extensiones requiere Microsoft.MixedRealityToolkit.Unity.Foundation.

Folder Componente Descripción
MRTK/Extensiones
HandPhysicsService Servicio que agrega compatibilidad física a manos articuladas.
LostTrackingService Servicio que simplifica el control de la pérdida de seguimiento en dispositivos Microsoft HoloLens.
SceneTransitionService Servicio que simplifica la adición de transiciones de escena suaves.

Paquete de herramientas

El paquete opcional Microsoft.MixedRealityToolkit.Unity.Tools incluye herramientas útiles que mejoran la experiencia de desarrollo de realidad mixta mediante Microsoft Mixed Reality Toolkit. Estas herramientas se encuentran en el menú Utilidades del kit de herramientas de Mixed Reality > en el Editor de Unity.

Nota

El paquete de herramientas requiere Microsoft.MixedRealityToolkit.Unity.Foundation.

Folder Componente Descripción
MRTK/Tools
BuildWindow Herramienta que ayuda a simplificar el proceso de creación e implementación de aplicaciones para UWP.
DependencyWindow Herramienta que crea un gráfico de dependencias de recursos en un proyecto.
ExtensionServiceCreator Asistente para ayudar a crear servicios de extensión.
MigrationWindow Herramienta que ayuda a actualizar el código que usa componentes de MRTK en desuso.
OptimizarWindow Utilidad para ayudar a automatizar la configuración de un proyecto de realidad mixta para obtener el mejor rendimiento en Unity.
ReserializeAssetsUtility Proporciona compatibilidad para volver aserializar archivos específicos de Unity.
RuntimeTools/Tools/ControllerMappingTool Utilidad que permite a los desarrolladores determinar rápidamente las asignaciones de Unity para controladores de hardware.
Captura de pantallaUtilidad Permite capturar imágenes de aplicación en el editor de Unity.
TextureCombinerWindow Utilidad para combinar texturas de gráficos.
Cuadro de herramientas Interfaz de usuario que facilita la detección y el uso de componentes de experiencia de usuario de MRTK.

Paquete de utilidades de prueba

El paquete opcional Microsoft.MixedRealityToolkit.TestUtilities es una colección de scripts auxiliares que permiten a los desarrolladores crear fácilmente pruebas en modo de reproducción. Estas utilidades son especialmente útiles para los desarrolladores que crean componentes de MRTK.

Folder Componente Descripción
MRTK/Tests
Utilidades de prueba Métodos para simplificar la creación de pruebas de modo de reproducción, incluidas las utilidades de simulación manual.

Paquete de ejemplos

El paquete de ejemplos contiene demostraciones, scripts de ejemplo y escenas de ejemplo que ejercen la funcionalidad en el paquete base. Este paquete contiene la escena HandInteractionExample (en la imagen siguiente) que contiene objetos de ejemplo que responden a varios tipos de entrada manual (articulados y no articulados).

Escena HandInteractionExample

Este paquete también contiene demostraciones de seguimiento ocular, que se documentan aquí

Por lo general, cualquier característica nueva de MRTK debe contener un ejemplo correspondiente en el paquete de ejemplos, aproximadamente siguiendo la misma estructura de carpetas y ubicación.

Nota

El paquete de ejemplos requiere Microsoft.MixedRealityToolkit.Unity.Foundation.

Folder Componente Descripción
EJEMPLOS/MRTK
Demostraciones Escenas sencillas que ilustran una o dos características relacionadas.
Experimental Escenas de demostración que ilustran características experimentales.
StandardAssets Recursos comunes compartidos por varias escenas de demostración.

Administrador de paquetes de Unity

Para las experiencias que se crean con Unity 2019.4 y versiones posteriores, MRTK está disponible a través del Administrador de paquetes de Unity.

Algunas de las ventajas del uso de paquetes de recursos incluyen:

  • Proyectos más pequeños
    • Soluciones de Visual Studio más limpias
    • Menos archivos que proteger (MRTK es una referencia simple en el Packages/manifest.json archivo)
  • Compilación más rápida
    • Unity no necesita volver a compilar MRTK durante la compilación
  • Resolución de dependencias
    • Los paquetes MRTK necesarios se instalan automáticamente al especificar paquetes con dependencias
  • Actualización sencilla a nuevas versiones de MRTK
    • Cambio de la versión en el Packages/manifest.json archivo

Algunos de los desafíos son:

  • MRTK es inmutable
    • No se pueden realizar cambios sin que se quiten durante la resolución del paquete
  • MRTK no admite paquetes UPM con Unity 2018.4

Paquete foundation

El paquete básico (com.microsoft.mixedreality.toolkit.foundation) constituye la base de Mixed Reality Toolkit.

Folder Componente Descripción
MRTK/Core Definiciones de interfaz y tipo, clases base, sombreador estándar.
MRTK/Core/Providers Proveedores de datos independientes de la plataforma
Manos Soporte y servicios de clase base para el seguimiento manual.
InputAnimation Compatibilidad con la grabación de datos de movimiento de la cabeza y seguimiento de manos.
InputSimulation Compatibilidad con la simulación en editor de entrada de manos y ojos.
ObjectMeshObserver Observador de reconocimiento espacial mediante un modelo 3D como datos.
UnityInput Dispositivos de entrada comunes (joystick, mouse, etc.) implementados a través de la API de entrada de Unity.
MRTK/Providers Proveedores de datos específicos de la plataforma
LeapMotion Compatibilidad con el controlador UltraLeap Leap Motion.
OpenVR Compatibilidad con dispositivos OpenVR.
Oculus Compatibilidad con dispositivos Oculus, como quest.
UnityAR (Experimental) Proveedor de configuración de cámara que habilita el uso de MRTK con dispositivos de AR móviles.
WindowsMixedReality Compatibilidad con dispositivos Windows Mixed Reality, incluidos cascos envolventes y Microsoft HoloLens.
Windows Compatibilidad con API específicas de Microsoft Windows, por ejemplo, voz y dictado.
XR SDK (Experimental) Compatibilidad con el nuevo marco XR de Unity en Unity 2019.3 y versiones posteriores.
MRTK/SDK
Experimental Características experimentales, incluidos sombreadores, controles de interfaz de usuario y administradores de sistema individuales.
Características Funcionalidad que se basa en el paquete Foundation.
Perfiles Perfiles predeterminados para los sistemas y servicios de Microsoft Mixed Reality Toolkit.
StandardAssets Recursos comunes; modelos, texturas, materiales, etc.
MRTK/Services
BoundarySystem Sistema que implementa compatibilidad con límites de VR.
CameraSystem Sistema que implementa la configuración y la administración de la cámara.
DiagnosticsSystem Implementación del sistema en diagnósticos de aplicaciones, por ejemplo, un generador de perfiles visuales.
InputSystem Sistema que proporciona compatibilidad con el acceso y el control de la entrada del usuario.
SceneSystem Sistema que proporciona compatibilidad con aplicaciones de varias escenas.
SpatialAwarenessSystem Sistema que proporciona compatibilidad para conocer el entorno del usuario.
TeleportSystem Sistema que proporciona soporte para el teletransporte (moverse sobre la experiencia en saltos).

Dependencias:

  • recursos de Standard (com.microsoft.mixedreality.toolkit.standardassets)

recursos de Standard

El paquete de recursos estándar (com.microsoft.mixedreality.toolkit.standardassets) es una colección de componentes que se recomiendan para todas las experiencias de realidad mixta, incluidos:

  • Sombreador de Standard MRTK
  • Materiales básicos con el sombreador de Standard MRTK
  • Archivos de audio
  • Fuentes
  • Texturas
  • Iconos

Nota

Para evitar cambios importantes basados en definiciones de ensamblado, los scripts usados para controlar algunas características del sombreador de Standard MRTK no se incluyen en el paquete de recursos estándar. Estos scripts se pueden encontrar en el paquete básico de la MRTK/Core/Utilities/StandardShader carpeta .

Dependencias: ninguna

Paquetes de extensión

El paquete de extensiones opcional (com.microsoft.mixedreality.toolkit.extensions) contiene componentes adicionales que amplían la funcionalidad de MRTK.

Folder Componente Descripción
MRTK/Extensiones
HandPhysicsService Servicio que agrega compatibilidad física a manos articuladas.
LostTrackingService Servicio que simplifica la entrega de la pérdida de seguimiento en Microsoft HoloLens dispositivos.
SceneTransitionService Servicio que simplifica la adición de transiciones de escena suaves.
Muestras~ Una carpeta oculta (en la Editor de Unity) que contiene las escenas y los recursos de ejemplo.

Puede encontrar más detalles sobre el proceso de uso de paquetes que contienen proyectos de ejemplo en el artículo Mixed Reality Toolkit and Unity Package Manager (Kit de herramientas de Mixed Reality y Administrador de paquetes de Unity).

Dependencias:

  • Fundación (com.microsoft.mixedreality.toolkit.foundation)

Paquete de herramientas

El paquete de herramientas opcional (com.microsoft.mixedreality.toolkit.tools) contiene herramientas que son útiles para crear experiencias de realidad mixta. En general, estas herramientas son componentes del editor y su código no se envía como parte de una aplicación.

Folder Componente Descripción
MRTK/Tools
BuildWindow Herramienta que ayuda a simplificar el proceso de creación e implementación de aplicaciones para UWP.
DependencyWindow Herramienta que crea un gráfico de dependencias de recursos en un proyecto.
ExtensionServiceCreator Asistente para ayudar a crear servicios de extensión.
MigrationWindow Herramienta que ayuda a actualizar el código que usa componentes de MRTK en desuso.
OptimizarWindow Utilidad para ayudar a automatizar la configuración de un proyecto de realidad mixta para obtener el mejor rendimiento en Unity.
ReserializeAssetsUtility Proporciona compatibilidad para volver aserializar archivos específicos de Unity.
RuntimeTools/Tools/ControllerMappingTool Utilidad que permite a los desarrolladores determinar rápidamente las asignaciones de Unity para controladores de hardware.
Captura de pantallaUtilidad Permite capturar imágenes de aplicación en el editor de Unity.
TextureCombinerWindow Utilidad para combinar texturas de gráficos.
Cuadro de herramientas Interfaz de usuario que facilita la detección y el uso de componentes de experiencia de usuario de MRTK.

Dependencias:

  • Fundación (com.microsoft.mixedreality.toolkit.foundation)

Paquete de utilidades de prueba

El paquete opcional de utilidades de prueba (com.microsoft.mixedreality.toolkit.testutilities) contiene una colección de scripts auxiliares que permiten a los desarrolladores crear fácilmente pruebas de modo de reproducción. Estas utilidades son especialmente útiles para los desarrolladores que crean componentes de MRTK.

Folder Componente Descripción
MRTK/Tests
Utilidades de prueba Métodos para simplificar la creación de pruebas de modo de reproducción, incluidas las utilidades de simulación manual.

Dependencias:

  • Fundación (com.microsoft.mixedreality.toolkit.foundation)

Paquete de ejemplos

El paquete de ejemplos (com.microsoft.mixedreality.toolkit.examples) está estructurado para permitir a los desarrolladores importar solo los ejemplos de interés.

Puede encontrar más detalles sobre el proceso de uso de paquetes que contienen proyectos de ejemplo en el artículo Mixed Reality Toolkit and Unity Package Manager (Kit de herramientas de Mixed Reality y Administrador de paquetes de Unity).

Folder Componente Descripción
EJEMPLOS/MRTK
Muestras~ Una carpeta oculta (en la Editor de Unity) que contiene las escenas y los recursos de ejemplo.
StandardAssets Recursos comunes compartidos por varias escenas de demostración.

Dependencias:

  • Fundación (com.microsoft.mixedreality.toolkit.foundation)
  • Extensiones (com.microsoft.mixedreality.toolkit.extensions)

Vea también