إعداد Unreal Engine Pixel Streaming: اعرض المشاريع المعمارية في المتصفح

تشرح وثائق Unreal Engine من Epic Games كيفية إعداد Pixel Streaming على شبكة محلية واستخدامه عبر متصفحات الويب والأجهزة المحمولة. يجمع هذا الدليل خطوات الإعداد الأساسية للفرق التي تريد إتاحة تطبيق Unreal Engine المُعدّ للتصور المعماري أو للعروض التفاعلية أمام مشاهدين على الشبكة نفسها. تنطبق الخطوات على إضافتي Pixel Streaming وPixel Streaming 2 المذكورتين في الوثائق؛ وينبغي التحقق من توافق نظام التشغيل والأجهزة بشكل منفصل وفقًا للإعداد المستخدم.

1. إعداد التطبيق والإضافة

لا يشارك Pixel Streaming نافذة المحرر العادية مباشرةً، بل ينقل صورة التطبيق المُعبّأ أو المشروع الذي بدأ تشغيله في وضع Standalone Game. لذا، جهّز المشروع أولًا لإحدى طريقتَي التشغيل هاتين.

1. افتح قائمة Edit > Plugins في Unreal Editor. فعّل إضافة Pixel Streaming أو Pixel Streaming 2 ضمن فئة Graphics، ثم أعد تشغيل المحرر.

2. إذا كان المشروع يتضمن شخصية ستُتحكّم بها عبر شاشة اللمس على هاتف أو جهاز لوحي، فعّل إعداد Always Show Touch Interface من قسم Engine > Input ضمن Edit > Project Settings. هذه الخطوة اختيارية؛ ويعتمد عمل التحكم باللمس أيضًا على دعم Player Controller في المشروع لإدخال اللمس.

3. إذا كنت ستبدأ تشغيل Standalone Game من المحرر، فأدخل معامل الاتصال التالي في حقل Additional Launch Parameters ضمن المسار Edit > Editor Preferences... > Level Editor > Play:

-PixelStreamingURL=ws://127.0.0.1:8888

1. لإنشاء نسخة من التطبيق، اتبع المسار Files > Package Project > Windows (64-bit) لإنشاء حزمة Windows. يجب تمرير معامل الاتصال نفسه عند كل تشغيل للتطبيق؛ وتشرح الوثائق أيضًا استخدامه بإضافته إلى حقل الوجهة في الاختصار.

يمكن أيضًا إضافة المعامل -RenderOffScreen لتفادي احتمال توقف تدفق الإدخال عند تصغير نافذة التطبيق. يشغّل هذا الخيار التطبيق من دون نافذة مرئية، لكنه ليس إلزاميًا لكل مشروع.

2. تشغيل خوادم Pixel Streaming

توجد الواجهة الأمامية للويب ومكوّنات الخادم ضمن Pixel Streaming Infrastructure، وتعمل بشكل منفصل عن تطبيق Unreal Engine. يشرح دليل البدء من Epic الحصول على هذه المكوّنات من مستودع GitHub أو استخدام الأمر get_ps_servers الموجود ضمن التثبيت. يعرض المثال في الوثائق الفرع 5.7 للمستودع؛ وهذا لا يعني ضرورة اختيار الفرع نفسه في كل إعداد. تحقّق من الفرع المتوافق مع إصدار Unreal Engine المستخدم.

1. احصل على ملفات البنية التحتية وحدد نصوص الخادم البرمجية في مجلد SignallingWebServer.

2. في مثال Windows، افتح PowerShell بصلاحيات المسؤول وشغّل النص البرمجي التالي لتثبيت الاعتماديات:

SignallingWebServer\platform_scripts\cmd\setup.bat

1. بعد ذلك، ابدأ تشغيل خادم الإشارات:

SignallingWebServer\platform_scripts\cmd\start_with_stun.bat

عندما يصبح الخادم جاهزًا، ستظهر رسائل تفيد بأنه يستمع إلى اتصالات WebSocket للناشر على المنفذ 8888، وللمشغّل على المنفذ 80، وأن خدمة HTTP تعمل على المنفذ 80. أوقف أي خوادم ويب أخرى تعمل على الجهاز نفسه قبل البدء. تُطبّق العملية نفسها على Linux وMac؛ وتشير الوثائق إلى استخدام النصوص البرمجية ضمن SignallingWebServer\platform_scripts\bash بدلًا من نصوص Windows.

بعد تشغيل التطبيق والخوادم، افتح http://127.0.0.1 في المتصفح. انقر على الصفحة بعد الاتصال بصفحة المشغّل لبدء البث. ويمكن لأجهزة الكمبيوتر أو الأجهزة المحمولة الأخرى على الشبكة المحلية نفسها الاتصال باستخدام عنوان IP الشبكي لجهاز الخادم بدلًا من 127.0.0.1.

3. التخطيط لإمكانية الوصول عبر الشبكة وتحكم المستخدمين

يساعد إجراء الاختبار الأول على الجهاز نفسه أو على الشبكة المحلية في عزل مشكلات الإعداد عن مشكلات الاتصال الخارجي. يطلب دليل البدء إتاحة المنفذين 80 و8888 للاتصال عبر الشبكة المحلية. وإذا كان الوصول من شبكات مختلفة مطلوبًا، فقد لا يكفي فتح هذين المنفذين وحدهما؛ إذ يمكن أن تؤثر NAT والشبكات الفرعية وشبكات مشغلي الهاتف المحمول في الاتصال.

في مثل هذه الحالات، يمكن إضافة معلومات خوادم STUN أو TURN إلى إعداد peerConnectionOptions في خادم الإشارات. يساعد STUN نقاط الاتصال على تحديد عناوين IP الظاهرة من الخارج. أما TURN فينقل تدفق الوسائط عبر الخادم، لذا ينبغي مراعاة عرض النطاق الترددي وحِمل النقل. وتشير وثائق Epic إلى احتمال الحاجة إلى TURN على شبكات مشغلي الهاتف المحمول أو الشبكات المؤسسية الآمنة. وعند إعداد خادم متاح عبر الإنترنت، ينبغي معالجة الأمان في الإعدادات وإمكانية الوصول بصورة مستقلة؛ ولا ينبغي التعامل مع مثال الشبكة المحلية على أنه خدمة إنتاجية جاهزة.

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

تأثيره في سير عمل العمارة والتصور

يمكن استخدام Pixel Streaming لإتاحة تجربة مشهد تفاعلي من Unreal Engine على شاشات مختلفة عبر صفحة ويب. ويسهّل اتصال المشاهدين من المتصفح من دون تثبيت برامج إضافية على أجهزتهم الوصولَ خلال العروض أو مراجعة المشاريع. لكن المشهد يعمل على الجهاز المضيف البعيد، وتتلقى الأجهزة المتصلة صورة المشهد نفسه. وفي الإعداد الافتراضي، يمكن أيضًا مشاركة التحكم عبر الإدخالات؛ لذا ينبغي تحديد صلاحيات التحكم مسبقًا أثناء العرض.

قد تتأثر جودة الصورة بسعة وحدة معالجة الرسومات والذاكرة في الجهاز المضيف المتاح. وعند التخطيط لخدمة متاحة عبر الإنترنت أو لعدد كبير من المستخدمين المتزامنين، ينبغي تقييم أجهزة الخادم وظروف الشبكة ونهج التوسّع معًا. توصي Epic بالتوسّع الديناميكي لعمليات النشر الكبيرة أو التي يتزايد حجمها حسب الطلب؛ وعلى الرغم من إمكان تشغيل عدد ثابت من التطبيقات للاستخدام محدود النطاق، فقد يؤدي ذلك إلى هدر الموارد أو انتظار الاتصال. وقد تكون ميزة SFU خيارًا لعدد كبير من المشاهدين وظروف الشبكة المختلفة، لكن الوثائق تصفها بأنها تجريبية.

أخطاء شائعة

• عدم إعادة تشغيل المحرر بعد تفعيل الإضافة، أو تشغيل التطبيق بصيغة غير مُعبّأة/Standalone Game.

• بدء التطبيق من دون معامل الاتصال، أو محاولة الاتصال من المتصفح قبل تشغيل الخوادم.

• إجراء الاختبار الأول عبر الإنترنت بدلًا من الشبكة المحلية، ما يصعّب استكشاف مشكلات NAT وSTUN/TURN وجدار الحماية.

• عدم التحقق من إتاحة المنفذين 80 و8888، أو السماح لخادم ويب آخر بالتعارض مع الإعداد نفسه.

• عدم الانتباه إلى أن جميع المشاركين يمكنهم افتراضيًا إرسال إدخالات إلى الجلسة نفسها أثناء العرض.

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