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

أجهزة XR المشمولة

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

مزيد من المعلومات حول أنواع أجهزة XR →

مزيد من المعلومات حول أنواع أجهزة XR →

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

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

قبل إعداد Unreal Engine لتطوير تطبيقات Android XR، عليك تثبيت التطبيقات والأدوات التالية:

1. نزِّل Epic Games Launcher وثبِّته.

   1. من Epic Games Launcher، ثبِّت الإصدار 5.6.1 (أو إصدارًا أحدث) من Unreal Engine.

2. اضبط نظامك لإنشاء رمز C++ (على سبيل المثال، باستخدام Visual Studio 2022 لنظام التشغيل Windows أو Xcode لنظام التشغيل macOS). لمزيد من المعلومات، يُرجى الاطّلاع على إعداد بيئة تطوير C++ من Epic.

3. ثبِّت حزمة .NET 8.0 SDK.

4. ثبِّت "استوديو Android" (Quail 2 | 2026.1.2 أو إصدارًا أحدث).

تثبيت دعم إنشاء تطبيقات Android

بما أنّ Android XR يعتمد على إصدارات معيّنة من حزمة SDK، عليك تثبيت أدوات إنشاء تطبيقات Android الصحيحة إلى جانب Unreal Engine.

1. افتح Epic Games Launcher.

2. انقر على السهم المنسدل بجانب إصدار المحرّك المثبَّت (الزر "تشغيل") وانقر على الخيارات.

   1. انتقِل إلى خيارات التثبيت، وانقر على Android، و على تطبيق.
   2. إذا طُلب منك ذلك، اسمح للمحرّك بتسجيل أيّ امتدادات ملفات يتطلّبها.

3. ثبِّت Java JDK 17.

4. في "استوديو Android"، استخدِم أداة SDK Manager لتثبيت الإصدارات المحدّدة التالية التي تتطلّبها نماذج Android XR:

   • SDK Platforms: 34 و35 و36
   • **NDK**: 29.0.x
   • ‫Command-line Tools (جميع العناصر)

5. اتّبِع دليل الإعداد المتقدّم وحلّ المشاكل من Epic لـ ضبط متغيّرات بيئة النظام التالية:

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

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

بعد ذلك، أنشِئ مشروعًا جديدًا واضبطه باستخدام المكوّنات الإضافية والمدخلات اللازمة لنظام الواقع الممتد:

1. شغِّل Unreal Engine 5.6.1.
2. ضمن فئات المشاريع الجديدة ، اختَر نموذج الواقع الافتراضي.
3. في قائمة الإعدادات التلقائية للمشروع ، اضبط المنصة المستهدَفة على الأجهزة الجوّالة.
4. اضبط الإعدادات المسبقة للجودة على قابلة للتوسيع لتحسين الأداء على أجهزة XR الجوّالة.
5. اختَر اسمًا للمشروع، ثم انقر على إنشاء.

ضبط إعدادات Android

بعد فتح مشروعك، أكمل هذه الخطوات لضبط مستويات واجهة برمجة التطبيقات المطلوبة لإصدار Android وإعدادات الرسومات لمنصة Android XR:

1. انتقِل إلى تعديل > إعدادات المشروع.
2. انتقِل إلى المنصات > Android.
3. إذا كان الزر قبول ترخيص حزمة SDK مميّزًا باللون الأحمر، انقر عليه.
4. في قسم APKPackaging :
   • اضبط الحد الأدنى لإصدار حزمة SDK على 34.
   • اضبط الإصدار المستهدَف من حزمة SDK على 34 (أو إصدار أحدث).

5. انتقِل إلى قسم إنشاء وانقر على تفعيل Vulkan.

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

ضبط إعدادات العرض

لتحقيق معدّلات الإطارات العالية والوضوح البصري المطلوبَين لمنصة Android XR، عليك أيضًا ضبط Unreal Engine لاستخدام مسار العرض المحسَّن للأجهزة الجوّالة:

1. انتقِل إلى تعديل > إعدادات المشروع وانتقِل إلى المحرّك > العرض.

2. ضمن قسم Forward Renderer ، اختَر Forward Shading.

   إنّ أداء أداة العرض الأمامي أسرع بكثير من أداء أداة العرض المؤجّل التلقائية في الواقع الافتراضي على الأجهزة الجوّالة. يُرجى العِلم أنّ تفعيل هذه الميزة يتطلّب إعادة تشغيل المحرّر وتجميع التظليلات.

3. ضمن قسم الإعدادات التلقائية ، اضبط طريقة منع التعرّج على MSAA.

4. ضمن قسم الأجهزة الجوّالة ، اضبط Mobile MSAA على 4x.

   توفّر طريقة MSAA أوضح النتائج للواقع الافتراضي بدون تأثيرات التمويه الناتجة عن طريقة Temporal AA (TAA).

5. ضمن قسم الواقع الافتراضي:

   1. أزِل العلامة من Mobile HDR.

      يؤدي إيقاف النطاق عالي الديناميكية على الأجهزة الجوّالة إلى تقليل أعباء المعالجة اللاحقة بشكل كبير.

   2. انقر على Mobile Multi-View.

      يسمح ذلك للمحرّك بعرض كلتا العينَين في عملية واحدة، ما يحسّن أداء وحدة المعالجة المركزية بشكل كبير.

انظر أيضًا

للحصول على تعليمات مفصّلة حول نشر مشروع نموذج على جهاز يعمل بنظام التشغيل Android-powered ، يُرجى الرجوع إلى إعداد مشاريع Unreal Engine لتطوير تطبيقات Android.