Table of Contents

문제 보고 및 피드백

저희는 귀하의 피드백을 매우 중요하게 생각하며, 이는 EasyAR Mega 제품과 서비스를 개선하는 데 핵심적인 역할을 합니다. 문제를 신속하고 정확하게 파악하여 해결하기 위해, 보고서 제출 전 본 가이드를 잠시 읽어주시기 바랍니다.

연락처

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

  • 공식 개발자 커뮤니티/포럼 - 일반 문의 및 커뮤니티 교류에 권장됩니다.

    • 중국어 사용자는 여기를 클릭하세요.
    • 기타 사용자는 여기를 클릭하세요.

  • 기업 WeChat 그룹 - 기밀 유지가 필요하거나 보다 공식적인 지원이 필요한 기업 사용자에게 적합합니다.

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

  • 추가 연락처 - 대체 방안으로 이용 가능합니다.

    • 연락처 확인은 여기를 클릭하세요.

고품질 보고서 작성 핵심 요소

아래 정보를 포함한 보고서는 문제 재현 및 해결에 큰 도움이 됩니다. 정보가 완벽할수록 문제 해결이 빠릅니다.

공통 보고 체크리스트 (모든 문제 필수)

  1. 문제 명확한 설명:

    • 기대했던 결과는 무엇인가요?
    • 실제 발생한 현상은 무엇인가요? (예: 앱 비정상 종료, 위치 추적 실패, 콘텐츠 표류)
    • 문제 발생 빈도(항상 발생/가끔 발생)? 어떤 조건에서 발생하나요?

  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 미니프로그램: session.dumpLog()로 생성된 로그 파일.

  5. 화면 녹화 또는 스크린샷:

    • 문제 발생 시점의 화면 녹화 또는 고화질 스크린샷으로 현상을 직관적으로 보여주세요.
    • 장비별 조작 가이드: 모바일 녹화, 헤드셋 녹화.

  6. Mega 위치 추적 라이브러리 정보

    • Unity에서 애플리케이션을 내보낼 때 사용된 Mega 위치 추적 라이브러리의 서비스 정보. 내보내기 방법:
      Mega Service Export

특정 문제 유형별 추가 체크리스트

정확한 문제 파악을 위해 유형에 따라 다음 정보를 추가로 제공해주세요:

A. 위치 추적 실패 또는 불안정

  • 동일 위치에서 Mega Toolbox 또는 PC 도구로 검증을 시도했으며 결과를 기재해주세요.
  • 위치 추적 라이브러리에 로드된 지도가 현재 물리적 공간과 일치함을 확인했습니다.
  • 문제 발생 대략적 위치를 설명해주세요 (예: 쇼핑몰 중앙홀, 관광지 입구).

B. 콘텐츠 미표시

  • 외부 도구를 이용한 위치 추적 검증 결과를 제공했습니다.
  • 콘텐츠 배치 또는 코드 로직에 문제 없음을 확인했습니다.
  • 렌더링 문제일 경우, 사용된 모델, Shader 또는 이펙트의 스크린샷 또는 설명을 제공해주세요.

C. 콘텐츠 점프 또는 표류

  • 장비 이동 방식을 기재해주세요 (안정적 이동/급속 이동).
  • 환경의 질감 및 조명 상태, 혼동을 유발할 만한 유사 영역 존재 여부를 기술해주세요.
  • 애플리케이션 내부의 자세(Pose) 처리 로직 및 콘텐츠 배치가 정확함을 설명해주세요.

D. WeChat 미니프로그램 문제

  • 사용자가 WeChat 내에서 Mega 서비스 권한을 활성화한 스크린샷을 제공했습니다.
  • 사용자 휴대폰 모델이 WeChat 공식 지원 목록에 포함되는지 기재해주세요.
  • 미니프로그램의 AppID 및 구체적인 비즈니스 시나리오 설명을 제공해주세요.

E. 성능 문제 (버벅임, 과도한 전력 소모)

  • 문제 발생 장비 모델을 기재해주세요.
  • 가능한 경우 애플리케이션 실행 시 CPU/GPU 점유율 또는 장비 온도 정보를 제공해주세요.
  • 3D 콘텐츠 복잡도를 설명해주세요 (모델 폴리곤 수, 텍스처 크기).
  • 멀티맵 사용 여부를 기재해주세요.

EasyAR Sense Unity Plugin으로 Unity 개발 정보 내보내기

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

  1. 메뉴 바에서 EasyAR > Sense > 질문하기를 엽니다.
    질문하기
  2. 질문하기에서 다음 정보를 제공합니다:
    • 실행 환경 선택(단일 선택, 예: Android).
    • 장비 정보 복사. ARSession에서 DiagnosticsController.DumpSession을 Log로 설정한 후, 한 프레임의 출력을 복사하여 장비 정보란에 입력합니다.
      Dump session
    • 사용 중인 모든 EasyAR 기능을 다중 선택으로 체크합니다.
    • 페이지 내 4개 항목 검토를 완료하고 체크박스에 표시한 후, Sample에서 문제 재현 방법을 질문 시 설명하는 것이 좋습니다.
    • 우측 상단의 복사 기능을 클릭하면 Unity 개발 정보 수집이 완료됩니다.
      Unity 개발 정보 내보내기

보고서 제출 절차 권장사항

  1. 자료 준비: 위 체크리스트에 따라 EIF, 로그, 스크린샷/녹화, 서비스 정보, 개발 정보 등을 수집합니다.
  2. 보고서 작성: 문제를 명확히 기술하고 모든 자료를 첨부합니다.
  3. 제출: 선택한 채널을 통해 보고서를 제출합니다.
  4. 추적: 보고서 접수 후 영업 담당자 또는 이메일로 연락드립니다. 계속 관심 가져주시기 바랍니다.

EasyAR Mega 제품을 지원해주시고 소중한 시간 내어주셔서 감사합니다! 귀하의 모든 피드백은 더 나은 공간 컴퓨팅 미래를 구축하는 데 도움이 됩니다.