Uso de la herramienta de validación de sesión

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

Antes de comenzar

La simulación usa archivos EIF como entrada, por lo que necesitas grabar un archivo EIF antes de comenzar:

• Consulta Grabar archivo EIF para grabar un archivo EIF

También necesitas conocer:

• Conceptos básicos de Grabar archivo EIF y usarlo para simulación
• Conceptos básicos, composición y flujo de trabajo de AR Session

La herramienta de validación de sesión

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

Por defecto, puedes ver la herramienta de validación de sesión en la ventana Inspector del objeto AR Session (EasyAR), como parte del editor DiagnosticsController:

Haz clic en el botón ↗ en la esquina superior derecha de la herramienta para abrirla en una ventana independiente, facilitando la visualización y operación. Cuando se cierra la ventana o se presiona el botón ↘, la herramienta vuelve a mostrarse en la ventana Inspector.

El efecto de la herramienta en ejecución se muestra en este video:

Este video muestra el uso de la herramienta de validación de sesión, grabado en modo play de Unity. La mitad superior muestra la vista Hierarchy a la izquierda, Scene en el centro y Game a la derecha. La mitad inferior es la herramienta de validación de sesión. El contenido de la vista Game es idéntico a lo que vería un usuario en un dispositivo móvil en el mundo real.

La parte superior izquierda de la herramienta muestra la barra de progreso de reproducción de EIF, que cambia con el avance. La parte inferior izquierda muestra el estado actual de la sesión. La derecha muestra los componentes de sesión y modos de centro disponibles.

En la escena, se ven 3 funciones AR trabajando simultáneamente:

• Seguimiento de movimiento: provisto por frame player, la esfera azul es XR Origin, el cono azul representa la posición del usuario.
• Mapeo espacial denso: se generan mallas semitransparentes a medida que cambia la perspectiva.
• Seguimiento espacial disperso: se rastrea un árbol de Navidad, con objetos virtuales superpuestos (nube de puntos azul claro).

Iniciar la herramienta

Haz clic en el botón ▶ en la parte superior de la herramienta para iniciarla. Este botón tiene el mismo efecto que presionar ▶ en la barra de herramientas de Unity.

Si la herramienta ya está iniciada, el botón cambia a ■. Haz clic para detenerla.

Cuando la herramienta se muestra en ventana independiente, el cuadro de selección a la derecha de ▶ permite elegir el objeto de sesión. Si la ventana se reinicia y pierde la sesión, selecciónala nuevamente aquí.

Controlar la reproducción de EIF

Para usar la función de reproducción de EIF, marca la opción Frame Player antes de ejecutar. Esto permite que la herramienta gestione la selección de frame source durante el ensamblaje de sesión, independientemente del valor de AssembleOptions.FrameSource, activando el componente frame player.

Por lo tanto, aparecerá una notificación durante la ejecución, indicando que el frame source actual está gestionado por la herramienta:

Nota

La herramienta solo gestiona la selección de frame source en el editor de Unity. Esta opción no afecta las compilaciones finales.

Durante la ejecución normal, los controles de reproducción de EIF aparecen en la sección resaltada:

Usa estos botones para controlar la reproducción de EIF:

• ▶: Reproducir (reanuda desde pausa o detención)
• ▮▮: Pausar
• ■: Detener
• ▮◀: Retroceder 5 segundos (si el archivo lo permite)
• ◀◀: Reducir velocidad (si el archivo lo permite)
• ▶▶: Aumentar velocidad (si el archivo lo permite)
• ▶▮: Adelantar 5 segundos (si el archivo lo permite)
• ▲: Abrir archivo
• Barra de progreso: Haz clic para saltar a una posición (si el archivo lo permite)

Puedes ajustar contenido e interacciones durante la reproducción, permitiendo desarrollar en computadora y ver resultados visualmente.

Nota

Al reproducir nuevos datos o saltar posiciones, los datos existentes no se borran. Los estados de los componentes AR no se reinician, comportándose como si los datos de cámara saltaran repentinamente.

Esto puede no afectar algunas funciones, pero para funcionalidades que dependen del seguimiento de movimiento (como mapeo espacial denso o Mega), puede causar estados anómalos.

Controlar el flujo de trabajo de sesión

Para usar el control de flujo de trabajo de sesión, marca la opción Session Workflow antes de ejecutar (activada por defecto).

Durante la ejecución, los controles de flujo de trabajo aparecen debajo de los controles de reproducción:

En la parte superior de esta sección, se muestran los estados de EasyARController.IsReady y ARSession.State.

En la parte inferior, estos botones controlan el flujo de trabajo de sesión:

• Initialize: Inicializa sesión (usa clave de licencia de Project Settings o ingrésala manualmente)
• Assemble: Ensambla sesión sin iniciarla
• StartSession (Assembled): Inicia sesión ensamblada
• StartSession: Ensambla e inicia sesión
• StopSession: Detiene sesión
• StopSession (keep image): Detiene sesión manteniendo fondo de imagen
• Deinitialize: Desinicializa sesión

Nota

Estos controles llaman directamente a métodos de ARSession y EasyARController, permitiendo verificar impactos en cambios de estado. Si tu script también llama a estos métodos, el flujo podría desviarse de lo esperado.

Controlar los componentes de sesión

Para controlar componentes de sesión, marca Session Workflow (activada por defecto).

Durante la ejecución, los controles de componentes aparecen abajo o a la derecha (según ancho de ventana):

El contenido varía según la sesión. Por ejemplo, si la sesión incluye seguimiento de imágenes, mapeo espacial denso y seguimiento espacial disperso, se muestran controles para estas funciones.

Generalmente, esta área muestra todos los componentes AR disponibles y controles de activación/desactivación (enabled), incluyendo:

• AR Session: Controla activación de la sesión
• Image Renderer: Controla renderizado de imagen de cámara física
• Camera: Controla activación de cámara virtual
• Frame Source: Controla activación de frame source (solo cuando frame player está desactivado)
• Frame Filter: Controla activación de funciones AR específicas
• Frame Recorder: Controla activación de componente de grabación EIF (solo visible cuando frame player está desactivado)

También se muestran modos de centro disponibles e informe de sesión.

Nota

Los modos de centro e informe de sesión mostrados son resultados de ejecución en editor, difiriendo en dispositivos reales.

Temas relacionados

• Prueba Simular usando archivos EIF para controlar reproducción mediante scripts
• Prueba Controlar ejecución de sesión en scripts
• Prueba Acceder a componentes AR en scripts
• Prueba Obtener resultados de sesión en scripts
• Prueba Inicialización en scripts
• Prueba Obtener informe de sesión y determinar compatibilidad en scripts