Як завантажувати пакети XAPK і ресурси OBB у Meta Quest 2, Quest 3 і Quest 3S

Окремі VR-гарнітури Meta Quest (Quest 2, Quest Pro, Quest 3 і Quest 3S) працюють під керуванням ОС Meta Horizon, створеного на 64-розрядній ОС Android (arm64-v8a. Незалежно від того, чи тестуєте ви свою власну збірку Unreal Engine / Unity VR, укомплектовану файлом активів OBB, чи завантажуєте легітимну 2D-утиліту Android у бібліотеку Невідомі джерела вашої гарнітури, SideQuest і ADB не можуть встановити необроблений архів .xapk) безпосередньо, попередньо не відокремивши або не об’єднавши його внутрішні компоненти.

1. Вимоги до обладнання для ОС Meta Horizon (лише 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 пристрою.
• Переконайтеся, що Режим розробника увімкнено в додатку Meta Horizon для мобільних пристроїв у розділі Меню → Пристрої → Налаштування гарнітури → Режим розробника.

2. Перетворення утиліт Split XAPK для встановлення SideQuest

Якщо ваш .xapk є пакетом split-apk (містить base.apk), config.arm64_v8a.apk і config.xxhdpi.apk:

1. Відкрийте Конвертер XAPK в APK на ПК, Mac або безпосередньо в браузері Meta Quest.
2. Відпустіть файл .xapk, щоб об’єднати всі розбиття в один підписаний файл .apk v1+v2.
3. У SideQuest (розширений інсталятор) на ПК або Mac клацніть піктограму Встановіть файл APK з папки на комп'ютері у верхній панелі та виберіть перетворений .apk.

3. Розгортання збірок VR, які включають файл розширення OBB

Багато автономних інтерфейсів віртуальної реальності та збірок Unity зберігають свій скомпільований код у base.apk і зберігають 3D-текстури та аудіобанки у файлі розширення main.<version>.<package>.obb. Якщо ви встановите лише APK, гарнітура залишатиметься на нескінченному екрані завантаження з трьома крапками.

1. Розпакуйте APK і OBB: Додайте свій пакет .xapk до нашого Екстрактор файлів OBB або Засіб перегляду архівів XAPK, щоб завантажити файли .apk і .obb на свій комп’ютер.
2. Встановіть APK і надішліть OBB через ADB або SideQuest: Підключіть гарнітуру Quest через USB-C і виконайте ці дві команди з терміналу:

   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

Після встановлення відкрийте своє універсальне меню всередині гарнітури, відкрийте Бібліотека програм, клацніть розкривне меню фільтрів у верхньому правому куті (або лівій бічній панелі в новіших збірках ОС Horizon) і виберіть Невідомі джерела. Стандартні 2D-утиліти Android автоматично відкриються у плаваючому зігнутому вікні зі змінним розміром у вашому домашньому середовищі.