التطوير باستخدام Unreal Engine لنظام Android XR

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

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

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

سماعات الرأس بنظام الواقع الممتد

نظارات سلكية بنظام الواقع الممتد

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

يعتمد توافق Unreal Engine مع تطوير تطبيقات الواقع الممتد على معيار OpenXR، ما يضمن أنّ ميزات OpenXR المتوافقة مع Android XR متوافقة بشكلٍ تلقائي مع Unreal.

اتّبِع هذا الدليل للتعرّف على ما يلي:

• توافق Unreal Engine مع Android XR
  • أساسيات الواقع الممتد (XR) في Unreal Engine
  • تطوير تطبيقات Android XR ونشرها
  • المكوّنات الإضافية لمحرّك Unreal Engine في Android XR
  • الحصول على الدعم
• الإدخال والتفاعل
• التنسيقات المتوافقة

توافق Unreal Engine مع Android XR

عند إنشاء تطبيقات Unreal لنظام Android XR، يمكنك الاستفادة من إمكانات الحوسبة المكانية في أحدث إصدارات Unreal Engine 5. يوفّر Unreal Engine 5 مواصفات OpenXR الأساسية، بينما توفّر إضافات Android XR في Unreal Engine مواصفات Android XR وإضافات أخرى محدّدة لمساعدتك في البدء بسرعة.

أساسيات الواقع الممتد (XR) في Unreal Engine

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

• إطار عمل الواقع الممتد: تعرَّف على كيفية إنشاء VR Pawn من خلال إرفاق مكوّن الكاميرا (الذي يمثّل سماعة الرأس) وإدخال اليد (الذي يمثّل اليدَين) بجذر مشهد مشترك.
• المكوّن الإضافي OpenXR: الواجهة الأساسية لدعم أجهزة Android XR
• بنية الواقع الممتد: كيفية تعامل Unreal مع حزمة التكنولوجيا والأنظمة الفرعية للواقع الممتد
• إعداد المشروع: ضبط .uproject للعرض المكاني
• إرشادات الرسومات: استخدام العرض المرتكز على العين والعرض المتعدد النوافذ وتظليل المعدل المتغيّر (VRS)
• الأداء والتحليل: أدوات وأساليب لتحسين تطبيق XR
• أفضل الممارسات: إرشادات التصميم والتطوير لإنشاء تجارب واقع ممتد مريحة وغامرة

تطوير تطبيقات Android ونشرها

يوفّر Unreal Engine مستندات شاملة حول تطوير الألعاب وإنشائها ونشرها على Android. يتناول هذا المستند إدارة أذونات Android داخل المحرّك، وضبط إعدادات إصدار Android (من خلال "إعدادات المشروع" > "المنصات" > Android)، واستخدام أداة Unreal Automation Tool‏ (UAT).

بالإضافة إلى ذلك، يمكنك الاطّلاع على مستندات تجميع تطبيقات Android XR وتوزيعها لمعرفة المتطلبات المحدّدة التي تنطبق على التطبيقات المكانية التي يتم توزيعها على "متجر Google Play". يجب التأكّد من أنّ تطبيقك يلتزم أيضًا بإرشادات الجودة للتجارب الغامرة لتقديم تجربة مستخدم متّسقة ومريحة على Android XR.

المكوّنات الإضافية لمحرّك Unreal Engine في Android XR

يتوفّر مكوّنان إضافيان أساسيان يتيحان إنشاء تطبيقات Unreal لنظام Android XR. تتم إدارة هذه المكوّنات الإضافية من خلال قائمة "المكوّنات الإضافية" (تعديل > المكوّنات الإضافية).

المكوّن الإضافي Android XR OpenXR

المكوّن الإضافي Android XR OpenXR هو واجهة المحرّك الأساسية التي تضيف ميزات Android XR إلى Unreal. وتنفّذ إضافات OpenXR المطلوبة للتتبُّع المكاني وفهم البيئة والإدراك. لمعرفة كيفية إضافة هذا المكوّن الإضافي وضبطه، يُرجى الرجوع إلى مستندات Unreal Engine OpenXR.

إضافات Android XR لـ Unreal

تُكمّل إضافات Android XR لمحرّك Unreal (الإصدار 1.1.0 المتوافق مع الإصدارَين 5.6.x و5.8.x من Unreal Engine) ميزات OpenXR الأساسية، بما في ذلك ميزات إضافية لمساعدتك في إنشاء تجارب غامرة، مثل الكيانات المكانية، وتتبُّع الأشعة المكانية والعميقة، وتمويه إطار العرض، وخريطة المكعب لتقدير الإضاءة، وبيانات شبكة اليد المتقدّمة، وتحسينات محدّدة للأجهزة. للتعرّف على كيفية استيراد هذه الحزمة وضبطها، اتّبِع دليل البدء السريع لإضافات Android XR أو اطّلِع على مرجع واجهة برمجة التطبيقات لإضافات Android XR في Unreal.

الحصول على الدعم

إذا واجهت مشاكل، يمكنك الاطّلاع على قسم الدعم الخاص بـ Unreal Engine على صفحة الدعم لدينا للحصول على المساعدة.

الإدخال والتفاعل

يتطلب إنشاء تجارب مكانية تفاعلية ربط الحركات الجسدية بالإجراءات الرقمية. يستخدم Unreal Engine نظام الإدخال المحسّن مع OpenXR للتعامل مع كل من وحدات التحكّم في الحركة وتتبُّع اليد. من خلال إعداد "إجراءات الإدخال" (Input Actions) و"سياقات ربط الإدخال" (Input Mapping Contexts)، يمكنك إنشاء تفاعلات مرنة، مثل الإمساك والإشارة والتنقّل في واجهة المستخدم، تعمل بسلاسة على مختلف طرق الإدخال في Android XR.

للحصول على دليل شامل حول إنشاء هذه الآليات، يُرجى الرجوع إلى مستندات Unreal Engine حول إنشاء تجارب XR تفاعلية.

يتيح Android XR طرق التفاعل المحدّدة التالية في Unreal Engine:

الملفات الشخصية للتفاعل

يمكنك ضبط الملفات الشخصية للتفاعل في "إعدادات المشروع" (Project Settings) ضمن قسم OpenXR. يتيح ذلك لتطبيقك الحفاظ على اتساق تعيين الإدخال عبر وحدات التحكم وطرق التتبع المختلفة.

التفاعل باليد

يتم توفير التفاعل باليد من خلال إضافة OpenXR Hand Tracking. يمكنك الوصول إلى بيانات مفاصل اليد ووضعياتها من خلال مكوّنات تتبُّع الواقع الممتد في Blueprints أو C++.

التفاعل من خلال تتبُّع النظر

يمكن استرداد بيانات نظرات العين كوضعية إدخال معيارية، ما يتيح لك التحكّم في تركيز واجهة المستخدم أو ميزات الحضور الاجتماعي. يتطلّب هذا الإجراء إذن "android.permission.EYE_TRACKING_FINE".

تتبُّع الوجه

يمكنك الوصول إلى بيانات تعبيرات الوجه في الوقت الفعلي لتحريك الصور الرمزية أو تعزيز التفاعلات الاجتماعية. يتم استخدام إضافة XR_ANDROID_face_tracking لإجراء ذلك.

التنسيقات المتوافقة

تتوفّر إضافات OpenXR التالية عند تطوير تطبيقات Android XR في Unreal:

الميزة أو الإمكانية	سلسلة إضافة OpenXR	موفِّر حِزمة SDK
استمرار ظهور نقاط الارتكاز على الجهاز	XR_ANDROID_device_anchor_persistence	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
Raycast	XR_ANDROID_raycast	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
العناصر القابلة للتتبُّع (المستويات/العمق)	XR_ANDROID_trackables	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
تتبُّع العناصر	XR_ANDROID_trackables_object	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
Scene Meshing	XR_ANDROID_scene_meshing	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
تتبُّع تعابير الوجه	XR_ANDROID_face_tracking	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
تتبُّع العين	XR_ANDROID_eye_tracking	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
حالة الكاميرا في وضع "الرؤية من خلال النظارة"	XR_ANDROID_passthrough_camera_state	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
طبقة شبكة العرض	XR_ANDROID_composition_layer_passthrough_mesh	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
Depth Texture	XR_ANDROID_depth_texture	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
تقدير الإضاءة	XR_ANDROID_light_estimation	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
خريطة مكعّبة لتقدير الإضاءة	XR_ANDROID_light_estimation_cubemap	إضافات Android XR Extensions for Unreal (الإصدار 1.1.0)
مقاييس الأداء	XR_ANDROID_performance_metrics	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
الحلّ المقترَح	XR_ANDROID_recommended_resolution	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
التفاعل باليد	XR_EXT_hand_interaction	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
أدوات تصحيح الأخطاء	XR_EXT_debug_utils	Unreal Native OpenXR
إعدادات الأداء	XR_EXT_performance_settings	Unreal Native OpenXR
معدّل تحديث الشاشة	XR_FB_display_refresh_rate	Unreal Native OpenXR
Hand Tracking Mesh	XR_FB_hand_tracking_mesh	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
Space Warp	XR_FB_space_warp	Unreal Native OpenXR
طبقة تركيب Equirect2	XR_KHR_composition_layer_equirect2	Unreal Native OpenXR
إعدادات Thread على Android	XR_KHR_android_thread_settings	Unreal Native OpenXR
التعتيم العام في وضع "الرؤية من خلال النظارة"	XR_ANDROID_global_passthrough_dimming	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
خصائص إضافات النظام	XR_ANDROID_enumerate_system_extension_properties	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
الكيانات المكانية	XR_EXT_spatial_entity	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
تتبُّع المستوى المكاني	XR_EXT_spatial_plane_tracking	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
تتبُّع العلامات المكانية	XR_EXT_spatial_marker_tracking	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
المثبّتات المكانية والثبات	XR_EXT_spatial_anchor، XR_EXT_spatial_persistence	إضافات Android XR Extensions for Unreal (الإصدار 1.0.0)
Viewport Feathering	XR_ANDROID_viewport_feathering	إضافات Android XR Extensions for Unreal (الإصدار 1.1.0)
الاستكشاف المكاني وDepth Raycast	XR_ANDROID_spatial_discovery_raycast	إضافات Android XR Extensions for Unreal (الإصدار 1.1.0)

يتم توفير الإضافات من أحد المصادر التالية:

• إضافات Android XR لمحرّك Unreal: هي إضافات خاصة بـ Google (ANDROID) وإضافات للكيانات المكانية (EXT) تم تطويرها لمنصة Android XR. للاستفادة من هذه الإمكانات المكانية، عليك تثبيت المكوّن الإضافي "إضافات Android XR" وتفعيله في .uproject والاطّلاع على مرجع واجهة برمجة التطبيقات "إضافات Android XR" لـ Unreal لاستخدام Blueprint وC++.
• ميزات Unreal Native OpenXR: تستفيد هذه الميزات من الإضافات العادية Khronos (KHR) وExtension (EXT) وMeta (FB) المدمجة والمُدارة مباشرةً ضمن المكوّن الإضافي الأساسي OpenXR في Unreal Engine.

ملاحظة: يتوفّر كل من XR_ANDROID_device_anchor_persistence (AndroidXRAnchorPersistence) وXR_EXT_spatial_anchor / XR_EXT_spatial_persistence (AndroidXRSpatialAnchors) كبديلَين متوافقَين في الإصدار 1.1.0 والإصدارات الأحدث. بالنسبة إلى المشاريع التي تستخدم بنية الكيانات المكانية (XR_EXT_spatial_entity)، استخدِم XR_EXT_spatial_anchor وXR_EXT_spatial_persistence.