Table of Contents

Mega WeChat Mini Program плагин: концепция и процесс AR Session

В этом документе представлены концепция и процесс AR Session в плагине Mega для WeChat Mini Program.

Что такое AR Session

AR Session в плагине Mega для WeChat Mini Program является точкой входа для всех AR-функций. Он управляет процессом выполнения и состоянием: получение данных от VisionKit и API датчиков WeChat, объединение результатов облачного позиционирования и локального AR-трекера, управление перемещением и рендерингом камеры и других объектов в сцене.

flowchart LR
    Pose(VisionKit 相机位姿) -- 每帧同步 --> Session[Session]
    Image(计算该帧相机位姿所使用的相机图片) -. 仅 Mega 定位时发送 .-> Session
    Sensor(微信传感器数据) -. 异步 .-> Session
    Session -- Transform --> Camera(xr-frame 摄像机)

Процесс AR Session

flowchart LR
    Start((" "))
    End((" "))

    Init[Initializing]
    Run[Running]

    Check{Success?}

    Start -->|调用 start| Init
    Init --> Check

    Check -->|是| Run
    Check -->|否 / 重试次数超过上限| End

    Run -->|调用 stop| End

Запуск: состояние session переходит в Initializing. Включает проверку окружения, загрузку ресурсов и ожидание готовности AR-системы WeChat xr-frame.

Выполнение: состояние session переходит в Running. На этом этапе session выводит результаты отслеживания и обновляет Transform камеры xr-frame для каждого кадра.

Остановка: состояние session переходит в None. Включает освобождение ресурсов, сброс состояния и уничтожение MegaTracker.

Предупреждение

AR-функции можно использовать только после успешного запуска session.

Состояния AR Session:

Состояние Описание
None Начальное состояние, session не запущен или инициализация не удалась
Initializing В процессе инициализации
Running Состояние выполнения, session запущен и инициализация завершена

[Опционально] AR Session в плагине WeChat Mini Program и в Unity

Примечание

Только для разработчиков, переносящих проекты из Unity.

AR Session в плагине Mega для WeChat Mini Program является упрощенной версией AR Session в Unity. Поскольку одновременное использование других алгоритмических компонентов не поддерживается, AR Session в WeChat Mini Program использует предустановленные компоненты источников данных и алгоритмические компоненты. Пользователи не могут выбирать источники данных и/или комбинировать алгоритмические компоненты.

Кроме того, можно считать, что плагин Mega для WeChat Mini Program поддерживает только target в виде Block и использует режим центра, ориентированный на target.

Следующие шаги

Связанные темы