Mega FAQ

개발 과정에서 문제를 만나는 것은 피하기 어렵습니다. 이 문서는 일반적인 문제를 빠르게 찾고 해결하는 데 도움을 주기 위한 것입니다. 먼저 자주 묻는 질문(FAQ) 목록부터 시작합니다. 여기에서 답을 찾을 수 없다면 이후 장을 참고하거나 문제 보고서를 제출해 주세요.

자주 묻는 질문(FAQ)

다음은 개발자가 EasyAR Mega를 통합하고 사용할 때 가장 자주 만나는 문제와 해결 방법입니다.

Q: 왜 애플리케이션에 Invalid Key 가 표시되나요?

A: 일반적으로 다음 몇 가지 이유로 발생합니다.

1. License 가 유효하지 않거나 만료됨
2. License 가 Bundle ID / Package Name 과 일치하지 않음
3. 헤드셋 디바이스에는 별도의 XR License 필요
4. 커스텀 카메라 기능에는 정식 License 필요

Q: 왜 애플리케이션에 워터마크가 있나요?

A: 사용 중인 License 가 정식 버전이 아니라 시험판임을 의미합니다.

Q: 왜 애플리케이션에 카운트다운 안내, timeout within * seconds, 가 표시되나요?

A: 이는 시험 제품 기간의 제한입니다. 정식 EasyAR Sense 라이선스와 정식 EasyAR Mega 서비스를 사용하면 이 문제를 해결할 수 있습니다.

Q: 왜 애플리케이션을 열면 검은 화면이 나오나요?

A: 이 경우 보통 화면 정보나 로그에 오류 원인이 출력됩니다. 시스템이 출력한 구체적인 원인에 따라 해결할 수 있습니다. 해결할 수 없다면 로그, 스크린샷, 자세한 디바이스 정보 등을 포함한 기술 정보를 피드백하십시오.

Q: 왜 애플리케이션이 localization 할 수 없고 반환 상태가 계속 NotFound 인가요?

A: 일반적으로 다음 몇 가지 이유로 발생합니다.

1. localization 서비스가 아직 시작 중:
   이때 localization 서비스가 모든 Mega 지도를 아직 완전히 로드하지 않았으므로 특정 영역에서 localization 성공을 보장할 수 없습니다.
2. 지도 커버리지 범위 밖:
   현재 물리적 위치가 로드한 Mega 지도의 커버리지 영역 안에 있는지 확인하십시오.
3. 시뮬레이션 테스트 설정 오류:
   현장에서 실행하지 않지만 MegaLocationInputMode 가 잘못 Onsite 로 설정되었습니다.
4. 환경 조건 불량:
   너무 어둡거나 너무 밝은 극단적인 조명, 흰 벽이나 광택 바닥처럼 넓은 단색 벽면 또는 바닥은 visual localization 에 영향을 줄 수 있습니다.

Q: 왜 애플리케이션이 localization 할 수 없고 반환 상태가 비정상인가요?

A: 일반적으로 다음 몇 가지 이유로 발생합니다.

1. Request timeout:
   이때 시스템은 RequestTimeout 을 반환합니다.
2. Request 간격이 너무 짧음:
   이때 시스템은 RequestIntervalTooLow 를 반환합니다.
3. 기타 비정상 오류:
   이때 시스템은 UnknownError 를 반환합니다. 일반적으로 이러한 비정상은 연결 또는 전송 과정의 실패나 Mega 서비스 자체 오류에 해당합니다. MegaBlockLocalizationResponse.ErrorMessage 인터페이스를 통해 상세 정보를 얻을 수 있습니다.

Q: 왜 Mini Program 플러그인 사용 신청이 실패했나요?

A: Mini Program 플러그인은 WeChat Developer Tools 의 “visitor mode” 에서 사용할 수 없으며, 개인 주체의 Mini Program 에서도 사용할 수 없기 때문입니다. 기업 주체의 WeChat Mini Program AppId 로 신청하십시오.

Q: 내 Mini Program 인증이 통과되지 않은 이유는 무엇인가요?

A: developer center에서 Mega Mini Program plugin license를 받아야 하며, 사용하는 AppId가 license의 AppId와 동일한지 확인해야 합니다.

Q: 내 Mini Program이 XX 휴대폰에서 사용할 수 없는 이유는 무엇인가요?

A: Mini Program에 Mega를 통합하는 것은 WeChat의 VisionKit 컴포넌트에 의존합니다. System requirements 및 device support list는 WeChat documentation을 참고하십시오.

Q: Localization은 성공했지만 가상 콘텐츠 위치가 offset되거나 drifting되는 것처럼 보이는 이유는 무엇인가요?

A: Localization 효과와 관련된 문제는 원인이 복잡한 경우가 많습니다. 가능한 원인은 다음과 같습니다.

1. Mapping 정확도 문제:
   해당 영역의 Mega map 자체에 정확도 오차가 있을 수 있습니다. 이는 일반적으로 map collection 또는 reconstruction 단계에서 발생합니다. 확인을 위해 비즈니스 지원에 문의하십시오.
2. Initialization 중 점프:
   Localization이 막 시작된 몇 초 동안 위치가 약간 튈 수 있습니다. 이는 device의 SLAM 시스템이 아직 initialization을 완료하지 않았기 때문입니다. WeChat Mini Program에서는 이 과정이 특히 두드러지며, 일부 devices에서는 시간이 비교적 오래 걸릴 수도 있습니다.
3. 환경의 동적 변화:
   물리 환경이 크게 변한 경우, 예를 들어 대형 설치물을 이동하거나 임시 전시판을 추가한 경우, map이 현실과 일치하지 않을 수 있습니다. 이 경우 map을 업데이트해야 합니다.
4. Device 시스템 오차:
   대부분의 devices가 장시간 연속 실행된 후에는 SLAM 시스템의 누적 오차로 인해 drifting이 발생할 수 있습니다.
5. Localization 오차 문제:
   Visual localization 자체에는 정확도 오차가 있습니다. 일반적으로 이러한 오차는 가상 콘텐츠의 시각적 경험에 영향을 주지 않습니다. 오차가 커서 명확한 offset 또는 drifting이 발생하는 경우, 분석과 해결을 위해 자세한 데이터가 필요합니다. issue diagnosis and report에 소개된 방법을 참고하여 데이터를 수집하고 feedback하십시오.

Q: Debugging을 위해 EIF 데이터를 어떻게 수집하고 사용하나요?

A: EIF 데이터는 강력한 debugging tool입니다. 다음 섹션을 참고하십시오.

• 수집 방법: collect simulated runtime data를 읽고 휴대폰 또는 headset에서 EIF 파일을 녹화하는 방법을 알아보십시오.
• Replay 방법: development environment가 Unity인지 WeChat Mini Program인지에 따라 해당 섹션의 replay guide를 참고하십시오.

더 구체적인 도움 찾기

위 FAQ로 문제가 해결되지 않는 경우, 다음 주제 페이지에서 더 깊이 있는 해결 방법을 확인할 수 있습니다.

• 콘텐츠가 표시되지 않음 - 콘텐츠 렌더링 문제 해결에 집중합니다.
• 콘텐츠 흔들림과 드리프트 - 콘텐츠의 흔들림과 드리프트를 심층 분석합니다.
• WeChat Mini Program 통합 알려진 문제 - mini program 플랫폼의 특수 문제 요약입니다.

새 문제 보고

위에 포함되지 않았고 SDK 또는 플랫폼 자체와 관련된 것으로 의심되는 문제를 만난 경우, 제품 개선을 도와주세요. 자세한 단계나 안내는 문제 보고를 참고하세요.

보고서를 제출하기 전에 다음 정보를 준비했는지 확인하세요. 문제 해결에 큰 도움이 됩니다.

1. 문제 설명: 발생한 문제 현상, 빈도, 작업 단계를 명확히 설명하세요.
2. 기기 정보: 기기 모델, 운영 체제 버전, EasyAR SDK 버전.
3. EIF 데이터: 문제를 재현할 수 있는 EIF 녹화 파일을 반드시 제공하세요. 가장 중요한 진단 근거입니다.
4. 로그 파일: 애플리케이션의 전체 로그(Logcat 또는 Console 출력).
5. 화면 녹화 또는 스크린샷: 문제가 발생했을 때의 화면 녹화 또는 스크린샷.

위 정보를 포럼, 이메일 또는 비즈니스 연락처를 통해 제출해 주세요. 피드백에 감사드립니다!