現場検証・診断ツール
Mega Toolbox（ミニプログラム）の定位設定、実行画面、異常データの報告方法を説明します。マスクファイルでモデルと実環境の位置合わせを検証したり、注釈データを読み込んで仮想コンテンツの配置を確認したりできます。
開始する前に
- ツールの概要に従ってクラウド定位データベース、EasyAR アカウント、スマートフォンを用意し、対象 Block の現場に移動します。
- マスクファイルを使う場合は Block のマッピングバージョンが 9.6 以降である必要があります。Block 詳細ページで確認します。
- 注釈を使う場合は、まず現場検証用の注釈データを作成し、パッケージが対象データベースに属することを確認します。注釈を使わない場合、この手順は不要です。
現場での操作例はミニプログラムの実行結果を参照してください。
ツールを開く
WeChat で次のミニプログラムコードを読み取り、Mega Toolbox を開きます。
アカウントにログイン
対象のクラウド定位データベースにアクセスできる EasyAR Developer Center アカウントでログインします。図の番号はユーザー名、パスワード、ログインボタンを示します。
- ユーザー名を入力します。
- パスワードを入力します。
ログインをタップします。
データベースと注釈を選択
対象のクラウド定位データベースを選択し、必要に応じて注釈データパッケージを選んで 開始 をタップします。図の設定項目は次のとおりです。
| 番号 | 設定項目 | 説明 |
|---|---|---|
| 1 | クラウド定位データベース | 対象 Block を含むデータベースを選択します。リストには「サービスグループ名 | データベース名」と表示されます。 |
| 2 | アドレスを変更 |
通常はオフのままにします。海外サービスなど別のアドレスが必要な場合は、実際のサービス設定に合わせます。 |
| 3 | 現場外テスト |
実環境でのテストではオフにします。現場写真などを使う場合のみオンにします。 |
| 4 | コールドスタートテスト |
コールドスタート専用のテストに使います。通常の現場検証ではオフにします。 |
| 5 | 注釈データパッケージ | 読み込むパッケージを選択します。定位やマスクファイルのみを検証する場合は 注釈を使用しない を選びます。 |
| 6 | 注釈名を表示 |
注釈を読み込むとき、必要に応じて名前を表示します。 |
| 7 | 開始 |
現在の設定で定位ページを開きます。 |
初めて定位ページに入るときは、WeChat の案内に従ってカメラと位置情報の権限を許可します。
定位画面を開く
明るく模様が豊かな領域にカメラを向け、スマートフォンを一定の速度で動かし、WeChat の平面検出の初期化を待ちます。Mega 定位 をオンにしたままクラウド定位の結果を待ちます。
定位結果と操作項目を確認
Debug 情報 をオンにすると、端末、シーン、リクエスト、定位結果を確認できます。図は定位成功後に注釈を読み込んだ画面です。注釈を使用しない場合、立方体は表示されません。
| 番号 | 操作項目または情報 | 説明 |
|---|---|---|
| 1 | Debug 情報 |
デバッグ情報パネルの表示を切り替えます。 |
| 2 | ログを記録 |
実行ログの記録を開始または停止します。停止後、WeChat の共有画面で送信先を選んでファイルをエクスポートします。 |
| 3 | データを記録 |
dump データの記録を開始または停止します。停止後、WeChat の共有画面で送信先を選びます。 |
| 4 | 詳細オプション |
詳細オプションの表示を切り替えます。 |
| 5 | Mega 定位 |
Mega クラウド定位を開始または停止します。 |
| 6 | クラウド定位結果 | status、応答時間、定位された Block などを確認します。 |
| 7 | 定位履歴 | Sequence の N は未読み込み、S は成功、F は失敗を示します。Status ボタンは成功時に緑、失敗時に白です。 |
主な結果と対処方法：
| 結果 | 意味と対処 |
|---|---|
Found |
対象 Block への定位に成功しました。マスクメッシュや注釈を実環境と比較して位置合わせを確認します。 |
Not Found |
今回のリクエストでは対象 Block が見つかりませんでした。現場にいること、Block がデータベースに追加済みであること、カメラが模様の豊かな領域を向いていることを確認します。続く場合は定位失敗の対処を参照してください。 |
QpsLimitExceeded |
クラウドサービスグループの QPS 上限を超えました。QPS の見積もりと拡張を参照してください。 |
UnKnownError |
ネットワーク、データ転送、サービス応答に問題がある可能性があります。定位失敗の対処に従い、必要に応じてログとデータを記録してください。 |
マスクファイルを表示
マスクファイルに対応する Block への定位に成功したら マスクファイル をオンにします。ミニプログラムがメッシュを自動的に読み込み、表示します。手動ダウンロードや注釈の作成は不要です。
| 番号 | 操作項目 | 説明 |
|---|---|---|
| 8 | マスクファイル |
マスクメッシュの表示を切り替えます。 |
| 9 | 不透明度スライダー | メッシュの不透明度を 0%～100% に調整し、カメラ映像と比較します。 |
地面と垂直面は異なる色で表示され、メッシュには自己遮蔽があります。壁、床、継ぎ目、角の位置合わせと、スマートフォンを動かしたときの揺れやドリフトを確認します。例はマスクファイルを参照してください。
メッシュが表示されない場合は、対象 Block への定位成功、マッピングバージョン、スイッチ、不透明度が 0% より大きいことを確認し、リソースの読み込みを待ちます。
注釈を確認
開始前に注釈パッケージを選択した場合、定位後に実環境でその内容を確認できます。注釈の立方体は定位成功時に白い MEGA テクスチャ、失敗時に灰色で表示されます。
注釈を作成したときの実際の位置と比較します。定位失敗と定位後の揺れ・ドリフトを区別し、後者についてはトラッキングの問題を参照してください。
異常な定位データを報告
定位失敗、位置ずれ、揺れ、ドリフトが発生したら、問題の再現中にログと dump データを同時に記録します。ファイルの共有時には送信先を手動で選択します。
定位ページで
ログを記録とデータを記録をオンにします。記録開始を確認して問題を再現します。問題を再現したら
データを記録をオフにして記録を停止します。
WeChat の共有画面で
File Transfer Assistantを選び、データファイルを保存します。
定位ページに戻って
ログを記録をオフにし、WeChat でログも保存します。ページを離れる前に記録とエクスポートを完了してください。データ、ログ、問題の説明を EasyAR 技術サポートに提供します。データベースと Block、テスト時刻、機種、OS と WeChat のバージョン、症状、再現手順を含めます。スクリーンショットや録画も役立ちます。
dump データの記録とエクスポートについては、Mega Toolbox で dump ファイルを記録を参照してください。