إعداد مشروع 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) الخاصة بإصدار ‎8.0 من.NET.

4. ثبِّت استوديو Android (الإصدار Quail 4 | 2026.1.4 أو إصدار أحدث).

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

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

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

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

   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

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

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

ضبط إعدادات Android

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

انظر أيضًا

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