تتيح لك ميزة "المعاينة المباشرة" (Direct Preview) اختبار التفاعلات المعقّدة وتكرارها مباشرةً داخل Unreal Editor باستخدام بيانات مباشرة من جهاز Android XR. باستخدام ميزة "المعاينة المباشرة"، يعرض الجهاز المضيف المحتوى ويصحّح أخطاءه، ويبثّ إطار العرض المرئي مباشرةً إلى جهاز Android XR المادي، ويبثّ إضافات OpenXR المتوافقة إلى الجهاز المضيف في الوقت الفعلي.
اتّبِع هذا الدليل لإعداد ميزة "المعاينة المباشرة" لمشروعك في Unreal Engine.
المتطلبات الأساسية
قبل البدء، تأكَّد من أنّ بيئة التطوير تستوفي المتطلبات التالية:
- إصدار Unreal Engine: 5.6.x أو 5.8.x.
- إعداد المشروع: أكمِل جميع الخطوات الواردة في دليل إعداد مشروع Unreal Engine.
- مركز التحكم بمحركات Android XR: أكمِل جميع الخطوات الواردة في قسم البدء من دليل "مركز التحكم بمحركات Android XR" لتثبيت جهازك المضيف وضبطه لاستخدام ميزة "المعاينة المباشرة".
الأجهزة:
- استخدِم جهازًا مضيفًا يعمل بنظام التشغيل Windows 11.
- استخدِم بطاقة رسومات حديثة متوافقة مع ترميز الفيديو Vulkan.
إعداد المكوّنات الإضافية في Android XR
اضبط إعدادات Unreal Engine باستخدام المكوّنات الإضافية المطلوبة في Android XR:
اتّبِع الخطوات الواردة في دليل البدء السريع لاستخدام إضافات Android XR في Unreal Engine.
لاحقًا، إذا أنشأت مشروعًا جديدًا أو فتحت مشروعًا لم تستخدمه مع ميزة "المعاينة المباشرة"، اتّبِع الخطوات نفسها مرة أخرى.
لكل مشروع، تأكَّد من أنّه يتضمّن رابطًا رمزيًا إلى مجلد المكوّنات الإضافية للمورّد.
ضبط إعدادات المشروع
اضبط إعدادات مشروعك لبث "المعاينة المباشرة":
- انتقِل إلى إعدادات المشروع (Project Settings) > الأنظمة الأساسية (Platforms) > نظام التشغيل Windows.
- RHI إلى Vulkan:
- انتقِل إلى تعديل > المكوّنات الإضافية (Edit > Plugins).
- فعِّل المكوّن الإضافي AndroidXRStreaming.
- انتقِل إلى تعديل > إعدادات المشروع > الوصف.
- فعِّل خيار البدء في الواقع الافتراضي (Start In VR).
تفعيل بيئة تشغيل البث
بعد تفعيل المكوّن الإضافي AndroidXRStreaming في المشروع، تحقَّق من توفّر وقت تشغيل Android XR Streaming:
- انتقِل إلى إعدادات المشروع (Project Settings) > المكوّنات الإضافية (Plugins) > AndroidXRStreaming.
انقر على تفعيل بث AndroidXR.
أعِد تشغيل Unreal Engine لتطبيق هذه التغييرات.
ضبط إعدادات برنامج البث
اضبط عميل البث باستخدام خيارات مختلفة لمشروعك:
- انتقِل إلى إعدادات المشروع > المكوّنات الإضافية.
في قسم AndroidXRStreamingClient، راجِع كل خيار من الخيارات التالية وفعِّله أو أوقِفه بما يتناسب مع احتياجات مشروعك:
- بدء تشغيل العميل تلقائيًا في المعاينة: عند تفعيل هذا الخيار، يتم تشغيل تطبيق العميل للمعاينة على أي جهاز صالح ومحدّد عند النقر على بدء معاينة الواقع الافتراضي من المحرِّر.
- إيقاف العميل تلقائيًا عند المعاينة: عند تفعيل هذا الخيار، يتم إنهاء عميل المعاينة عند إيقاف معاينة الواقع الافتراضي من المحرِّر.
- الاختيار التلقائي للجهاز المتوافق: عند تفعيل هذا الخيار، يتم تلقائيًا اختيار أول جهاز متوافق متصل بالجهاز عند البحث عن الأجهزة.
- عرض مربّعات حوار الخطأ: عند تفعيل هذا الخيار، يتم عرض مربّعات حوار خطأ إضافية (على سبيل المثال، يظهر مربّع حوار خطأ إذا حاولت بدء معاينة الواقع الافتراضي بدون اختيار جهاز عميل). يمكنك إيقاف هذا الخيار لإخفاء مربّعات الحوار هذه.
- إعادة تحميل: عند تفعيل هذا الخيار، يبحث زر إعادة تحميل عن الأجهزة المتصلة ويعرض الأجهزة المتوافقة (يتم تحديدها من خلال توفّر تطبيق العميل "المعاينة المباشرة" في مركز التحكم بمحركات Android XR).
بدء المعاينة المباشرة
ابدأ ميزة "المعاينة المباشرة" (Direct Preview) للبث مباشرةً من Unreal Engine:
وصِّل جهاز Android XR بالجهاز المضيف باستخدام كابل USB-C عالي الجودة.
إذا لم يسبق لك استخدام هذا الجهاز مع ميزة "المعاينة المباشرة"، عليك توصيل الجهاز وضبطه لاستخدام الميزة في "مركز التحكم بمحركات Android XR" قبل بدء "المعاينة المباشرة" من خلال محرّك اللعبة.
في Unreal Editor، انقر على Play level in VR (تشغيل المستوى في الواقع الافتراضي). لا تستخدِم خيار Play in Editor (تشغيل في المحرِّر) المعتاد عند بدء ميزة "المعاينة المباشرة".