Mega 자주 묻는 질문

개발 과정에서 문제가 발생하는 것은 피할 수 없습니다. 이 문서는 일반적인 문제를 신속하게 파악하고 해결하는 데 도움을 드리기 위한 것입니다. 먼저 자주 묻는 질문(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: 왜 내 앱이 위치를 확인하지 못하고, 반환 상태가 계속 NotFound인가요?

A: 이는 일반적으로 다음과 같은 이유로 발생합니다:

1. 위치 서비스가 아직 시작 중임:
   이때 위치 서비스가 모든 Mega 맵을 완전히 로드하지 않았으므로 특정 영역에서 위치 확인이 성공할 수 없습니다.
2. 맵 커버리지 범위 밖에 위치함:
   현재 물리적 위치가 로드한 Mega 맵의 커버리지 영역 내에 있는지 확인하세요.
3. 시뮬레이션 테스트 구성 오류:
   현장에서 실행하지 않는데 MegaLocationInputMode가 Onsite로 잘못 설정된 경우입니다.
4. 환경 조건이 좋지 않음:
   극단적인 조도(너무 어둡거나 밝음), 대규모 단색 벽면 또는 바닥(흰 벽, 광택 바닥 등)은 시각적 위치 확인에 영향을 미칩니다.

Q: 왜 내 앱이 위치를 확인하지 못하고, 반환 상태가 비정상적인가요?

A: 이는 일반적으로 다음과 같은 이유로 발생합니다:

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

Q: 왜 내 미니프로그램의 플러그인 사용 신청이 실패하나요?

A: 이는 위챗 개발자 도구의 "비회원 모드"에서는 미니프로그램 플러그인 사용을 지원하지 않으며, 주체가 개인인 미니프로그램에서도 사용할 수 없기 때문입니다. 기업 주체의 위챗 미니프로그램 AppId를 사용하여 신청해 주세요.

Q: 왜 내 미니프로그램 승인이 통과되지 않았나요?

A: 개발 센터에서 Mega 미니프로그램 플러그인 라이선스를 획득하고, 사용 중인 AppId가 라이선스의 것과 동일한지 확인해야 합니다.

Q: 왜 내 미니프로그램이 XX 폰에서 작동하지 않나요?

A: 미니프로그램에 Mega를 통합하려면 WeChat의 VisionKit 컴포넌트가 필요하며, 이의 시스템 요구사항 및 지원 기기 목록은 WeChat 문서를 참조하세요.

Q: 위치는 성공했지만 가상 콘텐츠의 위치가 어긋나거나 표류하는 것처럼 보여요?

A: 위치 지정 효과와 관련된 문제는 그 원인이 종종 복잡합니다. 가능한 원인은 다음과 같습니다:

1. 맵핑 정확도 문제: 해당 지역의 Mega 맵 자체에 정확도 오류가 있을 수 있습니다. 이는 일반적으로 맵 수집 또는 재구성 단계에서 발생하며, 확인을 위해 비즈니스 담당자에게 문의하세요.
2. 초기화 시 점프: 위치 지정이 시작된 후 처음 몇 초 동안 위치가 약간 점프할 수 있습니다. 이는 기기의 SLAM 시스템이 아직 초기화를 완료하지 않았기 때문이며, WeChat 미니프로그램에서는 이 과정이 특히 두드러집니다(일부 기기에서는 시간이 상당히 길 수도 있음).
3. 환경의 동적 변화: 물리적 환경이 크게 변했다면(예: 대형 배치 이동, 임시 전시판 추가), 맵이 현실과 맞지 않을 수 있습니다. 이 경우 맵을 업데이트해야 합니다.
4. 기기 시스템 오류: 대부분의 기기는 장시간 연속 작동 후 SLAM 시스템의 누적 오류로 인해 표류가 발생할 수 있습니다.
5. 위치 지정 오류 문제: 시각적 위치 지정 자체에는 정확도 오류가 있으며, 일반적으로 이 오류는 가상 콘텐츠의 시각적 경험에 영향을 주지 않습니다. 오류가 뚜렷한 어긋남이나 표류를 일으킬 정도로 크다면, 이를 분석하고 해결하기 위해 상세한 데이터가 필요합니다. 문제 진단 및 보고에 소개된 방법을 참고하여 데이터를 수집하고 피드백하세요.

Q: 어떻게 EIF 데이터를 수집하여 디버깅에 사용하나요?

A: EIF 데이터는 강력한 디버깅 도구입니다. 다음 섹션을 참조하세요:

• 수집 방법: 시뮬레이션 실행 데이터 수집을 읽고 휴대폰이나 헤드셋에서 EIF 파일을 녹화하는 방법을 알아보세요.
• 재생 방법: 개발 환경(Unity 또는 WeChat 미니프로그램)에 따라 해당 섹션에서 해당하는 재생 가이드를 참조하세요.

보다 구체적인 도움 찾기

위의 FAQ로 문제가 해결되지 않는다면, 다음 주제별 페이지를 방문하여 보다 심층적인 해결책을 얻으실 수 있습니다:

• 콘텐츠 표시 안 됨 - 콘텐츠 렌더링 문제 해결에 집중합니다.
• 콘텐츠 점프 및 드리프트 - 콘텐츠의 점프 및 드리프트 현상을 심층 분석합니다.
• 위챗 미니프로그램 통합 시 알려진 문제 - 미니프로그램 플랫폼의 특수 문제를 종합합니다.

새로운 문제 보고하기

위에서 다루지 않은, SDK 또는 플랫폼 자체의 문제로 의심되는 경우를 발견하셨다면 제품 개선을 위해 저희를 도와주세요. 자세한 단계나 안내는 다음 문서를 참조하세요: 문제 보고.

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

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

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