3. Configuración de los perfiles de MRTK3. Configuring the MRTK profiles

En este tutorial, aprenderá a personalizar y configurar los perfiles de MRTK.In this tutorial, you will learn how to customize and configure the MRTK profiles.

Los perfiles de MRTK constituyen un árbol de perfiles anidados que componen la información de configuración sobre cómo se deben inicializar los sistemas y las características de MRTK.The MRTK profiles is a tree of nested profiles that make up the configuration information for how the MRTK systems and features should be initialized. El perfil de nivel superior, el perfil Configuration (Configuración), contiene perfiles anidados para cada uno de los sistemas básicos principales.The top-level profile, the Configuration Profile, contains nested profiles for each of the primary core systems. Cada perfil anidado está diseñado para configurar el comportamiento de su sistema correspondiente.Each nested profile is designed to configure the behavior of their corresponding system.

En este ejemplo concreto se muestra cómo ocultar la malla de reconocimiento espacial cambiando la configuración del observador de la malla espacial.This particular example will show you how to hide the spatial awareness mesh by changing the settings of the Spatial Mesh Observer. Puedes seguir estos mismos principios para personalizar cualquier parámetro o valor de los perfiles de MRTK.However, you may follow these same principles to customize any setting or value in the MRTK profiles.

Como lo visto al implementar el proyecto en HoloLens 2 durante el tutorial anterior, la malla Spatial Awareness es una colección de mallas que representan la geometría del entorno.As you experienced when you deployed your project to your HoloLens 2 during the previous tutorial, the Spatial Awareness mesh is a collection of meshes representing the geometry of the environment. Es una visualización útil para ver inicialmente, pero normalmente está desactivada para evitar la distracción visual y el impacto adicional en el rendimiento al tenerla activada.It's a helpful visualization to see initially but it's typically turned off to avoid the visual distraction and the additional performance hit of having it on.

ObjetivosObjectives

  • Obtener información sobre cómo personalizar y configurar los perfiles de MRTKLearn how to customize and configure MRTK profiles
  • Ocultar la malla de reconocimiento espacialHide the spatial awareness mesh

Cambio de la opción de visualización del reconocimiento espacialChanging the Spatial Awareness Display Option

Los principales pasos que se deben seguir para ocultar la malla de reconocimiento espacial son los siguientes:The main steps you will take to hide the spatial awareness mesh are:

  1. Clonar el perfil de configuración predeterminadoClone the default Configuration Profile
  2. Habilitar el sistema de reconocimiento espacial.Enable the Spatial Awareness System
  3. Clonar el perfil del sistema de reconocimiento espacial predeterminado.Clone the default Spatial Awareness System Profile
  4. Clonar el perfil del observador de la malla de reconocimiento espacial predeterminado.Clone the default Spatial Awareness Mesh Observer Profile
  5. Cambiar la visibilidad de la malla de reconocimiento espacial.Change the visibility of the spatial awareness mesh

Nota

De forma predeterminada, los perfiles de MRTK no son editables.By default, the MRTK profiles are not editable. Estas son las plantillas de perfil predeterminadas que se deben clonar para poder editarse.These are default profile templates that you have to clone before they can be edited. Hay varias capas anidadas de perfiles.There are several nested layers of profiles. Por lo tanto, es habitual clonar y editar varios perfiles al configurar uno o varios parámetros.Therefore, it is common to clone and edit several profiles when configuring one or more settings.

1. Clonar el perfil de configuración predeterminado1. Clone the default Configuration Profile

Nota

El perfil de configuración es el perfil de nivel superior.The Configuration Profile is the top-level profile. Por lo tanto, para poder editar cualquier otro perfil, antes debe clonar el perfil de configuración.Consequently, to be able to edit any other profiles, you first have to clone the Configuration Profile.

En la ventana Jerarquía, seleccione el objeto MixedRealityToolkit; después, en la ventana Inspector, cambie el valor del perfil de configuración MixedRealityToolkit a DefaultHoloLens2ConfigurationProfile:In the Hierarchy window, select the MixedRealityToolkit object, then in the Inspector window, change the MixedRealityToolkit Configuration Profile to the DefaultHoloLens2ConfigurationProfile:

Componente MixedRealityToolkit de Unity con DefaultHoloLens2ConfigurationProfile seleccionado

Con el objeto MixedRealityToolkit todavía seleccionado, en la ventana Inspector, haz clic en el botón Copy & Customize (Copiar y personalizar) para abrir la ventana Clone Profile (Clonar perfil):With the MixedRealityToolkit object still selected, in the Inspector window, click the Copy & Customize button to open the Clone Profile window:

Botón Copy & Customize (Copiar y personalizar) del componente MixedRealityToolkit de Unity

En la ventana para clonar perfil, escriba un Nombre de perfil adecuado; por ejemplo, GettingStarted_HoloLens2ConfigurationProfiley. A continuación, haga clic en el botón Clonar para crear una copia modificable de DefaultHololens2ConfigurationProfile:In the Clone Profile window, enter a suitable Profile Name, for example, GettingStarted_HoloLens2ConfigurationProfile, then click the Clone button to create an editable copy of the DefaultHololens2ConfigurationProfile:

Ventana emergente para clonar el perfil de configuración de MixedRealityToolkit de Unity

El perfil de configuración recién creado se asigna ahora como perfil de configuración de la escena:The newly created Configuration Profile is now assigned as the Configuration Profile for your scene:

Componente MixedRealityToolkit de Unity con HoloLens2ConfigurationProfile personalizado recién creado aplicado

En el menú de Unity, selecciona File > Save (Archivo > Guardar) para guardar la escena.In the Unity menu, select File > Save to save your scene.

Sugerencia

Recuerde guardar el trabajo a lo largo del tutorial.Remember to save your work throughout the tutorials.

2. Habilitar el sistema de reconocimiento espacial2. Enable the Spatial Awareness System

En la ventana Jerarquía, seleccione el objeto MixedRealityToolkit; después, en la ventana Inspector, seleccione la pestaña Spatial Awareness (Reconocimiento espacial) y, a continuación, active la casilla Enable Spatial Awareness System (Habilitar el sistema de reconocimiento espacial):In the Hierarchy window, select the MixedRealityToolkit object, then in the Inspector window, select the Spatial Awareness tab, and then check the Enable Spatial Awareness System checkbox:

Componente MixedRealityToolkit de Unity con el sistema de reconocimiento espacial habilitado

Nota

En el caso de los proyectos futuros, si la aplicación no necesita responder al entorno ni interactuar con él, se recomienda mantener el reconocimiento espacial desactivado para reducir el costo de rendimiento.For future projects, if your app doesn't need to respond to or interact with the environment, it's recommended to keep the spatial awareness turned off to reduce performance cost.

3. Clonar el perfil del sistema de reconocimiento espacial predeterminado3. Clone the default Spatial Awareness System Profile

En la pestaña Spatial Awareness (Reconocimiento espacial), haz clic en el botón Clone (Clonar) para abrir la ventana Clone Profile (Clonar perfil):In the Spatial Awareness tab, click the Clone button to open the Clone Profile window:

Componente MixedRealityToolkit de Unity con la pestaña Spatial Awareness (Reconocimiento espacial) seleccionada

En la ventana para clonar perfil, escriba un Nombre de perfil adecuado; por ejemplo, GettingStarted_MixedRealitySpatialAwarenessSystemProfile. A continuación, haga clic en el botón Clonar para crear una copia modificable de DefaultMixedRealitySpatialAwarenessSystemProfile:In the Clone Profile window, enter a suitable Profile Name, for example, GettingStarted_MixedRealitySpatialAwarenessSystemProfile, then click the Clone button to create an editable copy of the DefaultMixedRealitySpatialAwarenessSystemProfile:

Ventana emergente para clonar el perfil del sistema de reconocimiento espacial de MixedRealityToolkit de Unity

Ahora, el perfil del sistema de reconocimiento espacial recién creado se asigna automáticamente al perfil de configuración:The newly created Spatial Awareness System Profile is now automatically assigned to your Configuration Profile:

Componente MixedRealityToolkit de Unity con MixedRealitySpatialAwarenessSystemProfile personalizado recién creado aplicado

4. Clonar el perfil del observador de la malla de reconocimiento espacial predeterminado4. Clone the default Spatial Awareness Mesh Observer Profile

Con la pestaña Spatial Awareness (Reconocimiento espacial) aún seleccionada, expande la sección Windows Mixed Reality Spatial Mesh Observer (Observador de malla espacial de Windows Mixed Reality) y, a continuación, haz clic en el botón Clone (Clonar) para abrir la ventana Clone Profile (Clonar perfil):With the Spatial Awareness tab still selected, expand the Windows Mixed Reality Spatial Mesh Observer section, then click the Clone button to open the Clone Profile window:

Componente MixedRealityToolkit de Unity con la sección Windows Mixed Reality Spatial Mesh Observer (Observador de malla espacial de Windows Mixed Reality) expandida

En la ventana para clonar perfil, escriba un Nombre de perfil adecuado; por ejemplo, GettingStarted_MixedRealitySpatialAwarenessMeshObserverProfile. A continuación, haga clic en el botón Clonar para crear una copia modificable de DefaultMixedRealitySpatialAwarenessMeshObserverProfile:In the Clone Profile window, enter a suitable Profile Name, for example, GettingStarted_MixedRealitySpatialAwarenessMeshObserverProfile, then click the Clone button to create an editable copy of the DefaultMixedRealitySpatialAwarenessMeshObserverProfile:

Ventana emergente para clonar el perfil del observador de la malla espacial de MixedRealityToolkit de Unity

Ahora, el perfil del observador de malla de reconocimiento espacial recién creado se asigna automáticamente al perfil del sistema de reconocimiento espacial:The newly created Spatial Awareness Mesh Observer Profile is now automatically assigned to your Spatial Awareness System Profile:

Componente MixedRealityToolkit de Unity con MixedRealitySpatialAwarenessMeshObserverProfile personalizado recién creado aplicado

5. Cambiar la visibilidad de la malla de reconocimiento espacial5. Change the visibility of the spatial awareness mesh

En Spatial Mesh Observer Settings (Configuración del observador de malla espacial), cambie Opción de visualización a Oclusión para que la malla de asignación espacial sea invisible y funcional a la vez:In the Spatial Mesh Observer Settings, change the Display Option to Occlusion to make the spatial mapping mesh invisible while still functional:

Componente de MixedRealityToolkit de Unity con Display Option (Opción de visualización) de Spatial Mesh Observer (Observador de malla espacial) establecida en Occlusion (Oclusión)

Nota

Aunque la malla de asignación espacial no está visible, sigue existiendo y es funcional.Although the spatial mapping mesh is not visible, it is still present and functional. Por ejemplo, los hologramas situados detrás de la malla de asignación espacial, como un holograma detrás de un muro físico, no estarán visibles.For example, any holograms behind the spatial mapping mesh, such as a hologram behind a physical wall, will not be visible.

Acabas de aprender a modificar una configuración en el perfil de MRTK.You just learned how to modify a setting in the MRTK profile. Como puede ver, para personalizar la configuración de MRTK, debe crear copias de los perfiles predeterminados.As you can see, to customize the MRTK settings, you first need to create copies of the default profiles. Dado que los perfiles predeterminados no son editables, siempre los tendrá como referencias si quiere revertir a la configuración predeterminada.Because the default profiles are not editable, you will always have them as references if you want to revert to the default settings. Para obtener más información sobre los perfiles de MRTK y su arquitectura, puede consultar la guía de configuración de perfiles de MRTK en el portal de documentación de MRTK.To learn more about MRTK profiles and their architecture, you can refer to the MRTK profile configuration guide in the MRTK Documentation Portal.

EnhorabuenaCongratulations

En este tutorial, aprendió a clonar, personalizar y configurar los perfiles de MRTK y sus opciones.In this tutorial, you learned how to clone, customize, and configure MRTK profiles and settings.