Asistente para subsistemas: MRTK3

Bienvenido al Asistente para subsistemas del kit de herramientas de Mixed Reality. Esta herramienta se usa para ampliar la funcionalidad de MRTK3 a través de un subsistema XR de Unity personalizado. En este documento se describe el Asistente para subsistemas, su interfaz de usuario y cómo agregar la característica personalizada a MRTK3.

Nota:

Como regla general, se recomienda usar subsistemas para implementar abstracciones de plataforma o proveedor.

Para usar el Asistente para subsistemas, primero debe importar el paquete Herramientas de MRTK3 mediante la herramienta de características Mixed Reality.

Introducción

Para empezar a crear un nuevo subsistema, seleccione el Subsystem Wizard elemento en el menúUtilidadesde MRTK3>.

Una vez iniciado, el Asistente para subsistemas le pedirá información; es decir, el nombre de la organización, el nombre base del subsistema y si el subsistema requiere datos de configuración.

Nombre de la organización

De forma predeterminada, el Asistente para subsistemas leerá la configuración del Reproductor de Unity y garantizará que el nombre de la organización coincida con el nombre de la empresa del proyecto. Este valor se puede sobrescribir para que sea cualquier identificador de C# válido.

Nombre de clase base

Todos los subsistemas se generarán con una clase base. Esta estructura es necesaria para la arquitectura actual y facilita la implementación de versiones específicas de plataforma o proveedor de un subsistema. Se recomienda usar el nombre del subsistema (por ejemplo, "ScentSubsystem") para el nombre de clase base.

Adición de una configuración de subsistema

Si el subsistema se va a configurar, seleccione el Add subsystem configuration cuadro .

Nombres generados

El asistente crea automáticamente los nombres de elementos específicos. Estos nombres se pueden invalidar una vez completado el asistente, mediante el editor de texto que prefiera.

Preparación para generar

Omitir la clase del subsistema de generación de archivos

Aunque a menudo no se recomienda omitir la generación de uno o varios archivos de subsistema, hay algunos escenarios en los que puede ser útil (por ejemplo, desea volver a generar un único archivo).

Nota:

El Asistente para subsistemas no sobrescribirá los archivos existentes. Para volver a generar un archivo, primero debe eliminarse.

Use la Skip opción situada junto a los archivos deseados para indicar al asistente que suprima la generación.

Finalización del subsistema

Una vez completado, el Asistente para subsistemas mostrará el conjunto de pasos necesarios para completar la implementación del subsistema. El conjunto de pasos enumerados puede variar en función de la configuración del asistente.

Agregar el código

El código generado contiene indicaciones de dónde se debe agregar el código necesario (y opcional). Estos indicadores tienen la forma de un comentario que comienza con la palabra TODO y contiene una descripción del código que se va a agregar. Por ejemplo:

// TODO: Apply the configuration to the provider.

Habilitación del subsistema

Una vez que el subsistema esté listo, puede habilitarlo en el perfil MRTK3 visitando Editar>configuración del> proyectoMRTK3.