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

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

Unreal Engine يستند توافق مع تطوير الواقع الممتد إلى معيار OpenXR، ما يضمن التوافق التلقائي لميزات OpenXR المتوافقة مع Android XR في Unreal.

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

  • توافق Unreal Engine مع Android 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 Extensions for Unreal التوافق مع Android XR والإضافات الأخرى المحدّدة لمساعدتك في البدء بسرعة.

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

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

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

يوفّر Unreal Engine مستندات شاملة لـ تطوير التطبيقات وإنشائها ونشرها على Android. تتناول هذه المستندات إدارة أذونات Android ضمن المحرّك وضبط إعدادات إنشاء Android (من خلال Project Settings > Platforms > Android) واستخدام أداة Unreal Automation Tool (UAT).

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

إضافات Unreal Engine لنظام Android XR

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

إضافة Android XR OpenXR

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

حزمة Android XR Extensions for Unreal

تكمّل حزمة Android XR Extensions for Unreal التوافق الأساسي مع OpenXR، بما في ذلك الميزات الإضافية التي تساعدك في إنشاء تجارب غامرة، مثل بيانات شبكة اليد المتقدّمة وعمليات التحسين الخاصة بالأجهزة. للتعرّف على كيفية استيراد هذه الحزمة وضبطها، اتّبِع دليل البدء السريع لحزمة Android XR Extensions .

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

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

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

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

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

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

ملفات تعريف التفاعل

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

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

يتم توفير التفاعل باليد من خلال إضافة OpenXR Hand Tracking. يمكنك الوصول إلى بيانات مفاصل اليد ووضعياتها من خلال مكوّنات XR 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

Raycast

XR_ANDROID_raycast

حزمة Android XR Extensions for Unreal

العناصر القابلة للتتبُّع (المستويات/العمق)

XR_ANDROID_trackables

حزمة Android XR Extensions for Unreal

تتبُّع الأجسام

XR_ANDROID_trackables_object

حزمة Android XR Extensions for Unreal

Scene Meshing

XR_ANDROID_scene_meshing

حزمة Android XR Extensions for Unreal

تتبُّع الوجه

XR_ANDROID_face_tracking

حزمة Android XR Extensions for Unreal

تتبُّع العين

XR_ANDROID_eye_tracking

حزمة Android XR Extensions for Unreal

Passthrough Camera State

XR_ANDROID_passthrough_camera_state

حزمة Android XR Extensions for Unreal

Passthrough Mesh Layer

XR_ANDROID_composition_layer_passthrough_mesh

حزمة Android XR Extensions for Unreal

Depth Texture

XR_ANDROID_depth_texture

حزمة Android XR Extensions for Unreal

Light Estimation

XR_ANDROID_light_estimation

حزمة Android XR Extensions for Unreal

مقاييس الأداء

XR_ANDROID_performance_metrics

حزمة Android XR Extensions for Unreal

الدقة المقترَحة

XR_ANDROID_recommended_resolution

حزمة Android XR Extensions for Unreal

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

XR_EXT_hand_interaction

حزمة Android XR Extensions for Unreal

Debug Utils

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

Space Warp

XR_FB_space_warp

Unreal Native OpenXR

Equirect2 Composition Layer

XR_KHR_composition_layer_equirect2

Unreal Native OpenXR

إعدادات سلسلة محادثات Android

XR_KHR_android_thread_settings

Unreal Native OpenXR

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

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