مرجع نودز البلوبرنت

توفر هذه الصفحة شرحاً مفصلاً وقائمة كاملة بكل نود (Node) وحدث (Event) متاح في بلجن Dztfix Network Check.

نود الوصول للمساعد (Subsystem Access)

Get Dztfix Network Check

هذا هو المدخل الرئيسي للوصول إلى مساعد فحص الشبكة. تحتاج إلى استدعاء هذه النود أولاً للحصول على مرجع الكائن (Object Reference)، مما يسمح لك بربط الأحداث أو قراءة الحالة.

  • المدخلات (Inputs): World Context Object (يتم تعيينه تلقائياً لـ Self مثل ودجت أو ممثل).
  • المخرجات (Outputs): Dztfix Network Check Subsystem Object Reference مرجع كائن المساعد.

نودز الاتصال (Connection Nodes)

Is Internet Available

ترجع حالة الإنترنت المخزنة مؤقتاً على الفور. استخدمها لإجراء فحوصات سريعة قبل العمليات التي تتطلب شبكة (مثل شراء منتج أو حفظ التقدم عبر الإنترنت).

  • المخرجات: Boolean (ترجع True إذا كان الإنترنت متوفراً ومؤكداً، و False خلاف ذلك).

Check Internet Connection

تطلق فحصاً يدوياً واحداً (HTTP Ping) للتحقق مما إذا كان الإنترنت يعمل. هذه نود غير متزامنة (Asynchronous)، مما يعني أنها لن تتسبب في تجميد اللعبة. يتم إرسال النتيجة عبر حدث On Connection Check Completed.

  • المدخلات: تتطلب سهم تنفيذ لتشغيلها.
  • المخرجات: تطلق سهم التنفيذ مباشرة مع بدء عملية الفحص في الخلفية.

Get Last Network Status

تجلب الحالة الدقيقة للاتصال التي تم تسجيلها أثناء آخر عملية فحص تم إجراؤها.

  • المخرجات: قائمة EDztfixNetworkStatus Enum. القيم يمكن أن تكون:
    • Unknown: لم يتم إجراء أي فحص للشبكة بعد.
    • Available: نجح آخر فحص للإنترنت.
    • Unavailable: فشل آخر فحص للإنترنت أو انتهت مهلة الاستجابة.

نودز المراقبة (Monitoring Nodes)

Start Network Monitoring

تأمر المساعد بالبدء في إجراء فحوصات دورية في الخلفية باستخدام الفاصل الزمني Check Interval المحدد في إعدادات المشروع. إذا حدث أي تغير في حالة الشبكة، فسيتم إطلاق الأحداث المخصصة.

  • المدخلات: سهم التنفيذ.

Stop Network Monitoring

توقف فحص الشبكة الدوري في الخلفية. مفيدة عند الدخول إلى القوائم الرئيسية أو المراحل الأوفلاين لتقليل استهلاك موارد الجهاز.

  • المدخلات: سهم التنفيذ.

Is Network Monitoring Active

تتحقق مما إذا كانت حلقة الفحص الدوري في الخلفية تعمل حالياً.

  • المخرجات: Boolean (ترجع True إذا كانت المراقبة نشطة).

الأحداث واستدعاءات الاسترجاع (Events & Callbacks)

On Network Available

حدث بسيط يُطلق تلقائياً عندما يتحول الإنترنت من غير متوفر إلى متوفر. استخدمه لإخفاء بوب أب "لا يوجد اتصال" واستئناف اللعب.

On Network Lost

يُطلق تلقائياً وبسرعة فور اكتشاف المساعد لانقطاع اتصال الإنترنت. استخدمه لإظهار ودجت إعادة الاتصال.

On Network Status Changed

يُطلق في كل مرة تتغير فيها حالة الاتصال. يقوم بتمرير الحالة الجديدة والحالة السابقة لعرض لوحات إرشادية مخصصة أو تسجيل اللوج.

  • متغيرات الحدث (Event Parameters):
    • New Status (EDztfixNetworkStatus Enum)
    • Previous Status (EDztfixNetworkStatus Enum)

On Connection Check Completed

يُطلق عند اكتمال عملية الفحص اليدوي التي تم بدؤها بواسطة `Check Internet Connection`.

  • متغيرات الحدث (Event Parameters):
    • Result (قائمة EDztfixNetworkCheckResult Enum: نجاح Success، فشل Failed، أو إلغاء Cancelled)
    • Status (قائمة EDztfixNetworkStatus Enum: متوفر Available أو غير متوفر Unavailable)
    • Message (نص String يحتوي على تفاصيل الاستجابة أو رسالة الخطأ)

مخطط فحص الشبكة (Blueprint Flow)

OnClicked BTN_CheckInternet
يضغط اللاعب على زر إعادة المحاولة
↓
Set Text (Log_Text)
Text: "Verifying connection..."
↓
Check Internet Connection
إرسال فحص بالخلفية دون تجميد اللعبة