ブラウザーコンテンツのデバッグ
このページでは、ブラウザーのエクスペリエンスをデバッグできる様々な方法について説明します。
デバッグする前に、デバイスに接続しなければなりません。MQDH、USB、Wi-Fiを使用できます。
ブラウザーコンテンツのテストおよびデバッグには、
Meta Quest開発者ハブを使う方法が推奨されます。このハブには、デバイスを設定するツールやデスクトップキャスティングを有効にするツールなどがあります。MQDHのメインページに移動して、デバイスを接続するためのMQDHの設定手順をご覧ください。
USBデバッグ用にデバイスを構成するには、以下の手順を実行します。
開発者モードを有効にする前に、以下の前提条件が満たされていることを確認してください。
- 認証済みのMetaアカウントを持つ登録済みのMeta開発者である。アカウントステータスを確認するには、開発者ダッシュボードの[認証]をご覧ください。
- 18歳以上である。
- ヘッドセットには、開発者モードを有効にすることを妨げるデバイスレベルの制限がない。
開発者モードを有効にするには、以下の手順に従ってください。
モバイルデバイスで、Meta Horizonアプリを開きます。
アプリで、ツールバーにあるヘッドセットのアイコンをタップします。
画面上部に、ペアリングされたヘッドセットが表示されます。ヘッドセットアイテムをタップすると、ペアリングされているヘッドセットのモデルとステータスが表示されます。
ヘッドセットの画像の下にある[Headset Settings (ヘッドセット設定)]をタップします。
[Developer Mode (開発者モード)]をタップします。
[Developer Mode (開発者モード)]をオンの位置に切り替えます。
次の動画では、Meta Horizonアプリで開発者モードを有効にしています。
動画: Meta Horizonアプリで開発者モードをオンに切り替える。
USB-Cデータケーブルでヘッドセットをコンピューターに接続します。
ヘッドセットを装着します。
ヘッドセットで、[Quick Control (クイックコントロール)]メニュー項目を開きます。
歯車アイコンで表示されている[Open Settings (設定を開く)]を選択します。次に、[Developer (開発者)]タブを開き、[MTP Notification (MTP通知)]をオンに切り替えます。
USBデバッグの許可を求められたら、[Always allow from this computer (このコンピューターからは常に許可する)]を選択します。
接続後にコマンドシェルを開き、以下のように入力します。
デバイスが正しく接続されている場合、ADBにデバイスのIDリストが以下のように表示されます。
List of devices attached
ce0551e7 device
デバイスが検出されない場合、ADBは使用できません。ご使用のデバイスがリストにない場合、適切なUSBドライバーが存在しないことが考えられます。別のUSBケーブルやポートを試してみることもできます。
ADB Reverseを使ってQuestでローカルページを表示する
ADB Reverseを使用して、PCのローカルページをデバイス上で表示します。
一般的なウェブ開発のワークフローでは、デスクトップ上にローカルHTTPサーバーを設定し、localhostのポートを指すようにします。adb reverseを使用して、デバイスが自分のデスクトップに接続したままで、そのページをデバイスで使用できるようにします。
そのためには、コマンドadb reverse tcp:8080 tcp:8080を実行します。
8080を自分のHTTPサーバーが実行されているポート番号に置き換えます。
一般にはUSBでデバイスを接続するほうがTCP/IP接続よりも高速ですが、TCP/IP接続が必要になる場合もあります。
Wi-Fiデバッグを設定するには、以下の手順を実行します。
- 上記の「USBデバッグを有効にする」の手順を実行してから、USBケーブルを使用してデバイスをコンピューターに接続します。
- ADBツールをまだインストールしていない場合は、Androidプラットフォームツールをインストールします。
- ターミナルウィンドウまたはWindowsのコマンドプロンプトウィンドウを開きます。
- ADBツールがパスにない場合はadbツールを見つけます。Windowsの場合、通常は
C:\Users\{user}\AppData\Local\Android\sdk\platform-toolsにあります。その後、以下のコマンドでデバイスのIPアドレスを調べます。
出力は次のようになります。
10.0.30.0/19 dev wlan0 proto kernel scope link src 10.0.32.101
srcの後にあるのがデバイスのIPアドレスです。このIPアドレスとポート5555を使って、次のコマンドを発行します。
adb tcpip 5555
adb connect *<ipaddress>*:5555
以下はその例です。
> adb tcpip 5555
restarting in TCP mode port: 5555
> adb connect 10.0.32.101:5555
connected to 10.0.32.101:5555
ここで、デバイスをUSBポートから外すことができます。adb devicesに表示されるのが単一のデバイスである限り、すべてのADBコマンドはWi-Fi経由でそのデバイスに対して発行されます。
Wi-Fi接続の使用を停止するには、OSシェルから次のADBコマンドを発行します。
デバイス上でブラウザーを使って目的のWebサイトを表示した後、Chrome Developer Toolsを使用してそのサイトをリモートでデバッグできます。
リモートデバッグセッションを開始するには、以下の手順を実行します。
- デバイス上で、Browserを使って目的のウェブサイトを表示します。
- Google Chromeを起動します。
- chrome://inspect/#devicesにアクセスします。
- 使用しているデバイスを探します。デバイスの後には、現在デバイス上で開かれている一連のブラウザータブが表示されます。
- [Inspect (調査)]をクリックして、ブラウザーのタブのデバッグを開始します。
このページの情報は、Browserで2次元および没入型のWebXRエクスペリエンスをデバッグするためのものです。特に、没入型WebXRエクスペリエンスのデバッグ戦略に関する情報については、
WebXRワークフローをご覧ください。
デバイスの設定およびVRアプリのデバッグについて詳しくは、次をご覧ください。