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

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

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

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

1. نزِّل مشغّل Epic Games وثبِّته.

   1. من مشغّل Epic Games، ثبِّت الإصدار 5.6.x أو 5.8.x من Unreal Engine.

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

3. ثبِّت حزمة تطوير البرامج (SDK) لإصدار ‎.NET 8.0.

4. ثبِّت استوديو Android (الإصدار Rabbit 2 ‏ | 2026.2.2 Patch 1 أو إصدار أحدث).

تثبيت Android build support

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

1. افتح مشغّل Epic Games.

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

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

3. ثبِّت Java JDK 17.

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

   • منصات حزم تطوير البرامج (SDK): 34 و35 و36
   • ‫NDK: ‏ 29.0.x
   • أدوات سطر الأوامر (جميع العناصر)

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

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

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

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

1. افتح Unreal Engine (الإصدار 5.6.x أو 5.8.x).
2. ضمن فئات المشاريع الجديدة (New Project Categories)، اختَر نموذج الواقع الافتراضي (Virtual Reality).
3. في قائمة الإعدادات التلقائية للمشروع، اضبط المنصة المستهدفة على الأجهزة الجوّالة.
4. اضبط الإعدادات المسبقة للجودة على قابلة للتوسّع لتعزيز الأداء الأمثل على أجهزة الواقع الممتد (XR) الجوّالة.
5. اختَر اسمًا للمشروع، ثم انقر على إنشاء.

ضبط إعدادات Android

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

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

5. انتقِل للأسفل إلى قسم Build (الإنشاء) واختَر Support Vulkan (دعم Vulkan).

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

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

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

1. انتقِل إلى تعديل > إعدادات المشروع (Edit > Project Settings)، ثم إلى المحرّك > العرض (Engine > Rendering).

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

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

3. ضمن قسم الإعدادات التلقائية (Default Settings)، اضبط طريقة تنعيم الحواف (Anti-Aliasing Method) على MSAA.

4. ضمن قسم الأجهزة الجوّالة، اضبط تنعيم الحواف المتعدد العينات (MSAA) على الأجهزة الجوّالة على 4x.

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

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

   1. محو HDR على الأجهزة الجوّالة

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

   2. انقر على العرض المتعدّد على الأجهزة الجوّالة.

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

انظر أيضًا

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