إعداد ميزة "المعاينة المباشرة" في Unreal Engine

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

تتيح لك ميزة "المعاينة المباشرة" اختبار التفاعلات المعقّدة وتكرارها مباشرةً داخل Unreal Editor باستخدام بيانات مباشرة من جهاز Android XR. باستخدام ميزة "المعاينة المباشرة"، يعرض الجهاز المضيف المحتوى ويصحّحه، ويبث منفذ العرض المرئي مباشرةً إلى جهاز Android XR الفعلي، ويبث إضافات OpenXR المتوافقة مرة أخرى إلى الجهاز المضيف في الوقت الفعلي.

اتّبِع هذا الدليل لإعداد ميزة "المعاينة المباشرة" لمشروعك في Unreal Engine.

المتطلبات الأساسية

قبل البدء، تأكَّد من أنّ بيئة التطوير تستوفي المتطلبات التالية:

  • Android XR Engine Hub: أكمِل جميع الخطوات الواردة في قسم "البدء" من دليل Android XR Engine Hub لتثبيت الجهاز المضيف وضبطه من أجل ميزة "المعاينة المباشرة".

  • الأجهزة:

    • استخدِم جهازًا مضيفًا يعمل بنظام التشغيل Windows 11.
    • استخدِم بطاقة رسومات حديثة تتوافق مع Vulkan Video Encoding.

إعداد مكوّنات Android XR الإضافية

يمكنك إعداد Unreal Engine باستخدام مكوّنات Android XR الإضافية المطلوبة:

  1. اتّبِع الخطوات الواردة في دليل البدء السريع لإضافات Android XR في Unreal Engine.

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

  2. تأكَّد من أنّ كل مشروع يتضمّن رابطًا رمزيًا إلى مجلد المكوّنات الإضافية الخاصة بالمورّد.

ضبط إعدادات المشروع

يمكنك ضبط إعدادات مشروعك من أجل بث ميزة "المعاينة المباشرة":

  1. انتقِل إلى إعدادات المشروع > المنصات > Windows.
  2. غيِّر RHI إلى Vulkan.
  3. انتقِل إلى تعديل > المكوّنات الإضافية.
  4. فعِّل المكوّن الإضافي AndroidXRStreaming.
  5. انتقِل إلى تعديل > إعدادات المشروع > الوصف.
  6. فعِّل الخيار بدء التشغيل في وضع "الواقع الافتراضي".

تفعيل وقت تشغيل البث

بعد تفعيل المكوّن الإضافي AndroidXRStreaming في المشروع، تحقَّق مما إذا كان وقت تشغيل بث Android XR متوفرًا:

  1. انتقِل إلى إعدادات المشروع > المكوّنات الإضافية > AndroidXRStreaming.

  2. انقر على تفعيل بث AndroidXR.

    تفعيل وقت تشغيل Android XR Streaming

  3. أعِد تشغيل Unreal Engine لتطبيق هذه التغييرات.

ضبط برنامج البث

يمكنك ضبط برنامج البث باستخدام خيارات مختلفة لمشروعك:

  1. انتقِل إلى إعدادات المشروع > المكوّنات الإضافية.

  2. في قسم AndroidXRStreamingClient ، راجِع كل خيار من الخيارات التالية وفعِّلها أو أوقِفها لتتطابق مع ما تحتاجه لمشروعك:

    • Auto Start Client On Preview: عند تفعيل هذا الخيار، يتم تشغيل تطبيق برنامج المعاينة على أي جهاز صالح ومحدّد عند النقر على بدء معاينة "الواقع الافتراضي" من المحرِّر.
    • Auto Stop Client On Preview: عند تفعيل هذا الخيار، يتم إنهاء برنامج المعاينة عند إيقاف معاينة "الواقع الافتراضي" من المحرِّر.
    • **Auto Select Compatible Device**: عند تفعيل هذا الخيار، يتم تلقائيًا اختيار أول جهاز متوافق متصل بالجهاز عند البحث عن الأجهزة.
    • ‫**Show Error Dialogs**: عند تفعيل هذا الخيار، يتم عرض مربّعات حوار إضافية للأخطاء (على سبيل المثال، يتم عرض مربّع حوار للخطأ إذا حاولت بدء معاينة "الواقع الافتراضي" بدون اختيار جهاز برنامج). أوقِف هذا الخيار لإخفاء مربّعات الحوار هذه.
    • تحديث: عند تفعيل هذا الخيار، يبحث الزر تحديث عن الأجهزة المتصلة ويدرج الأجهزة المتوافقة (يتم تحديدها من خلال توفّر تطبيق برنامج "المعاينة المباشرة" في Android XR Engine Hub).

بدء ميزة "المعاينة المباشرة"

يمكنك بدء ميزة "المعاينة المباشرة" للبث مباشرةً من Unreal Engine:

  1. وصِّل جهاز Android XR بالجهاز المضيف باستخدام كابل USB-C عالي الجودة.

  2. إذا لم يسبق لك استخدام هذا الجهاز مع ميزة "المعاينة المباشرة" من قبل، وصِّل الجهاز واضبطه من أجل ميزة "المعاينة المباشرة" في Android XR Engine Hub قبل بدء ميزة "المعاينة المباشرة" من خلال محرّك الألعاب.

  3. في Unreal Editor، انقر على تشغيل المستوى في وضع "الواقع الافتراضي". لا تستخدِم الخيار المعتاد تشغيل في المحرِّر عند بدء ميزة "المعاينة المباشرة".