Jak sideload pakietów XAPK i zasobów OBB na Meta Quest 2, Quest 3 i Quest 3S

Samodzielne zestawy słuchawkowe VR Meta Quest (Quest 2, Quest Pro, Quest 3 i Quest 3S) obsługują System operacyjny Meta Horizon, który jest oparty na 64-bitowym systemie Android (arm64-v8a). Niezależnie od tego, czy testujesz własną kompilację Unreal Engine / Unity VR spakowaną z plikiem zasobów OBB, czy też ładujesz legalne narzędzie 2D dla systemu Android do biblioteki Nieznane źródła gogli, SideQuest i ADB nie mogą bezpośrednio zainstalować surowego archiwum .xapk bez uprzedniego oddzielenia lub połączenia jego wewnętrznych komponentów.

1. Wymagania sprzętowe systemu operacyjnego Meta Horizon (tylko 64-bitowy procesor ARM)

Qualcomm Snapdragon XR2 Gen 1 (Quest 2) i Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) działają w ścisłym 64-bitowym środowisku użytkownika Androida. Przed próbą bocznego załadowania dowolnego pakietu:

• Upewnij się, że pakiet zawiera natywne biblioteki arm64-v8a (lub jest czystym kodem bajtowym Java/Kotlin). Możesz to sprawdzić w ciągu dwóch sekund, upuszczając plik do naszego Sprawdzanie zgodności urządzeń ABI i DPI.
• Upewnij się, że Tryb programisty jest włączony w mobilnej aplikacji towarzyszącej Meta Horizon w obszarze Menu → Urządzenia → Ustawienia zestawu słuchawkowego → Tryb programisty.

2. Konwersja narzędzi Split XAPK do instalacji SideQuest

Jeśli Twój .xapk to podzielony pakiet APK (zawierający base.apk), config.arm64_v8a.apk i config.xxhdpi.apk:

1. Otwórz Konwerter XAPK na APK na komputerze PC, Mac lub bezpośrednio w przeglądarce Meta Quest.
2. Upuść plik .xapk, aby połączyć wszystkie podziały w jeden plik .apk podpisany v1+v2.
3. W SideQuest (zaawansowany instalator) na komputerze PC lub Mac kliknij ikonę Zainstaluj plik APK z folderu na komputerze na górnym pasku i wybierz przekonwertowany .apk.

3. Wdrażanie kompilacji VR zawierających plik rozszerzenia OBB

Wiele samodzielnych doświadczeń VR i kompilacji Unity przechowuje swój skompilowany kod w base.apk i przechowuje tekstury 3D i banki audio w pliku rozszerzenia main.<version>.<package>.obb. Jeśli zainstalujesz tylko pakiet APK, zestaw słuchawkowy pozostanie na nieskończonym ekranie ładowania z trzema kropkami.

1. Wyodrębnij zarówno APK, jak i OBB: Wrzuć swój pakiet .xapk do naszego Ekstraktor plików OBB lub Przeglądarka archiwum XAPK, aby pobrać zarówno plik .apk, jak i plik .obb na swój komputer.
2. Zainstaluj APK i wypchnij OBB przez ADB lub SideQuest: Podłącz zestaw słuchawkowy Quest przez USB-C i uruchom te dwa polecenia na terminalu:

   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/

Uruchamianie aplikacji ładowanych z boku w systemie Meta Horizon OS

Po zainstalowaniu otwórz uniwersalne menu w goglach, otwórz Biblioteka aplikacji, kliknij menu filtrów w prawym górnym rogu (lub lewym pasku bocznym w nowszych wersjach systemu Horizon OS) i wybierz Nieznane źródła. Standardowe narzędzia 2D Androida automatycznie otworzą się w pływającym, zakrzywionym oknie o zmiennym rozmiarze, w Twoim środowisku domowym.