نحوه بارگذاری جانبی بسته‌های XAPK و دارایی‌های OBB در Meta Quest 2، Quest 3 و Quest 3S

هدست‌های VR مستقل متا کوئست (Quest 2، Quest Pro، Quest 3 و Quest 3S) سیستم عامل متا هورایزن را اجرا می‌کنند که بر روی Android 64 بیتی (arm64-v8a) ساخته شده است. چه در حال آزمایش ساخت Unreal Engine / Unity VR خود باشید که با یک فایل دارایی OBB بسته بندی شده باشد یا یک ابزار Android 2 بعدی قانونی را در کتابخانه منابع ناشناخته هدست خود بارگذاری کنید، SideQuest و ADB نمی توانند یک آرشیو خام .xapk را مستقیماً بدون جداسازی یا ادغام اجزای داخلی آن نصب کنند.

1. الزامات سخت افزاری در سیستم عامل Meta Horizon (فقط ARM 64 بیتی)

Qualcomm Snapdragon XR2 Gen 1 (Quest 2) و Snapdragon XR2 Gen 2 (Quest 3 / Quest 3S) دارای یک سیستم کاربری سختگیرانه 64 بیتی Android هستند. قبل از تلاش برای بارگذاری جانبی هر بسته:

• اطمینان حاصل کنید که بسته حاوی کتابخانه های بومی arm64-v8a (یا بایت کد جاوا/کاتلین خالص است). با انداختن فایل خود در دستگاه بررسی سازگاری ABI و DPI ما می توانید این را در دو ثانیه تأیید کنید.
• مطمئن شوید که حالت توسعه دهنده در برنامه همراه همراه Meta Horizon تحت منو → دستگاه ها → تنظیمات هدست → حالت برنامه نویس فعال است.

2. تبدیل Split XAPK Utilities برای نصب SideQuest

اگر .xapk شما یک بسته APK تقسیم شده است (شامل base.apk، config.arm64_v8a.apk، و config.xxhdpi.apk:)

1. مبدل آنلاین XAPK به APK را روی رایانه شخصی، مک یا مستقیماً در مرورگر Meta Quest باز کنید.
2. فایل .xapk را رها کنید تا همه تقسیم‌ها در یک فایل .apk با امضای v1+v2 ادغام شوند.
3. در SideQuest (نصب کننده پیشرفته) در رایانه شخصی یا مک خود، روی نماد فایل APK را از پوشه روی رایانه نصب کنید در نوار بالا کلیک کنید و .apk تبدیل شده را انتخاب کنید.

3. استقرار ساخت‌های VR که شامل یک فایل توسعه OBB هستند

بسیاری از تجربیات VR مستقل و بیلدهای Unity کد کامپایل شده خود را در base.apk نگه می دارند و بافت های سه بعدی و بانک های صوتی را در یک فایل توسعه 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/

راه‌اندازی برنامه‌های Sideloaded Inside Meta Horizon OS

پس از نصب، منوی جهانی خود را در داخل هدست باز کنید، کتابخانه برنامه را باز کنید، روی منوی کشویی فیلتر در گوشه سمت راست بالا (یا نوار کناری سمت چپ در نسخه‌های جدیدتر Horizon OS) کلیک کنید و منابع ناشناخته را انتخاب کنید. ابزارهای استاندارد دو بعدی Android به طور خودکار در یک پنجره منحنی شناور و قابل تغییر اندازه در محیط خانه شما باز می شوند.