Table of Contents

AR session 비현장 사용

이 글은 현장에 있지 않을 때 AR session 사용 방법을 소개합니다.

시작하기 전에

시뮬레이터 모드 활성화

시뮬레이터 모드를 사용하면 AR 애플리케이션 개발 시 개발자의 장기 현장 주재 필요성을 줄일 수 있습니다.

이 모드에서는 session이 GNSS 데이터를 사용하지 않거나 가상의 GNSS 데이터를 입력합니다.

경고

시뮬레이터 모드 활성화 시 화면에 특정 워터마크가 표시됩니다.

미니프로그램 정식 출시 시 AR session에서 시뮬레이터 모드 사용이 금지됩니다. 출시 전 반드시 관련 설정을 제거하십시오.

GNSS 데이터 미사용

EasyARSession의 setGeoLocationInput(inputMode, geoLocation) 메서드로 "Simulator" 문자열만 전달합니다. 이후 session은 경위도 관련 위치 추적을 수행하지 않습니다.

session.setGeoLocationInput("Simulator");

모의 GNSS 데이터 사용

특정 위치를 시뮬레이션해야 하는 경우, EasyARSession의 setGeoLocationInput(inputMode, geoLocation) 메서드에 "Simulator" 문자열과 지정된 경위도를 전달합니다. 이후 session은 모의 경위도 데이터로 위치를 추적합니다.

const targetLongitude = 123.45; // 경도
const targetLatitude = 32.1; // 위도
session.setGeoLocationInput("Simulator", { longitude: targetLongitude, latitude: targetLatitude });
경고

모의 입력은 반드시 WGS-84 좌표계의 경위도 데이터를 사용해야 합니다.

잘못된 경위도 데이터 사용 시 위치 추적 실패나 오동작을 유발할 수 있습니다.