Table of Contents

문제 보고 및 피드백

저희는 여러분의 피드백을 매우 중요하게 생각합니다. 이는 EasyAR Mega 제품과 서비스를 개선하는 데 핵심입니다. 여러분이 겪은 문제를 빠르고 정확하게 찾고 해결할 수 있도록, 보고서를 제출하기 전에 몇 분 동안 이 가이드를 읽어 주세요.

연락 방법

다음 채널을 통해 문제 보고서를 제출할 수 있습니다.

  • 공식 개발자 커뮤니티/포럼 - 일반적인 문제와 커뮤니티 소통에 권장됩니다.

    • 중국 사용자는 여기를 클릭
    • 기타 사용자는 여기를 클릭

  • 기업 WeChat 그룹 - 기밀 유지 또는 더 공식적인 지원이 필요한 enterprise 사용자에게 적합합니다.

    • 아래 QR 코드를 스캔하여 그룹에 참여

  • 기타 연락 방법 - 대체 방안입니다.

    • 연락처를 얻으려면 여기를 클릭

고품질 보고서 제출의 핵심 요소

다음 정보를 포함한 보고서는 문제 재현과 해결에 큰 도움이 됩니다. 정보가 완전할수록 문제 해결이 더 빨라집니다.

일반 보고 checklist (모든 문제에 필요)

  1. 명확한 문제 설명:

    • 기대한 효과는 무엇입니까?
    • 실제로 무엇이 발생했습니까? 예: 앱 crash, localization 실패, 콘텐츠 drift.
    • 문제 발생 빈도는 필수 발생/가끔 발생 중 무엇입니까? 어떤 조건에서 발생합니까?

  2. 디바이스 및 환경 정보:

    • 디바이스 모델: 예: iPhone 14 Pro, Samsung Galaxy S23 Ultra, Apple Vision Pro.
    • 운영체제 버전: 예: iOS 17.2, Android 14, visionOS 26.
    • EasyAR SDK 버전: 예: EasyAR Sense Unity Plugin v4.6.0.
    • 테스트 환경: 실내/실외, 조명 조건, 동적 환경 여부.

  3. EIF 데이터 (가장 중요한 증거):

    • 문제를 재현할 수 있는 EIF 녹화 파일을 반드시 제공해 주세요.
    • EIF 데이터에는 문제 발생 시의 모든 센서와 이미지 정보가 포함되어 있으며, 문제 진단을 위한 가장 강력한 도구입니다. 녹화 방법은 시뮬레이션 실행 데이터 수집을 참고하세요.

  4. 로그 파일 (Log):

    • 문제 발생 시의 전체 애플리케이션 로그를 제공해 주세요.
    • Android: Logcat 출력.
    • iOS: Console.app 로그 또는 Xcode 콘솔 출력.
    • Unity: Unity Editor의 Console 로그.
    • WeChat Mini Program: session.dumpLog()로 얻은 로그 파일.

  5. 화면 녹화 또는 screenshot:

    • 문제 발생 시의 화면 녹화 또는 고해상도 screenshot은 설명한 현상을 직관적으로 보여줄 수 있습니다.
    • 디바이스별 작업 가이드는 모바일 화면 녹화, 헤드셋 화면 녹화를 참고하세요.

  6. Mega localization library 정보

    • Unity에서 애플리케이션이 사용하는 block 진단 정보 / Mega localization library의 서비스 정보를 내보냅니다. 내보내기 방법:

특정 문제 유형의 추가 checklist

문제를 더 정확하게 찾기 위해, 문제 유형에 따라 다음 정보를 추가로 제공해 주세요.

A. Localization 실패 또는 불안정

  • 같은 위치에서 Mega Toolbox 또는 PC tool을 사용해 검증을 시도했고 결과를 설명했습니다.
  • localization library에 로드된 map이 현재 물리 공간과 일치함을 확인했습니다.
  • 문제 발생 대략 위치를 설명했습니다. 예: 쇼핑몰 아트리움, 관광지 입구.

B. 콘텐츠가 표시되지 않음

  • 외부 tool을 사용해 localization을 검증한 결과를 제공했습니다.
  • 콘텐츠 배치 또는 코드 로직에 문제가 없음을 명확히 확인했습니다.
  • rendering 문제라면 사용한 모델, Shader 또는 효과의 screenshot이나 설명을 제공해 주세요.

C. 콘텐츠 튐 또는 drift

  • 디바이스 이동 방식, 예를 들어 안정적인 이동/빠른 이동을 설명했습니다.
  • 환경의 텍스처와 조명 상태, 그리고 매우 유사한 혼동 영역이 있는지 설명했습니다.
  • 애플리케이션 내부의 pose 처리 로직과 콘텐츠 배치가 올바름을 설명했습니다.

D. WeChat Mini Program 문제

  • 사용자가 WeChat에서 Mega 서비스 권한을 활성화한 screenshot을 제공했습니다.
  • 사용자 휴대폰 모델이 WeChat 공식 지원 목록에 있는지 설명했습니다.
  • Mini Program의 AppID와 구체적인 비즈니스 시나리오 설명을 제공했습니다.

E. 성능 문제 (끊김, 높은 전력 소모)

  • 문제가 발생한 디바이스 모델을 설명했습니다.
  • 가능하다면 애플리케이션 실행 중 CPU/GPU 점유율 또는 디바이스 온도 정보를 제공했습니다.
  • 모델 면 수, 텍스처 크기 등 3D 콘텐츠의 복잡도를 설명했습니다.
  • multi-map 구성을 사용했는지 설명했습니다.

EasyAR Sense Unity Plugin을 사용하여 Unity 개발 정보 내보내기

특히 Unity 플랫폼의 Mega 애플리케이션 개발을 위해, 더 편리한 피드백 정보 생성 tool을 준비했습니다. 자세한 작업 단계는 다음과 같습니다.

  1. 메뉴 바에서 EasyAR > Sense > Ask a Question을 엽니다 Ask a Question
  2. Ask a Question에서 다음 정보를 제공합니다:
    • 실행 환경을 체크합니다(단일 선택). 예: Android.
    • 디바이스 정보를 복사합니다. ARSession에서 DiagnosticsController.DumpSession을 Log로 설정하고, 한 frame의 출력을 복사하여 결과를 디바이스 정보 입력란에 작성합니다. Dump session
    • 애플리케이션에서 사용하는 모든 EasyAR 기능을 체크합니다. 다중 선택을 지원합니다.
    • 페이지의 네 가지 검사를 모두 완료하고 체크했는지 확인합니다. 질문 시 Sample에서 문제를 재현하는 방법을 설명하는 것을 권장합니다.
    • 오른쪽 위의 복사 기능을 클릭하면 Unity 개발 정보 수집이 완료됩니다. Unity 개발 정보 내보내기

보고서 제출 흐름 권장

  1. 자료 준비: 위 checklist에 따라 EIF, 로그, screenshot/화면 녹화, 서비스 정보, 개발 정보 등을 수집합니다.
  2. 보고서 작성: 문제를 명확히 설명하고 모든 자료를 첨부합니다.
  3. 제출: 선택한 채널을 통해 보고서를 제출합니다.
  4. 후속 연락: 보고서를 받은 후 비즈니스 담당자 또는 이메일을 통해 연락드리겠습니다. 계속 확인해 주세요.

EasyAR Mega 제품에 대한 시간과 지원에 감사드립니다. 여러분의 모든 feedback은 더 나은 spatial computing의 미래를 만드는 데 도움이 됩니다.