Cara Sideload Bundel XAPK dan Aset OBB di Meta Quest 2, Quest 3 & Quest 3S

Headset VR mandiri Meta Quest (Quest 2, Quest Pro, Quest 3, dan Quest 3S) menjalankan OS Meta Horizon, yang dibuat pada Android 64-bit (arm64-v8a). Baik Anda menguji build Unreal Engine / Unity VR Anda sendiri yang dikemas dengan file aset OBB atau melakukan sideload utilitas Android 2D yang sah ke perpustakaan Sumber Tidak Dikenal headset Anda, SideQuest dan ADB tidak dapat menginstal arsip .xapk mentah secara langsung tanpa terlebih dahulu memisahkan atau menggabungkan komponen internalnya.

1. Persyaratan Perangkat Keras pada Meta Horizon OS (Khusus ARM 64-Bit)

Qualcomm Snapdragon XR2 Gen 1 (Quest 2) dan Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) menjalankan sistem pengguna Android 64-bit yang ketat. Sebelum mencoba melakukan sideload paket apa pun:

• Pastikan paket berisi pustaka asli arm64-v8a (atau bytecode Java/Kotlin murni). Anda dapat memverifikasi ini dalam dua detik dengan memasukkan file Anda ke Pemeriksa Kompatibilitas ABI & DPI Perangkat kami.
• Pastikan Mode Pengembang diaktifkan di aplikasi pendamping seluler Meta Horizon di bawah Menu → Perangkat → Pengaturan Headset → Mode Pengembang.

2. Mengonversi Utilitas XAPK Terpisah untuk Instalasi SideQuest

Jika .xapk Anda adalah paket APK terpisah (berisi base.apk), config.arm64_v8a.apk, dan config.xxhdpi.apk:

1. Buka Konverter XAPKS ke APK di PC, Mac, atau langsung di dalam Meta Quest Browser.
2. Letakkan file .xapk untuk menggabungkan semua pemisahan menjadi satu file .apk bertanda tangan v1+v2.
3. Di SideQuest (Penginstal Tingkat Lanjut) pada PC atau Mac Anda, klik ikon Instal file APK dari folder di komputer di bilah atas dan pilih .apk yang dikonversi.

3. Menerapkan Build VR yang Menyertakan File Ekspansi OBB

Banyak pengalaman VR mandiri dan build Unity menyimpan kode kompilasinya di base.apk dan menyimpan tekstur 3D dan bank audio di dalam file ekspansi main.<version>.<package>.obb. Jika Anda hanya menginstal APK, headset akan tetap berada di layar pemuatan tiga titik tanpa batas.

1. Ekstrak APK dan OBB: Letakkan bundel .xapk Anda ke Ekstraktor File OBB atau Penampil Arsip XAPK kami untuk mengunduh file .apk dan .obb ke komputer Anda.
2. Instal APK & Dorong OBB melalui ADB atau SideQuest: Hubungkan headset Quest Anda melalui USB-C dan jalankan dua perintah ini dari terminal Anda:

   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/

Meluncurkan Aplikasi yang Di-sideload di dalam Meta Horizon OS

Setelah terinstal, buka menu universal Anda di dalam headset, buka Perpustakaan Aplikasi, klik dropdown filter di sudut kanan atas (atau sidebar kiri pada versi Horizon OS yang lebih baru), dan pilih Sumber Tidak Dikenal. Utilitas Android 2D standar akan otomatis terbuka di dalam jendela melengkung yang mengambang dan dapat diubah ukurannya di lingkungan rumah Anda.