Meta Quest 2、Quest 3、Quest 3S で XAPK バンドルと OBB アセットをサイドロードする方法
Meta Quest スタンドアロン VR ヘッドセット (Quest 2、Quest Pro、Quest 3、および Quest 3S) は、64 ビット Android (arm64-v8a) 上に構築された メタホライズンOS を実行します。 OBB アセット ファイルでパッケージ化された独自の Unreal Engine / Unity VR ビルドをテストする場合でも、正規の 2D Android ユーティリティをヘッドセットの 未知の情報源 ライブラリにサイドロードする場合でも、SideQuest と ADB は、最初に内部コンポーネントを分離またはマージすることなく、生の .xapk アーカイブを直接インストールすることはできません。
1. Meta Horizon OS のハードウェア要件 (64 ビット ARM のみ)
Qualcomm Snapdragon XR2 Gen 1 (Quest 2) および Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) は、厳密な 64 ビット Android ユーザーランドを実行します。パッケージをサイドロードする前に、次のことを行ってください。
- パッケージに arm64-v8a ネイティブ ライブラリ (または純粋な Java/Kotlin バイトコード) が含まれていることを確認してください。ファイルを デバイス ABI および DPI 互換性チェッカー にドロップすると、2 秒でこれを確認できます。
- Meta Horizon モバイル コンパニオン アプリの メニュー → デバイス → ヘッドセット設定 → 開発者モード で 開発者モード が有効になっていることを確認します。
2. SideQuest インストール用の分割 XAPK ユーティリティの変換
.xapk が分割 APK バンドル (base.apk、config.arm64_v8a.apk、config.xxhdpi.apk を含む) の場合:
- PC、Mac、または Meta Quest Browser 内で直接 XAPKSからAPKへの変換ツール を開きます。
- .xapk ファイルをドロップして、すべての分割を単一の v1+v2 署名付き .apk ファイルにマージします。
- PC または Mac の SideQuest (アドバンストインストーラー) で、上部バーの パソコン上のフォルダーからAPKファイルをインストール アイコンをクリックし、変換された .apk を選択します。
3. OBB 拡張ファイルを含む VR ビルドのデプロイ
多くのスタンドアロン VR エクスペリエンスと Unity ビルドは、コンパイルされたコードを base.apk に保持し、3D テクスチャとオーディオ バンクを main.<version>.<package>.obb 拡張ファイル内に保存します。 APK のみをインストールすると、ヘッドセットは無限の 3 点の読み込み画面に留まります。
- APK と OBB の両方を抽出します。 .xapk バンドルを OBB ファイルエクストラクター または XAPKアーカイブビューア にドロップして、.apk ファイルと .obb ファイルの両方をコンピューターにダウンロードします。
- APK をインストールし、ADB または SideQuest 経由で OBB をプッシュします。 Quest ヘッドセットを USB-C 経由で接続し、端末から次の 2 つのコマンドを実行します。
adb install base.apk adb shell mkdir -p /sdcard/Android/obb/com.studio.vrapp/ adb push main.100.com.studio.vrapp.obb /sdcard/Android/obb/com.studio.vrapp/
Meta Horizon OS 内でサイドロードされたアプリを起動する
インストールしたら、ヘッドセット内のユニバーサル メニューを開き、アプリライブラリ を開き、右上隅 (新しい Horizon OS ビルドでは左側のサイドバー) にあるフィルター ドロップダウンをクリックして、未知の情報源 を選択します。標準の 2D Android ユーティリティは、ホーム環境のフローティングでサイズ変更可能な曲面ウィンドウ内で自動的に開きます。