ملف أداء Unreal Engine: دليل أوامر stat وInsights

عند ظهور مشكلة في أداء مشروع Unreal Engine، تتمثل الخطوة الأولى في قياس المرحلة التي تظهر فيها المشكلة. تشرح الوثائق الرسمية لـ Epic Games كيفية عرض بيانات الأداء الأساسية باستخدام أوامر stat التي تُدخل في وحدة التحكم أثناء التشغيل، ثم فحص الآثار المسجلة بمزيد من التفصيل عبر Unreal Insights. يتناول هذا الدليل سير العمل من القياس إلى التحليل، ولا سيما في مشروعات التصوير المعماري الآني والمشاهد التفاعلية.

1. حدّد الاختناق العام أولًا

شغّل المشروع في وضع Play In Editor (PIE)، ثم أدخل الأمر التالي في وحدة التحكم:

stat unit

يعرض هذا الأمر معلومات الأداء ضمن عناوين Frame وGame وDraw وGPU وRHIT وDynRes. ووفقًا للوثائق، يشير Frame إلى إجمالي الزمن اللازم لإنتاج إطار واحد. إذا كان زمن Frame قريبًا من زمن Game، فقد تكون المشكلة في جانب Game thread؛ وإذا كان قريبًا من زمن Draw، فقد تكون في جانب render thread. أما زمن GPU فيوضح الوقت الذي تستغرقه بطاقة الرسوميات لإنشاء المشهد. تعامل مع هذه القيم بوصفها مؤشرات توجه الفحص الأعمق، لا تشخيصًا قاطعًا.

ومن أوامر البداية الأخرى للحصول على نظرة عامة stat sceneRendering. تصفه Epic بأنه نقطة بداية مناسبة لاستكشاف المجالات العامة للبطء في عملية التصيير. بعد ذلك، يمكن اختيار الأمر بحسب المجال الذي تشير إليه القياسات: يعرض stat memory استخدام الذاكرة، ويعرض stat streaming معلومات أساسية عن الأصول التي يجري بثها، بينما يوضح stat lightRendering زمن معالجة الإضاءة والظلال.

stat sceneRendering

عند الحاجة إلى قائمة بالأوامر، يمكن استخدام stat help من وحدة التحكم. وتشير الوثائق أيضًا إلى إمكانية العثور على الأوامر من قائمة Stat داخل المحرر، بالنقر على السهم المنسدل بجوار زر Viewport Setting.

2. احفظ قياسات PIE في ملف

إذا لم تكفِ المؤشرات الفورية لرصد المشكلة، فسجّل عينات الإحصاءات في ملف. يبدأ التسجيل بإدخال الأمر التالي في وحدة تحكم PIE:

stat startfile

ينشئ التسجيل عادةً ملف .uestats ضمن Saved/Profiling/UnrealStats في مجلد المشروع. أوقف التسجيل عند الانتهاء بالتأكيد:

stat stopfile

هذه الخطوة مهمة: فوفقًا للوثائق، قد يستمر التسجيل في الخلفية باستخدام StartFile حتى بعد إغلاق PIE. وقد يؤدي نسيان إيقاف التسجيل إلى إنشاء ملفات .uestats كبيرة. لفحص الملف الناتج، انتقل من قائمة Unreal Editor إلى Tools > Session Frontend، وافتح علامة التبويب Profiler، ثم اختر الملف باستخدام Load. عندئذٍ يمكن عرض البيانات المسجلة داخل Profiler.

3. افحص الآثار باستخدام Unreal Insights

Unreal Insights مجموعة أدوات لالتقاط الأحداث من المشروع بمعدلات بيانات مرتفعة، ثم تحليل هذه البيانات وعرضها بصريًا. ويمكن تشغيلها من خلال Trace/Insights Status Bar Widget داخل المحرر. تُحفظ جلسات التتبّع في ملفات .utrace، وقد تُخزّن البيانات المصاحبة في ملفات .ucache بالموقع نفسه.

يمكن بدء التحليل بالنقر المزدوج على جلسة محفوظة في Session Browser، أو بتحديد الجلسة واستخدام زر Open Trace. ويمكن العثور على ملف .utrace في موقع آخر من قائمة Open Trace؛ كما توضح الوثائق إمكانية سحب الملف وإفلاته في نافذة Unreal Insights. تظهر الجلسات الحية في القائمة بالحالة LIVE، وتُحدّث في الوقت الفعلي أثناء فحصها.

تتيح نافذة Timing Insights عرض آثار المعالج والرسوميات والمدة التي تستغرقها المهام. ويمكن استخدام Memory Insights لفحص استخدام الذاكرة ومكدسات الاستدعاء، وAsset Loading Insights للتحقق من زمن تحميل الأصول وترتيب تحميلها. يساعد اختيار الأداة بحسب نوع المشكلة على إبقاء الفحص مركزًا.

4. تكييف سير العمل مع التصوير المعماري

عند ملاحظة تقطّع أو بطء في الاستجابة أو انتظار التحميل في مشهد معماري تفاعلي، ابدأ بالقياس باستخدام stat unit. دوّن ما إذا كانت النتائج تشير إلى Game أو Draw أو GPU؛ وبدلًا من اتخاذ قرار التحسين بناءً على قياس لحظي واحد، أعد القياس في المشهد نفسه وفي ظروف استخدام مماثلة. بعد ذلك، سجّل الإحصاءات أو التقط أثرًا باستخدام Unreal Insights بحسب مستوى التفاصيل المطلوب.

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

تذكر وثائق Unreal Insights أن Trace Server مفعّل على جميع منصات سطح المكتب اعتبارًا من UE 5.3. ويمكن تحديد مجلد مختلف لحفظ الآثار، وإضافة مجلدات تتبّع أخرى. قبل مشاركة ملفات التحليل، ينبغي للفرق التحقق من المجلد المستخدم ومن اكتمال التسجيل. تستند الخطوات هنا إلى الأوامر والأدوات الواردة في وثائق Unreal Engine التابعة لـ Epic Games؛ وبما أن الوثائق لا تحدد متطلبات عتاد أو شروط ترخيص معينة لسير العمل هذا، فلا يمكن استخلاص توصية خاصة بشأنها.

أخطاء شائعة

• نسيان إيقاف التسجيل بعد stat startfile: قد يستمر التسجيل حتى بعد إغلاق PIE. أدخل stat stopfile عند الانتهاء.

• اعتبار ملفي .uestats و.utrace نوعًا واحدًا من التسجيل: تربط الوثائق الرسمية بين الامتدادين وسيرَي عمل مختلفين. يُفتح تسجيل .uestats في Profiler ضمن Session Frontend، بينما تُفتح آثار .utrace في Unreal Insights.

• اعتبار أول قيمة تراها سببًا مؤكدًا للمشكلة: يشير stat unit إلى احتمال وجود اختناق؛ انتقل إلى أدوات التسجيل والتحليل المناسبة لمزيد من الفحص.