Paquetes de MRTK

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

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

Paquetes de activos

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

Algunas de las ventajas de usar paquetes de recursos incluyen:

  • Disponible para Unity 2018.4 y versiones más recientes
  • Fácil de realizar cambios en MRTK
    • MRTK está en la carpeta Assets

Algunos de los desafíos son:

  • MRTK forma parte de la carpeta Assets 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 de paquetes
  • 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 lanza y admite estos paquetes desde el código fuente de la mrtk_release en GitHub.

Paquete foundation

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

Pakage foundation Paquete de MRTK Foundation

El paquete de MRTK Foundation contiene lo siguiente.

Carpeta 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 técnico y servicios de clase base para el seguimiento a mano.
InputAnimation Compatibilidad con la grabación del movimiento de la cabeza y los datos de seguimiento de las manos.
InputSimulation Compatibilidad con la simulación en el editor de la entrada de manos y ojos.
ObjectMeshObserver Observador de reconocimiento espacial que usa un modelo 3D como datos.
UnityInput Dispositivos de entrada comunes (ratón, 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 La misión.
UnityAR (Experimental) Proveedor de configuración de cámara que permite el uso de MRTK con dispositivos ar móviles.
WindowsMixedReality Compatibilidad con Windows Mixed Reality dispositivos, incluidos Microsoft HoloLens cascos envolventes y envolventes.
Windows Compatibilidad con Microsoft Windows API específicas, por ejemplo, voz y dictado.
XR SDK (Experimental) Compatibilidad con el nuevo marco XR de Unity en Unity 2019.3 y versiones más recientes.
MRTK/SDK
Habilitación de características 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.
Profiles Perfiles predeterminados para microsoft Mixed Reality Toolkit sistemas y servicios.
StandardAssets Recursos comunes; modelos, texturas, materiales, etc.
MRTK/SceneSystemResources Recursos y recursos usados por scene System
MRTK/Services
BoundarySystem Sistema que implementa compatibilidad con límites de VR.
CameraSystem Sistema que implementa la configuración y administración de la cámara.
DiagnosticsSystem Implementación del sistema en diagnósticos de aplicaciones, por ejemplo, un profiler visual.
InputSystem Sistema que proporciona compatibilidad para acceder a la entrada del usuario y controlarla.
SceneSystem Sistema que proporciona compatibilidad con aplicaciones de varias escenas.
SpatialAwarenessSystem Sistema que proporciona compatibilidad para el reconocimiento del entorno del usuario.
TeleportSystem Sistema que proporciona compatibilidad para teleportar (moverse por la experiencia en saltos).
MRTK/StandardAssets Sombreador mrtk estándar, materiales básicos y otros recursos estándar para experiencias de realidad mixta

Paquete de 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.

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

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ú Mixed Reality Toolkit > utilidades del Editor de Unity.

Nota

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

Carpeta Componente Descripción
MRTK/Tools
BuildWindow Herramienta que ayuda a simplificar el proceso de compilació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.
OptimizeWindow 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 a inicializar 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.
ScreenshotUtility 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 descontcución y el uso de componentes de la 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 de modo de reproducción. Estas utilidades son especialmente útiles para los desarrolladores que crean componentes de MRTK.

Carpeta Componente Descripción
MRTK/Tests
TestUtilities 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 ejecutan la funcionalidad en el paquete de base. Este paquete contiene la escena HandInteractionExample (que se muestra a continuación) que contiene objetos de ejemplo que responden a varios tipos de entrada de mano (articuladas y no articuladas).

Escena HandInteractionExample

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

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

Nota

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

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

Unity Administrador de paquetes

En el caso de las experiencias que se crean con Unity 2019.4 y versiones más recientes, MRTK está disponible a través de unity Administrador de paquetes.

Algunas de las ventajas de usar paquetes de recursos incluyen:

  • Proyectos más pequeños
    • Soluciones de Visual Studio limpieza
    • Menos archivos para la comprobación (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 creación
  • Resolución de dependencias
    • Los paquetes MRTK necesarios se instalan automáticamente al especificar paquetes con dependencias
  • Actualización sencilla a las 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 quitarlos durante la resolución de paquetes
  • MRTK no admite paquetes UPM con Unity 2018.4

Paquete foundation

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

Carpeta 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 Compatibilidad con clases base y servicios para el seguimiento manual.
InputAnimation Compatibilidad con la grabación del movimiento de la cabeza y los datos de seguimiento de las manos.
InputSimulation Compatibilidad con la simulación en el editor de la entrada de manos y ojos.
ObjectMeshObserver Observador de reconocimiento espacial que usa un modelo 3D como datos.
UnityInput Dispositivos de entrada comunes (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 Leap Motion de UltraLeap.
OpenVR Compatibilidad con dispositivos OpenVR.
Oculus Compatibilidad con dispositivos Oculus, como La Misión.
UnityAR (Experimental) Proveedor de configuración de cámara que permite el uso de MRTK con dispositivos ar móviles.
WindowsMixedReality Compatibilidad con Windows Mixed Reality dispositivos, incluidos Microsoft HoloLens y cascos envolventes.
Windows Compatibilidad con Microsoft Windows API específicas, por ejemplo, voz y dictado.
XR SDK (Experimental) Compatibilidad con el nuevo marco XR de Unity en Unity 2019.3 y versiones más recientes.
MRTK/SDK
Habilitación de características Características experimentales, incluidos sombreadores, controles de interfaz de usuario y administradores del sistema individuales.
Características Funcionalidad que se basa en el paquete de Foundation.
Profiles Perfiles predeterminados para los sistemas y servicios Mixed Reality Toolkit Microsoft.
StandardAssets Recursos comunes; modelos, texturas, materiales, etc.
MRTK/Services
BoundarySystem Sistema que implementa compatibilidad con límites vr.
CameraSystem Sistema que implementa la configuración y administración de la cámara.
DiagnosticsSystem Implementación del sistema en diagnósticos de aplicaciones, por ejemplo, un profiler visual.
InputSystem Sistema que proporciona compatibilidad para acceder a la entrada del usuario y controlarla.
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 compatibilidad para la teleportación (moverse por la experiencia en saltos).

Dependencias:

  • Recursos estándar ( com.microsoft.mixedreality.toolkit.standardassets )

Recursos estándar

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

  • Sombreador estándar de MRTK
  • Materiales básicos que usan el sombreador ESTÁNDAR DE 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 estándar de MRTK no se incluyen en el paquete de recursos estándar. Estos scripts se pueden encontrar en el paquete foundation 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.

Carpeta Componente Descripción
MRTK/Extensions
HandPhysicsService Servicio que agrega compatibilidad física a las 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 fluidas.
Ejemplos~ Una carpeta oculta (en el Editor de Unity) que contiene los recursos y escenas 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 y Unity Administrador de paquetes.

Dependencias:

  • Foundation ( 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 incluye como parte de una aplicación.

Carpeta Componente Descripción
MRTK/Tools
BuildWindow Herramienta que ayuda a simplificar el proceso de compilació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.
OptimizeWindow 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 a inicializar 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.
ScreenshotUtility 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 detción y el uso de componentes de la experiencia de usuario de MRTK.

Dependencias:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

Paquete de utilidades de prueba

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

Carpeta Componente Descripción
MRTK/Tests
TestUtilities Métodos para simplificar la creación de pruebas en modo de reproducción, incluidas las utilidades de simulación a mano.

Dependencias:

  • Foundation ( 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 y Unity Administrador de paquetes.

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

Dependencias:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )
  • Extensiones (com.microsoft.mixedreality.toolkit.extensions)

Consulte también