Mega 위챗 미니프로그램 플러그인에서의 AR 세션 개념과 프로세스
이 문서는 Mega 위챗 미니프로그램 플러그인에서의 AR 세션 개념과 프로세스를 소개합니다.
AR 세션이란
Mega 위챗 미니프로그램 플러그인이 제공하는 AR 세션은 모든 AR 기능의 진입점입니다. 실행 과정과 상태를 관리합니다: VisionKit 및 위챗이 제공하는 센서 API로부터 데이터를 획득하고, 클라우드 위치 추적과 로컬 AR 트래커 결과를 융합하며, 씬 내 카메라 및 기타 오브젝트의 이동과 렌더링을 구동하는 등의 작업을 포함합니다.
flowchart LR
Pose(VisionKit 카메라 포즈) -- 매 프레임 동기화 --> Session[세션]
Image(해당 프레임 카메라 포즈 계산에 사용된 카메라 이미지) -. Mega 위치 추적 시에만 전송 .-> Session
Sensor(위챗 센서 데이터) -. 비동기 .-> Session
Session -- Transform --> Camera(xr-frame 카메라)
AR 세션의 프로세스
flowchart LR
Start((" "))
End((" "))
Init[초기화 중]
Run[실행 중]
Check{성공?}
Start -->|start 호출| Init
Init --> Check
Check -->|예| Run
Check -->|아니오 / 재시도 횟수 초과| End
Run -->|stop 호출| End
시작: 세션 상태가 '초기화 중(Initializing)'으로 전환됩니다. 환경 점검, 리소스 로드, 위챗 xr-frame AR 시스템 준비 대기를 포함합니다.
실행: 세션 상태가 '실행 중(Running)'으로 전환됩니다. 이 단계에서 세션은 매 프레임 추적 결과를 출력하고 xr-frame 카메라의 트랜스폼(Transform)을 업데이트합니다.
중지: 세션 상태가 '없음(None)'으로 전환됩니다. 리소스 해제, 상태 초기화, MegaTracker 파괴를 포함합니다.
경고
AR 기능은 세션이 성공적으로 시작된 후에만 사용 가능합니다.
AR 세션 상태:
| 상태 | 설명 |
|---|---|
| None | 초기 상태, 세션 미시작 또는 초기화 실패 |
| Initializing | 초기화 진행 중 |
| Running | 실행 상태, 세션 시작 완료 및 초기화 완료 |
[선택 사항] 위챗 미니프로그램 플러그인에서의 AR 세션 vs Unity에서의 AR 세션
참고
Unity 프로젝트 마이그레이션 개발자 대상.
Mega 위챗 미니프로그램 플러그인의 AR 세션은 Unity AR 세션의 간소화 버전입니다. 다른 알고리즘 컴포넌트의 동시 사용이 불가능하므로, 미리 통합된 데이터 소스 컴포넌트와 알고리즘 컴포넌트를 사용합니다. 사용자는 데이터 소스 및/또는 알고리즘 컴포넌트를 선택/조립할 수 없습니다.
또한, Mega 위챗 미니프로그램 플러그인은 블록(Block)을 타겟으로 하고 타겟 중심 모드(target-centric mode)를 사용하는 경우만 지원한다고 볼 수 있습니다.