問題報告とフィードバック

私たちはあなたのフィードバックを非常に重視しています。これは、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)：

   • 問題が発生したときの完全なアプリケーションログを提供してください。
   • Android: Logcat の出力。
   • iOS: Console.app のログまたは Xcode コンソールの出力。
   • Unity: Unity Editor の Console ログ。
   • ウィーチャットミニプログラム：session.dumpLog() で取得したログファイル。

5. 画面録画またはスクリーンショット：

   • 問題が発生したときの画面録画または高解像度のスクリーンショット。これにより、あなたが説明した現象を直感的に示すことができます。
   • 異なるデバイスの操作ガイドは、携帯電話の画面録画、ヘッドセットの画面録画 を参照してください。

6. Mega 位置決めライブラリの情報

   • Unity でアプリをエクスポートする際に使用する block 診断情報 / Mega 位置決めライブラリのサービス情報をエクスポートしてください。エクスポート方法は以下の通りです。
   • Unity 開発、プラグインバージョン >= 4003
   • Unity 開発、プラグインバージョン 4.7 - 4002
   • ミニプログラム開発

   

特定の問題タイプに関する追加リスト

問題の特定をより正確に行うために、問題のタイプに応じて、以下の情報を追加で提供してください。

A. 位置決めに失敗するまたは不安定である

• Mega Toolbox または PC 版ツールを使用して同じ場所で検証を試み、結果を説明してください。
• 位置決めライブラリに読み込まれているマップが現在の物理空間と一致していることを確認してください。
• 問題が発生したおおよその位置（例：ショッピングモールの中庭、観光スポットの入り口）を説明してください。

B. コンテンツが表示されない

• 外部ツールを使用して位置決めを検証した結果を提供してください。
• コンテンツの配置やコードのロジックに問題がないことを明確にしてください。
• レンダリング問題の場合は、使用しているモデル、シェーダー、またはエフェクトのスクリーンショットまたは説明を提供してください。

C. コンテンツが揺れるまたはふらつく

• デバイスの移動方法（安定した移動/高速移動）を説明してください。
• 環境のテクスチャと照明状況、および非常に似た混同領域が存在するかどうかを説明してください。
• アプリ内部での姿勢の処理ロジックとコンテンツの配置が正しいことを説明してください。

D. ウィーチャットミニプログラムの問題

• ユーザーがウィーチャット内で Mega サービスの権限を有効にしたスクリーンショットを提供してください。
• ユーザーの携帯電話モデルがウィーチャット公式のサポートリストに含まれているかどうかを説明してください。
• ミニプログラムの AppID と具体的なビジネスシーンの説明を提供してください。

E. パフォーマンス問題 (カクツキ、高消費電力)

• 問題が発生したデバイスモデルを説明してください。
• 可能であれば、アプリケーションの実行時の CPU/GPU 使用率またはデバイスの温度情報を提供してください。
• 3D コンテンツの複雑さ（モデルの面数、テクスチャのサイズ）を説明してください。
• マルチ画像構成を使用しているかどうかを説明してください。

EasyAR Sense Unity Plugin を使用して Unity 開発情報をエクスポートする

特に、Unity プラットフォームでの Mega アプリケーション開発に関して、より便利なフィードバック情報生成ツールを用意しています。詳細な操作手順は以下の通りです。

1. メニューバーで EasyAR > Sense > 質問 を開きます。
   
2. 質問 で以下の情報を提供します。

• 実行環境を選択します（単一選択）。例えば、Android。
• デバイス情報をコピーします。ARSession で DiagnosticsController.DumpSession を Log に設定し、1 フレームの出力をコピーしてデバイス情報の入力欄に貼り付けます。
  
• あなたのアプリが使用しているすべての EasyAR 機能を選択します。複数選択可能です。
• ページ内の 4 つのチェックが完了したことを確認してチェックボックスにチェックを入れます。質問する際に、サンプルで問題を再現する方法を説明することをおすすめします。
• 右上のコピー機能をクリックすると、Unity 開発情報の収集が完了します。
  

報告の提出プロセスの提案

1. 材料を準備する：上記のリストに従って、EIF、ログ、スクリーンショット/画面録画、サービス情報、開発情報などを収集します。
2. 報告を作成する：問題を明確に説明し、すべての材料を添付します。
3. 提出する：選択したチャネルを通じて報告を提出します。
4. フォローアップする：私たちが報告を受け取った後、ビジネス担当者またはメールであなたに連絡します。ご留意ください。

あなたの時間と EasyAR Mega 製品へのサポートに感謝します！あなたのすべてのフィードバックは、私たちがより良い空間計算の未来を築くのに役立っています。