본문으로 건너뛰기
버전: 1.7.0

Custom Range

내비게이션을 진행하면서 특정 Transit node에 진입할 때, Transit node를 기준으로 5m 이내에 들어오게 될 경우 OnTransitMovingStarted 이벤트가 실행됩니다. 하지만 거리 기준으로 Transit node의 진입 여부를 판단한다면 의도하지 않은 순간에 Transit node에 진입했다고 판단할 수 있습니다. 이와 같은 경우를 대비하여 Custom Range를 사용할 수 있습니다. Custom Range를 이용하면 AMapper에서 설정한 폴리곤의 모양에 맞춰서 Transit node의 진입 여부를 판단할 수 있습니다.

Custom Range 생성

Custom Range를 생성하기 위해서는 Custom이라는 이름의 레이어를 생성해야 하며 해당 레이어는 Semantic Area가 활성화 되어야 합니다. 새로운 레이어를 생성한 뒤 레이어를 선택하 Semantic Area를 활성화합니다. 그 후 생성된 레이어 하위에 폴리곤을 그립니다.

스크린샷 2023-11-07 오후 3 44 46

Custom Range가 설정되면 해당 영역에 카메라가 진입했을때 ARPlayground의 OnCustomRangeEntered(string uuid, string name) 이벤트가 호출됩니다. 해당 영역을 빠져나오면 OnCustomRangeExited(string uuid, string label) 이벤트가 호출됩니다.

Transit node와 Custom Range 연결

Custom Range에 진입했을때 Transit이 발생하게 할 수 있습니다. 이를 위해서는 Transit node와 Custom Range를 연결해야 합니다. Custom Range를 설정하고 싶은 Transit node를 선택하여 Custom Range를 할당해줍니다. 현재 아무 연결도 없는 Custom Range의 목록이 자동으로 출력됩니다. 연결을 하고자 하는 Custom Range의 이름을 선택하면 연결이 완료됩니다.

경고

Transit node에 Custom Range를 연결할 땐 반드시 시작 transit 노드와 끝 transit 노드 모두에 Custom Range를 연결해야 Custom Range 기능이 활성화 됩니다.

스크린샷 2023-11-07 오후 3 45 43