Agency-Notify التصديرات وواجهة البرمجة
نظام إشعارات متقدّم بنمطين بصريين (V1 Classic وV2 Ultra) يمكن لكل لاعب التبديل بينهما، مع قائمة إعدادات داخل اللعبة.
01Client Exports
| التصدير | الوصف |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional AgencyAI smart-priority/duration/spam handling. |
02الأحداث
| الاسم | الجهة | الوصف |
|---|---|---|
Agency:Notify:Send | Client | Legacy v1 entry point to display a notification with the same payload as the export. |
Agency:Notify:LoadSettings | Client | Applies per-player saved UI settings (position, color, scale, style) from the server. |
Agency:Notify:SaveSettings | Server | Validates and persists the player's notify settings (position, accent, scale, style). |
+من المفيد معرفته
تدرج هذه الصفحة الصادرات والأحداث المتاحة لـ Agency-Notify، مما يسمح للموارد الأخرى بإطلاق الإشعارات أو التفاعل مع إعدادات إشعارات اللاعبين. الصادرات والأحداث متوفرة للاستخدام على جانب العميل فقط، حيث لا توجد صادرات على جانب الخادم. التكامل بسيط ولا يتطلب أي اعتماد إلزامي، رغم أنه يمكن استخدام oxmysql لتخزين الإعدادات بشكل دائم إذا تم تفعيله في التكوين.
- استخدام تصدير العميل
- تصدير Notify متاح على جانب العميل ويسمح لك بعرض إشعار V2 مع دعم ميزات AgencyAI، مثل الأولوية الذكية، والمدة، وحماية من الرسائل المزعجة. يمكنك تمرير كائن بيانات يحتوي على حقول مثل العنوان، النص، النوع، والمدة لتخصيص الإشعار.
- دعم الأحداث القديمة
- يتضمن Agency-Notify توافقًا مع الإصدار القديم v1 عبر حدث العميل Agency:Notify:Send. يقبل هذا الحدث نفس الحمولة التي يقبلها تصدير Notify، مما يسهل تحديث السكربتات القديمة أو الحفاظ على التوافق مع الحد الأدنى من التغييرات.
- أحداث حفظ الإعدادات
- يدير حدثان إعدادات إشعارات اللاعبين: Agency:Notify:LoadSettings (عميل) يطبق تفضيلات واجهة المستخدم المحفوظة، بينما Agency:Notify:SaveSettings (خادم) يتحقق من صحة الإعدادات ويحفظها مثل الموقع، اللون، المقياس، والأسلوب. يتطلب الحفظ وجود oxmysql ويجب تفعيله في التكوين.
?الأسئلة المتكررة
هل توجد صادرات على جانب الخادم في Agency-Notify؟
لا، يوفر Agency-Notify صادرات على جانب العميل فقط. يتم التعامل مع إطلاق الإشعارات وإدارة الإعدادات على العميل، مع توفر أحداث الحفظ والتحميل إذا تم تفعيل oxmysql.
هل oxmysql مطلوب لعمل Agency-Notify؟
oxmysql اختياري. هو مطلوب فقط إذا كنت تريد تمكين حفظ الإعدادات الخاصة بإشعارات اللاعبين في قاعدة البيانات. بدون oxmysql، تعمل الإشعارات وإعدادات واجهة المستخدم بشكل طبيعي، لكن الإعدادات لن تُحفظ بين الجلسات.
كيف يمكنني تفعيل إشعار من مورد آخر؟
يمكنك استخدام export العميل Notify لعرض إشعار. مرر كائن بيانات يحتوي على الحقول المطلوبة (العنوان، النص، النوع، المدة، إلخ). بدلاً من ذلك، استخدم حدث العميل Agency:Notify:Send للتوافق مع الإصدارات القديمة بنفس هيكل الحمولة.
ماذا يجب أن أتحقق منه إذا لم تظهر الإشعارات؟
تأكد من أن Agency-Notify تم تشغيله بشكل صحيح باستخدام ensure Agency-Notify في ملف server.cfg الخاص بك. تحقق من أنك تستدعي export العميل أو الحدث مع الحمولة الصحيحة. إذا كنت تستخدم الحفظ، تحقق من تثبيت oxmysql وتمكينه في الإعدادات.