Usar la herramienta de validación de sesión

Este artículo describe cómo usar la herramienta de validación de sesión para validar rápidamente el flujo de trabajo de sesión en el editor y realizar simulaciones usando archivos EIF.

Antes de comenzar

La simulación utiliza archivos EIF como entrada, por lo que antes de comenzar, es necesario grabar un archivo EIF:

• Consulta Grabar archivo EIF para grabar un archivo EIF

También es necesario comprender:

• Los conceptos básicos de Grabar archivo EIF y usarlo para simulación
• Los conceptos básicos, componentes y flujo de trabajo de Sesión AR

Herramienta de validación de sesión

La herramienta de validación de sesión ayuda a los desarrolladores a validar rápidamente el flujo de trabajo de sesión en el editor de Unity y realizar simulaciones usando archivos EIF.

Por defecto, la herramienta de validación de sesión se puede ver en la ventana Inspector del objeto AR Session (EasyAR), ya que es parte del editor DiagnosticsController:

Haz clic en el botón ↗ en la esquina superior derecha de la herramienta para abrirla como una ventana independiente, lo que facilita su visualización y operación. Cuando la ventana se cierre o se presione el botón ↘, la herramienta volverá a mostrarse en la ventana Inspector.

El efecto durante el funcionamiento de la herramienta se muestra en el siguiente video:

Este video muestra el efecto de uso de la herramienta de validación de sesión, grabado en el modo de reproducción de Unity. La mitad superior del video muestra a la izquierda la vista Hierarchy, en el medio la vista Scene y a la derecha la vista Game. La mitad inferior del video muestra la herramienta de validación de sesión. El contenido de la vista Game es el mismo que el que vería un usuario en el mundo real con su teléfono.

En la parte superior izquierda de la herramienta se muestra la barra de progreso de la reproducción EIF, que cambia a medida que avanza la reproducción. En la parte inferior izquierda de la herramienta se muestra el estado actual de la sesión. En el lado derecho de la herramienta se muestran los componentes de la sesión y los modos de centro disponibles.

En la escena, se pueden ver tres funciones AR funcionando simultáneamente:

• Seguimiento de movimiento: proporcionado por el reproductor de frames, la esfera azul es el XR Origin y el cono azul representa la posición del usuario.
• Mapeo espacial denso: se puede ver cómo, a medida que se mueve la perspectiva, se generan continuamente mallas de modelos semitransparentes.
• Seguimiento espacial disperso: en el video se está siguiendo un árbol de Navidad, y los objetos virtuales superpuestos son una nube de puntos azul claro.

Iniciar la herramienta

Haz clic en el botón ▶ en la parte superior de la herramienta para iniciarla. Presionar este botón tiene el mismo efecto que presionar directamente el botón ▶ en la Barra de herramientas de Unity.

Si la herramienta ya está iniciada, el botón cambiará a ■ y al hacer clic se detendrá la herramienta.

Cuando la herramienta se muestra como una ventana independiente, el cuadro de selección a la derecha del botón ▶ permite seleccionar el objeto de sesión que usará la herramienta. Si la ventana se restablece y se pierde la sesión, se puede volver a seleccionar desde aquí.

Controlar la reproducción EIF

Para usar la función de reproducción EIF de la herramienta, es necesario marcar la opción Frame Player de la herramienta antes de ejecutar. En este caso, la herramienta gestionará la selección de la fuente de frames durante el proceso de ensamblaje de la sesión. Independientemente del valor establecido en AssembleOptions.FrameSource, se habilitará el componente del reproductor de frames.

Por lo tanto, durante la ejecución aparecerá una ventana emergente que indica que la fuente de frames utilizada por la sesión actual está siendo gestionada por la herramienta:

Nota

La herramienta solo gestionará la selección de la fuente de frames durante el proceso de ensamblaje en el editor de Unity; esta opción no tiene ningún efecto cuando la aplicación se ejecuta en un paquete compilado.

Durante el funcionamiento normal, la función de control de reproducción EIF se mostrará en la parte superior de la herramienta, en el área marcada en la imagen:

Puedes usar estos botones para controlar la reproducción del archivo EIF:

• ▶: Reproducir, reanudar la reproducción desde un estado pausado o detenido
• ▮▮: Pausar
• ■: Detener
• ▮◀: Saltar 5 segundos atrás (cuando el archivo lo admita)
• ◀◀: Reducir la velocidad de reproducción (cuando el archivo lo admita)
• ▶▶: Aumentar la velocidad de reproducción (cuando el archivo lo admita)
• ▶▮: Saltar 5 segundos adelante (cuando el archivo lo admita)
• ▲: Abrir archivo
• Barra de progreso: Haz clic para saltar a una posición de reproducción (cuando el archivo lo admita)

Puedes ajustar y optimizar el contenido y la lógica de interacción en la escena mientras se reproduce, lo que permite realizar la mayor parte del trabajo de desarrollo en la computadora y ver los efectos de manera intuitiva.

Nota

Al reproducir nuevos datos o saltar a una posición diferente, los datos originales en la escena no se borrarán. El estado de los componentes AR tampoco se restablecerá; se comportarán como si los datos de la cámara saltaran repentinamente del frame anterior a los nuevos datos.

Aunque esto no afecta significativamente a algunas funciones, para aquellas que dependen del seguimiento de movimiento (como el mapeo espacial denso, Mega, etc.), puede provocar un estado anormal de la función y afectar el efecto de ejecución.

Controlar el flujo de trabajo de la sesión

Para usar la función de control del flujo de trabajo de la sesión de la herramienta, es necesario marcar la opción Session Workflow de la herramienta antes de ejecutar. Esta opción está marcada por defecto.

Durante el funcionamiento normal, el control del flujo de trabajo de la sesión se mostrará debajo del control de reproducción de la herramienta, en el área marcada en la imagen:

En la parte superior de esta área, se muestran dos estados: EasyARController.IsReady y ARSession.State.

En la parte inferior de esta área, se proporcionan estos botones para controlar el flujo de trabajo de la sesión:

• Initialize: Inicializar la sesión, se puede elegir usar la clave de licencia configurada en Project Settings o ingresarla manualmente
• Assemble: Ensamblar pero no iniciar la sesión
• StartSession (Assembled): Iniciar la sesión ya ensamblada
• StartSession: Ensamblar e iniciar la sesión
• StopSession: Detener la sesión
• StopSession (keep image): Detener la sesión, pero conservar el fondo de imagen
• Deinitialize: Desinicializar la sesión

Nota

Dado que estas funciones de control llaman directamente a los métodos relevantes de ARSession y EasyARController, se pueden usar estos botones para verificar el impacto de los cambios de estado de la sesión en el contenido. Sin embargo, también es importante tener en cuenta que si se llaman métodos similares en los scripts de la aplicación, el flujo de ejecución de la aplicación puede desviarse de lo