Table of Contents

문제 보고 및 피드백

우리는 귀하의 피드백을 매우 중요하게 여기며, 이는 EasyAR Mega 제품과 서비스를 개선하는 데 핵심적인 역할을 합니다. 문제를 빠르고 정확하게 파악하고 해결할 수 있도록 보고서를 제출하기 전에 이 가이드를 몇 분 동안 읽어주세요.

우리의 연락처

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

  • 공식 개발자 커뮤니티/포럼 - 일반적인 문제와 커뮤니티 교류에 추천합니다.

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

  • 기업微信群 - 비밀을 유지하거나 보다 공식적인 지원이 필요한 기업 고객에게 적합합니다.

    • 아래 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)

    • 문제가 발생할 때의 전체 앱 로그를 제공하세요.
    • 안드로이드：Logcat 출력입니다.
    • iOS：Console.app 로그 또는 Xcode 콘솔 출력입니다.
    • 유니티：유니티 편집기의 Console 로그입니다.
    • 위챗 소프트 프로그램：session.dumpLog()로 얻은 로그 파일입니다.

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

    • 문제가 발생할 때의 화면 녹화 또는 고해상도 스크린샷을 제공하세요. 이를 통해 귀하가 설명하는 현상을 직관적으로 확인할 수 있습니다.
    • 다양한 기기의 조작 가이드는 휴대폰 화면 녹화, 헤드셋 화면 녹화를 참조하세요.

  6. Mega 위치 찾기 라이브러리 정보

    • 유니티에서 애플리케이션을 내보낼 때 사용한 블록 진단 정보 / Mega 위치 찾기 라이브러리의 서비스 정보를 내보냅니다. 내보내기 방법은 다음과 같습니다.

특정 문제 유형에 대한 추가 목록

문제를 더 정확하게 파악할 수 있도록 문제 유형에 따라 다음 정보를 추가로 제공하세요.

A. 위치 찾기 실패 또는 불안정

  • Mega Toolbox 또는 PC용 도구를 사용하여 동일한 위치에서 확인했으며 결과를 설명했습니다.
  • 위치 찾기 라이브러리에 로드된 지도가 현재 물리적 공간과 일치하는지 확인했습니다.
  • 문제가 발생한 대략적인 위치를 설명했습니다. (예: 쇼핑몰 중앙, 관광 명소 입구)

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

  • 외부 도구를 사용하여 위치 찾기를 확인한 결과를 제공했습니다.
  • 콘텐츠 배치 또는 코드 논리에 문제가 없다는 것을 확인했습니다.
  • 렌더링 문제인 경우 사용된 모델, 셰이더 또는 이펙트의 스크린샷 또는 설명을 제공했습니다.

C. 콘텐츠가 흔들리거나 떠다님

  • 기기의 이동 방식(안정적으로 이동/빠르게 이동)을 설명했습니다.
  • 환경의 텍스처와 조명 상황을 설명했으며, 극도로 유사한 혼동 영역이 있는지 여부를 설명했습니다.
  • 애플리케이션 내에서 자세를 처리하는 논리와 콘텐츠 배치가 올바른지 설명했습니다.

D. 위챗 소프트 프로그램 문제

  • 사용자가 위챗 내에서 Mega 서비스 권한을 활성화한 스크린샷을 제공했습니다.
  • 사용자의 휴대폰 모델이 위챗 공식 지원 목록에 있는지 여부를 설명했습니다.
  • 소프트 프로그램의 AppID와 구체적인 비즈니스 시나리오 설명을 제공했습니다.

E. 성능 문제(버벅거림, 전력 소모가 높음)

  • 문제가 발생한 기기 모델을 설명했습니다.
  • 애플리케이션이 실행되는 동안 CPU/GPU 사용률 또는 기기 온도 정보를 제공했습니다. (가능한 경우)
  • 3D 콘텐츠의 복잡도(모델의 면 수, 텍스처 크기)를 설명했습니다.
  • 다중 이미지 구성을 사용했는지 여부를 설명했습니다.

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

특히 유니티 플랫폼에서 Mega 애플리케이션을 개발하는 경우 보다 편리한 피드백 정보 생성 도구를 준비했습니다. 자세한 조작 단계는 다음과 같습니다.

  1. 메뉴 모음에서 EasyAR > Sense > 질문을 엽니다.
    질문
  2. 질문에서 다음 정보를 제공합니다.
    • 실행 환경을 선택합니다. (단일 선택) 예를 들어 안드로이드입니다.
    • 기기 정보를 복사합니다. ARSession에서 DiagnosticsController.DumpSession을 Log로 설정하고 한 프레임의 출력을 복사하여 기기 정보 상자에 입력합니다.
      Dump session
    • 애플리케이션에서 사용하는 모든 EasyAR 기능을 선택합니다. 다중 선택을 지원합니다.
    • 페이지의 네 가지 검사를 완료했는지 확인하고 체크합니다. 질문할 때 샘플에서 문제를 재현하는 방법을 설명하는 것이 좋습니다.
    • 오른쪽 상단의 복사 기능을 클릭하면 유니티 개발 정보 수집이 완료됩니다.
      유니티 개발 정보 내보내기

보고서 제출 프로세스 제안

  1. 자료 준비：위 목록에 따라 EIF, 로그, 스크린샷/화면 녹화, 서비스 정보, 개발 정보 등을 수집합니다.
  2. 보고서 작성：문제를 명확하게 설명하고 모든 자료를 첨부합니다.
  3. 제출：선택한 채널을 통해 보고서를 제출합니다.
  4. 추적：보고서를 받은 후 비즈니스 담당자나 이메일을 통해 연락할 것입니다. 지속적인 관심을 기대합니다.

귀하의 시간과 EasyAR Mega 제품에 대한 지원에 감사드립니다! 귀하의 모든 피드백은 더 나은 공간 계산 미래를 구축하는 데 도움이 됩니다.