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

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

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

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

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

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

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

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

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

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

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

3. ثبِّت حزمة SDK للإصدار ‎.NET 8.0.

4. ثبِّت استوديو Android (الإصدار Panda 4 | 2025.3.4 من التصحيح 1 أو إصدارًا أحدث).

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

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

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

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

   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.1.
2. ضمن فئات المشاريع الجديدة ، اختَر نموذج الواقع الافتراضي.
3. في قائمة الإعدادات التلقائية للمشروع ، اضبط المنصّة المستهدَفة على الأجهزة الجوّالة.
4. اضبط الإعدادات المسبقة للجودة على قابلة للتوسيع لتحسين الأداء على أجهزة XR الجوّالة.
5. اختَر اسمًا للمشروع، ثم انقر على إنشاء.

ضبط إعدادات Android

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

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

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

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

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

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

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

2. ضمن قسم أداة العرض الأمامي ، اختَر التظليل الأمامي.

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

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

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

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

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

   1. أزِل العلامة من مربّع النطاق عالي الديناميكية على الأجهزة الجوّالة.

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

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

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

انظر أيضًا

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