Table of Contents

소프트웨어 실행 효과

프로젝트 개발이 완료되지 않았거나, 공식 개발 전에 위치 지정 효과를 검증해야 할 경우 Mega Toolbox(위챗 미니프로그램)을 통해 실제 현장에서 위치 지정 효과를 빠르게 미리 볼 수 있습니다. 이를 통해 위치 정확도와 안정성을 검증하고, 위치 서비스가 프로젝트 요구 사항을 충족하는지 확인할 수 있습니다.

효과 확인 단계

실제 실행 효과를 확인하기 전에, 위챗 기기를 준비하고 위챗 미니프로그램 접근 권한이 있으며 위치 서비스가 이미 구성 완료되었는지 확인하세요.

Toolbox 위챗 미니프로그램 QR 코드 스캔

효과 검증 전, 먼저 위챗으로 미니프로그램 QR 코드를 스캔하여 Mega Toolbox 앱에 진입해야 합니다.

Mega Toolbox 위챗 미니프로그램

EasyAR 계정 로그인

실제 실행 효과를 확인하는 첫 단계는 미니프로그램에서 EasyAR 계정에 로그인하는 것입니다.

Toolbox 로그인

위치 지정 라이브러리 및 주석 데이터 선택

계정 로그인 후, 해당 위치 서비스와 주석 데이터 리소스를 선택해야 합니다. 이는 정확한 위치 지정의 핵심 단계입니다. 참고: 실제 실행 효과를 미리 보려면 반드시 주석 데이터를 선택해야 합니다. 현재 프로젝트에 주석 데이터가 없는 경우 먼저 주석 데이터를 생성하세요.

다음 단계에 따라 해당 서비스와 데이터를 선택하세요:

  1. 클라우드 위치 서비스 그룹을 선택하고, 드롭다운 메뉴에서 선택합니다.
  2. 해당 클라우드 위치 라이브러리를 선택하고, 드롭다운 메뉴에서 선택합니다.
  3. 해당 주석 데이터를 선택하고, 드롭다운 메뉴에서 선택합니다. (주석 데이터가 없는 경우 참조: 주석 데이터 생성)
  4. 시작을 클릭합니다.

위치 지정 라이브러리 및 주석 데이터 선택

관련 권한 부여

위치 지정 기능을 정상적으로 사용하려면 카메라 및 위치 정보 권한을 부여해야 합니다.

관련 권한 부여 관련 권한 부여

현장 효과 확인

동영상 데모:

참고

더 나은 시각적 경험을 위해 Debug 정보를 끄면 주석 내용의 위치 지정 시각 효과를 더 직관적으로 확인할 수 있습니다.

상태 판단 설명:

다음 세 가지 핵심 지표로 현재 위치 상태를 판단할 수 있습니다:

  • 주석 cube 상태: 정상 위치 시 흰색 MEGA 텍스처 표시, 위치 실패 시 회색 표시
  • Debug 정보 반환 상자의 매개변수:
    • status 상태 값: 현재 위치 상태 표시
    • Sequence 매개변수: N은 미로드, F는 위치 실패, S는 위치 성공을 나타냄
    • Status 버튼: 녹색은 위치 성공, 흰색은 위치 실패를 나타냄

미니프로그램은 서비스 반환 정보에 따라 상태를 표시하여 위치 서비스 실행 상황을 파악하는 데 도움을 줍니다:

  • 위치 성공 상태: 현장 위치인 경우, 위치 디버그 정보에 status: Found 텍스트 알림이 표시되고, Status 버튼은 녹색으로, Sequence 매개변수는 S로, 표시된 cube는 흰색 MEGA 텍스처를 정상적으로 표시합니다. 이는 위치 서비스가 대상을 성공적으로 위치시켰음을 의미합니다.

    위치 성공 효과 확인

  • 동시 접속 경고: 위치 디버그 정보에 status: QpsLimitExceeded 텍스트 알림이 표시되고, Status 버튼은 흰색으로, Sequence 매개변수는 F로 표시되는 경우, 위치 서비스는 정상 실행 중이지만 현재 QPS가 제한을 초과했음을 의미합니다. 이 문제를 해결하려면 위치 서비스 용량 초과 및 확장을 참조하세요.

    동시 접속 경고

  • 대상 미발견 상태: 현장 위치가 아니거나 위치 라이브러리에 일치하는 장면이 없는 경우, 위치 디버그 정보에 status: Not Found가 표시되고, Status 버튼은 흰색으로, Sequence 매개변수는 F로 표시됩니다. 이는 위치 서비스가 정상 실행되었지만 대상을 위치시키지 못했음을 의미합니다.

    대상 미발견 효과 확인

  • 위치 서비스 비정상: 위치 디버그 정보에 UnKnownError 텍스트 알림이 표시되는 경우, 위치 서비스 실행에 이상이 있음을 의미합니다. 기록 로그, 기록 데이터를 열고 오류 정보를 기록한 후 EasyAR 고객 서비스에 문의하세요.

관련 주제