تتيح لك ميزة "المعاينة المباشرة" اختبار التفاعلات المعقّدة وتكرارها مباشرةً داخل Unreal Editor باستخدام بيانات مباشرة من جهاز Android XR. باستخدام ميزة "المعاينة المباشرة"، يعرض الجهاز المضيف المحتوى ويصحّحه، ويبث منفذ العرض المرئي مباشرةً إلى جهاز Android XR الفعلي، ويبث إضافات OpenXR المتوافقة إلى الجهاز المضيف في الوقت الفعلي.
اتّبِع هذا الدليل لإعداد ميزة "المعاينة المباشرة" لمشروعك في Unreal Engine.
المتطلبات الأساسية
قبل البدء، تأكَّد من أنّ بيئة التطوير تستوفي المتطلبات التالية:
- إصدار Unreal Engine: Unreal Engine 5.6.1 أو إصدار أحدث
- إعداد المشروع: أكمِل جميع الخطوات في دليل إعداد مشروع Unreal Engine.
- Android XR Engine Hub: أكمل جميع الخطوات الواردة في قسم البدء من دليل Android XR Engine Hub لتثبيت جهازك المضيف وإعداده لاستخدام ميزة "المعاينة المباشرة".
الأجهزة:
- استخدام جهاز مضيف يعمل بنظام التشغيل Windows 11
- استخدِم بطاقة رسومات حديثة متوافقة مع Vulkan Video Encoding.
إعداد مكوّنات Android XR الإضافية
اضبط إعدادات Unreal Engine باستخدام المكوّنات الإضافية المطلوبة لنظام Android XR:
اتّبِع الخطوات الواردة في دليل البدء السريع في استخدام Android XR Extensions for Unreal Engine.
في وقت لاحق، إذا أنشأت مشروعًا جديدًا أو فتحت مشروعًا لم تستخدمه مع "المعاينة المباشرة"، اتّبِع الخطوات نفسها مرة أخرى.
تأكَّد من أنّ كل مشروع يتضمّن رابطًا رمزيًا إلى مجلد إضافات البائعين.
ضبط إعدادات المشروع
اضبط إعدادات مشروعك لبث "المعاينة المباشرة" باتّباع الخطوات التالية:
- انتقِل إلى إعدادات المشروع > المنصات > Windows.
- من RHI إلى Vulkan
- انتقِل إلى تعديل > الإضافات.
- فعِّل المكوّن الإضافي AndroidXRStreaming.
- انتقِل إلى تعديل > إعدادات المشروع > الوصف.
- فعِّل خيار البدء في الواقع الافتراضي.
تفعيل وقت تشغيل البث
بعد تفعيل المكوّن الإضافي AndroidXRStreaming في المشروع، تحقَّق مما إذا كان وقت تشغيل Android XR Streaming متوفّرًا:
- انتقِل إلى إعدادات المشروع > الإضافات > AndroidXRStreaming.
انقر على تفعيل البث على AndroidXR.
أعِد تشغيل Unreal Engine لتطبيق هذه التغييرات.
ضبط إعدادات برنامج البث
اضبط عميل البث باستخدام خيارات مختلفة لمشروعك:
- انتقِل إلى إعدادات المشروع > الإضافات.
في قسم AndroidXRStreamingClient، راجِع كل خيار من الخيارات التالية وفعِّله أو أوقِفه بما يتناسب مع احتياجات مشروعك:
- تشغيل العميل تلقائيًا عند المعاينة (Auto Start Client On Preview): عند تفعيل هذا الخيار، يتم تشغيل تطبيق العميل الخاص بالمعاينة على أي جهاز صالح ومحدّد عند النقر على بدء معاينة الواقع الافتراضي (Start VR Preview) من المحرّر.
- إيقاف العميل تلقائيًا عند المعاينة: عند تفعيل هذا الخيار، يتم إنهاء عميل المعاينة عند إيقاف معاينة الواقع الافتراضي من المحرّر.
- اختيار الجهاز المتوافق تلقائيًا: عند تفعيل هذا الخيار، يتم تلقائيًا اختيار أول جهاز متوافق متصل بالجهاز عند البحث عن الأجهزة.
- عرض مربّعات حوار الأخطاء: عند تفعيل هذا الخيار، يتم عرض مربّعات حوار أخطاء إضافية (على سبيل المثال، يتم عرض مربّع حوار خطأ إذا حاولت بدء معاينة الواقع الافتراضي بدون اختيار جهاز عميل). يمكنك إيقاف هذا الخيار لإخفاء مربّعات الحوار هذه.
- إعادة التحميل: عند تفعيل هذا الخيار، يبحث الزر إعادة التحميل عن الأجهزة المتصلة ويُدرِج الأجهزة المتوافقة (يتم تحديدها من خلال توفّر تطبيق Direct Preview في مركز Android XR Engine).
بدء "المعاينة المباشرة"
لبدء ميزة "المعاينة المباشرة" من Unreal Engine مباشرةً، اتّبِع الخطوات التالية:
وصِّل جهاز Android XR بجهازك المضيف باستخدام كابل USB-C عالي الجودة.
إذا لم يسبق لك استخدام هذا الجهاز مع ميزة "المعاينة المباشرة"، عليك ربط الجهاز وتكوينه لاستخدام ميزة "المعاينة المباشرة" في "مركز Android XR Engine" قبل بدء استخدام ميزة "المعاينة المباشرة" من خلال محرك الألعاب.
في Unreal Editor، انقر على تشغيل المستوى في الواقع الافتراضي (Play level in VR). لا تستخدِم الخيار المعتاد تشغيل في المحرِّر عند بدء "المعاينة المباشرة".