Concepto y flujo de AR Session en el plugin Mega WeChat Mini Program
Este documento presenta el concepto y el flujo de AR Session en el plugin Mega WeChat Mini Program.
Qué es AR Session
La AR Session proporcionada por el plugin Mega WeChat Mini Program es la entrada de todas las funciones AR. Gestiona el proceso de ejecución y el estado, incluida la obtención de datos de VisionKit y de las API de sensores proporcionadas por WeChat, la fusión de resultados de localización en la nube y del tracker AR local, y el control del movimiento y renderizado de la cámara y otros objetos de la escena.
flowchart LR
Pose(Pose de cámara de VisionKit) -- Sincronizar cada frame --> Session[Session]
Image(Imagen de cámara usada para calcular la pose de cámara de este frame) -. Enviada solo durante la localización Mega .-> Session
Sensor(Datos de sensores de WeChat) -. Asíncrono .-> Session
Session -- Transform --> Camera(cámara xr-frame)
Flujo de AR Session
flowchart LR
Start((" "))
End((" "))
Init[Initializing]
Run[Running]
Check{¿Correcto?}
Start -->|Llamar a start| Init
Init --> Check
Check -->|Sí| Run
Check -->|No / el número de reintentos supera el límite| End
Run -->|Llamar a stop| End
Inicio: el estado de session cambia a Initializing. Incluye comprobaciones del entorno, carga de recursos y espera a que el sistema AR de WeChat xr-frame esté listo.
Ejecución: el estado de session cambia a Running. En esta fase, session genera resultados de tracking en cada frame y actualiza el Transform de la cámara xr-frame.
Parada: el estado de session cambia a None. Incluye liberar recursos, restablecer el estado y destruir MegaTracker.
Advertencia
Las funciones AR solo pueden usarse después de que session se haya iniciado correctamente.
Estados de AR Session:
| Estado | Descripción |
|---|---|
| None | Estado inicial; session no se ha iniciado o la inicialización falló |
| Initializing | En proceso de inicialización |
| Running | Estado en ejecución; session se ha iniciado y la inicialización ha terminado |
[Opcional] AR Session en el plugin WeChat Mini Program y AR Session en Unity
Nota
Solo para desarrolladores que migran proyectos Unity.
La AR Session en el plugin Mega WeChat Mini Program es una versión simplificada de AR Session en Unity. Debido a que no se admite el uso simultáneo de otros componentes de algoritmo, la AR Session en WeChat Mini Program utiliza componentes de fuente de datos y componentes de algoritmo preintegrados. El usuario no puede seleccionar fuentes de datos ni ensamblar componentes de algoritmo.
Además, puede considerarse que el plugin Mega WeChat Mini Program solo admite target de tipo Block y center mode centrado en el target.