Agregar un grupo de fuentes de fotogramas
Una sesión de AR puede contener múltiples componentes de fuente de fotogramas, denominados grupo de fuentes de fotogramas (frame source group). En tiempo de ejecución, la sesión seleccionará la fuente de fotogramas más adecuada del grupo según el dispositivo actual y las funciones de AR habilitadas. Este artículo describe cómo usar y administrar grupos de fuentes de fotogramas.
Antes de comenzar
- Comprender los conceptos básicos, tipos y métodos de selección en tiempo de ejecución de las fuentes de fotogramas.
Usar el grupo de fuentes de fotogramas de una sesión de AR predefinida
Una sesión creada con la configuración predeterminada incluye un grupo de fuentes de fotogramas, que generalmente es suficiente cuando se usa una única función de AR.
Diferentes sesiones predefinidas contienen diferentes fuentes de fotogramas.
Al usar la predefinición ARSessionFactory.ARSessionPreset.ImageTracking o el menú
AR Session (Image Tracking Preset), la sesión creada tiene solo una fuente de fotogramas:
Al usar la predefinición ARSessionFactory.ARSessionPreset.MegaBlock_MotionTracking_Inertial o el menú
AR Session (Mega Block Default Preset), la sesión creada contiene múltiples fuentes de fotogramas en la jerarquía de escena:
Si la escena inicialmente usa una predefinición para crear la sesión, y durante la iteración se agregan otras funciones, no solo se deben agregar los componentes de filtro de fotogramas correspondientes, sino también, según sea necesario, los componentes de fuente de fotogramas adecuados.
Importante
Después de actualizar desde la versión 4.7 o inferior, es necesario eliminar completamente la sesión y volver a crearla mediante el menú o ARSessionFactory para poder usar el grupo de fuentes de fotogramas predefinido.
A continuación se enumeran los componentes de fuente de datos de fotogramas predeterminados para todas las configuraciones preestablecidas de funciones AR. Tenga en cuenta que el orden en la lista coincide con el orden de los componentes de fuente de datos de fotogramas en la escena:
| Preestablecido | Fuente de datos de fotogramas |
|---|---|
Nota
El orden de los componentes creados con predefiniciones garantiza que se use la fuente de fotogramas óptima en todos los dispositivos compatibles con fuentes de fotogramas integradas.
Usar la configuración predeterminada de fuente de fotogramas
Con los parámetros predeterminados, la configuración de la fuente de fotogramas se ajusta automáticamente según el dispositivo y las funciones de AR habilitadas en tiempo de ejecución.
Si se modifican manualmente los parámetros de la fuente de fotogramas, cuando cambian las funciones de AR en la sesión (por ejemplo, al agregar funciones de seguimiento de movimiento a una sesión que originalmente solo contenía seguimiento de imágenes), puede ser necesario ajustar manualmente los parámetros de la fuente de fotogramas para adaptarse a los nuevos requisitos funcionales, de modo que todas las funciones de AR puedan ejecutarse con el mejor rendimiento.
Importante
Después de actualizar desde la versión 4.7 o inferior, es necesario eliminar completamente la sesión y volver a crearla mediante el menú o ARSessionFactory para poder usar los parámetros predeterminados correctos.
Agregar un grupo de fuentes de fotogramas
En la vista Hierarchy, seleccione AR Session (EasyAR), haga clic derecho y use el menú EasyAR Sense > [ Función de AR ] > Frame Source : * para agregar un componente de fuente de fotogramas adecuado para esa función. También puede usar el menú EasyAR Sense > Frame Source by Transform Type > * Dof > Frame Source : * para agregar el componente de fuente de fotogramas necesario.
En scripts, puede usar ARSessionFactory.AddFrameSource<Source>(GameObject, bool) para agregar un componente de fuente de fotogramas.
Por ejemplo, mediante el menú EasyAR Sense > Frame Source by Transform Type > 3 Dof Rot-Only > Frame Source : Three Dof Camera Device se puede agregar un ThreeDofCameraDeviceFrameSource a la sesión actualmente seleccionada.
El código de script correspondiente es:
ARSessionFactory.AddFrameSource<ThreeDofCameraDeviceFrameSource>(session);
Ordenar fuentes de fotogramas
Durante el ensamblaje de la sesión, solo se seleccionará una fuente de fotogramas del grupo para integrarse en la sesión. La regla de selección depende del valor de la propiedad AssembleOptions.FrameSourceSelection. Con la configuración predeterminada, se puede influir en la fuente de fotogramas final seleccionada ajustando el orden de los componentes en el grupo de fuentes de fotogramas.
Generalmente, se puede usar el método de ordenar objetos en la escena en la vista Hierarchy moviendo directamente los objetos de fuente de fotogramas para ordenarlos.
En scripts, se puede usar Transform.SetSiblingIndex(int) para ajustar el orden de los objetos.
Por ejemplo, para colocar MotionTrackerFrameSource antes que otras fuentes de fotogramas, seleccione el objeto Motion Tracker en la vista Hierarchy y arrástrelo a la posición superior.
El mismo efecto se puede lograr con el siguiente código de script:
motionTrackerFrameSource.transform.SetSiblingIndex(0);
También hay algunos métodos de ordenación predefinidos disponibles. En la vista Hierarchy, seleccione AR Session (EasyAR), haga clic derecho y use el menú EasyAR Sense > Utility > Sort Frame Source : * > * para ordenar componentes específicos de fuentes de fotogramas.
En scripts, se puede usar ARSessionFactory.SortFrameSource(GameObject, ARSessionFactory.FrameSourceSortMethod) para lograr el mismo efecto.
Por ejemplo, mediante el menú EasyAR Sense > Utility > Sort Frame Source : Motion Tracker > System SLAM se puede colocar MotionTrackerFrameSource antes que ARCoreFrameSource, ARCoreARFoundationFrameSource, ARKitFrameSource, ARKitARFoundationFrameSource y AREngineFrameSource.
El código de script correspondiente es:
ARSessionFactory.SortFrameSource(session, new ARSessionFactory.FrameSourceSortMethod { MotionTracker = ARSessionFactory.FrameSourceSortMethod.MotionTrackerSortMethod.PreferEasyAR });
Después de este orden, la jerarquía de la escena se convierte en:
Temas relacionados
- Aprender cómo agregar y configurar fuentes de fotogramas para dispositivos de cabeza
- Intentar obtener la fuente de fotogramas en uso durante el tiempo de ejecución