Table of Contents

AR Session 현장 밖 사용

이 문서는 현장에 있지 않을 때 AR Session을 사용하는 방법을 소개합니다.

시작하기 전에

Simulator 모드 활성화

Simulator 모드를 사용하면 AR 애플리케이션 개발 중 개발자가 장기간 현장에 머물러야 하는 상황을 피할 수 있습니다.

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

경고

Simulator 모드를 활성화하면 화면에 특정 워터마크가 나타납니다.

미니 프로그램을 정식 출시할 때 AR Session은 Simulator 모드를 사용할 수 없습니다. 온라인 전 관련 구성을 반드시 제거하십시오.

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 좌표계의 경도 및 위도 데이터를 사용해야 합니다.

잘못된 경도 및 위도 데이터를 사용하면 위치 지정이 실패하거나 혼란스러워질 수 있습니다.