Mega WeChat Mini Program 플러그인의 AR Session 개념과 흐름
이 문서는 Mega WeChat Mini Program 플러그인의 AR Session 개념과 흐름을 소개합니다.
AR Session이란
Mega WeChat Mini Program 플러그인이 제공하는 AR Session은 모든 AR 기능의 진입점입니다. VisionKit 및 WeChat이 제공하는 센서 API에서 데이터 가져오기, 클라우드 localization과 로컬 AR tracker 결과 융합, scene에서 카메라와 기타 오브젝트의 이동 및 렌더링 구동 등을 포함하여 실행 과정과 상태를 관리합니다.
flowchart LR
Pose(VisionKit 카메라 pose) -- 매 frame 동기화 --> Session[Session]
Image(이 frame의 카메라 pose 계산에 사용된 카메라 이미지) -. Mega localization 시에만 전송 .-> Session
Sensor(WeChat 센서 데이터) -. 비동기 .-> Session
Session -- Transform --> Camera(xr-frame 카메라)
AR Session 흐름
flowchart LR
Start((" "))
End((" "))
Init[Initializing]
Run[Running]
Check{성공?}
Start -->|start 호출| Init
Init --> Check
Check -->|예| Run
Check -->|아니요 / retry 횟수 상한 초과| End
Run -->|stop 호출| End
시작: session 상태가 Initializing으로 전환됩니다. 환경 검사, 리소스 로딩, WeChat xr-frame의 AR 시스템 준비 대기를 포함합니다.
실행: session 상태가 Running으로 전환됩니다. 이 단계에서 session은 매 frame tracking 결과를 출력하고 xr-frame 카메라의 Transform을 업데이트합니다.
중지: session 상태가 None으로 전환됩니다. 리소스 해제, 상태 재설정, MegaTracker 파기를 포함합니다.
경고
AR 기능은 session이 성공적으로 시작된 후에만 사용할 수 있습니다.
AR Session 상태:
| 상태 | 설명 |
|---|---|
| None | 초기 상태; session이 시작되지 않았거나 초기화에 실패함 |
| Initializing | 초기화 중 |
| Running | 실행 상태; session이 시작되었고 초기화가 완료됨 |
[선택 사항] WeChat Mini Program 플러그인의 AR Session과 Unity의 AR Session
참고
Unity 프로젝트를 마이그레이션하는 개발자만 해당합니다.
Mega WeChat Mini Program 플러그인의 AR Session은 Unity의 AR Session의 간소화된 버전입니다. 다른 알고리즘 컴포넌트의 동시 사용을 지원하지 않기 때문에, WeChat Mini Program의 AR Session은 사전 통합된 데이터 소스 컴포넌트와 알고리즘 컴포넌트를 사용합니다. 사용자는 데이터 소스를 선택하거나 알고리즘 컴포넌트를 조립할 수 없습니다.
또한 Mega WeChat Mini Program 플러그인은 Block을 target으로 하고 target 중심의 center mode를 사용하는 경우만 지원한다고 볼 수 있습니다.