إعداد مشروع Godot Engine

أجهزة XR المشمولة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.
مزيد من المعلومات حول أنواع أجهزة XR →
سماعات الرأس بنظام الواقع الممتد
نظارات سلكية بنظام الواقع الممتد
مزيد من المعلومات حول أنواع أجهزة XR →

يوضّح هذا الدليل بالتفصيل إصدارات المحرّك المقترَحة وحِزم SDK المطلوبة وإعدادات مشروع Android عند تطوير تطبيق Godot Engine لمنصة Android XR.

المتطلبات الأساسية

قبل أن تتمكّن من ضبط مشروع Godot Engine لتطوير تطبيقات Android XR، عليك استيفاء المتطلبات الأساسية التالية:

  1. نزِّل Godot 4.6.2 من الموقع الإلكتروني الرسمي لـ Godot.
  2. تأكَّد من توفُّر سمّاعة رأس بنظام الواقع الممتد أو بعض نظارات بنظام الواقع الممتد.
  3. ثبِّت "استوديو Android".

تثبيت دعم إصدار Android

يتطلّب Godot أدوات إصدار Android معيّنة لتجميع الحِزم وتصديرها للحوسبة المكانية.

  1. في "استوديو Android"، استخدِم SDK Manager لتثبيت الحِزم والأدوات التالية:

    • Android SDK Platform: Android 14.0 ("UpsideDownCake") (المستوى 34 لواجهة برمجة التطبيقات)
    • Android SDK Build-Tools: الإصدار 34.0.0 أو إصدار أحدث
    • NDK: أي إصدار 28.x
    • CMake: الإصدار 3.10.2

    قد تحتاج إلى النقر على عرض تفاصيل الحزمة في SDK Manager للاطّلاع على جميع الإصدارات المتاحة لإحدى الأدوات.

  2. في Godot، انتقِل إلى المحرّر > إعدادات المحرّر > التصدير > Android وقدِّم المسار إلى حزمة SDK.

إنشاء مشروع Godot XR

يمكنك إعداد مشروع جديد للعرض المكاني:

  1. افتح Godot وأنشِئ مشروعًا جديدًا.

  2. بالنسبة إلى المُصوِّر، اختَر الجهاز الجوّال.

    هذه هي واجهة برمجة التطبيقات للرسومات عالية الأداء التي تستخدم Vulkan أولاً والمقترَحة لمنصة Android XR.

    مربّع الحوار "إنشاء مشروع جديد" في Godot Engine

  3. اختَر أي خيارات أخرى تريدها، ثم انقر على إنشاء.

  4. أنشِئ مشهدًا داخليًا بنظام الواقع الممتد (بما في ذلك XROrigin3D وXRCamera3D) باستخدام دليل إعداد مشهد Godot XR الرسمي.

    إنشاء مشهد XR داخلي في مشروع Godot الجديد

ضبط إعدادات المشروع

بعد ذلك، عليك ضبط إعدادات المشروع لتفعيل OpenXR وضبط مسار العرض لتحسين الأداء على الأجهزة الجوّالة:

  1. افتح Godot.
  2. اضبط إعدادات المشروع التالية لـ OpenXR:
    • انتقِل إلى المشروع > إعدادات المشروع > XR > OpenXR ، ثم اختَر مفعَّلة.
    • انتقِل إلى المشروع > إعدادات المشروع > XR > التظليلات ، ثم اختَر مفعَّلة.

  3. انتقِل إلى العرض > منع التشويش > الجودة > MSAA 3D ، ثم اختَر 4x.

    يوفّر هذا الإعداد أفضل وضوح في Android XR.

إعداد مشروعك للتصدير إلى Android XR

أكمِل الخطوات التالية لإعداد مشروعك للتصدير إلى Android XR:

  1. إعداد إعدادات التصدير المُسبَقة: انتقِل إلى المشروع > التصدير وانقر على إضافة... > Android.

  2. إكمال دليل النشر: اتّبِع دليل نشر تطبيقات Android الرسمي من Godot للحصول على تعليمات مفصّلة حول الأذونات والنشر بنقرة واحدة.

  3. التحقّق من إصدارات حزمة SDK في مشروعك:

    • بالنسبة إلى الحد الأدنى لإصدار حزمة SDK: 34
    • بالنسبة إلى حزمة SDK المستهدَفة: 34

  4. ضبط وضع XR: اضبط وضع XR على OpenXR في إعدادات التصدير.

تثبيت المكوّن الإضافي Godot OpenXR Vendors

يجب أن يستخدم تطبيقك المكوّن الإضافي Vendors للوصول إلى الإضافات الخاصة بمنصة Android XR. اتّبِع الخطوات التالية للحصول على إصدار متوافق:

  1. في Godot، انقر على AssetLib.

  2. ابحث عن "Vendor".

    ابحث عن إصدارات مختلفة من إضافة Godot OpenXR Vendors من خلال البحث في "مكتبة مواد العرض في Godot".

  3. ابحث عن الإصدار 5.1 (أو إصدار أحدث) من المكوّن الإضافي Godot OpenXR Vendors plugin ونزِّله.

  4. بعد اكتمال عملية التنزيل، انقر على تثبيت.

    تثبيت المكوّن الإضافي Godot OpenXR Vendors

انظر أيضًا

لمزيد من المعلومات حول تطوير تطبيقات Android XR باستخدام Godot، اطّلِع على الصفحات التالية في مستندات Godot Engine: