Agency-Seatbelt V2 التصديرات وواجهة البرمجة
حزام أمان مستقل لـ FiveM، أُعيد بناؤه بالكامل للإصدار 2.0.0.
01تصديرات العميل
| التصدير | الوصف |
|---|---|
isSeatbeltOn() | تُرجع true ما دام حزام اللاعب المحلي مربوطًا، سواء ربطه بنفسه أو ربطته السيارة. |
enableSeatbelt() | يربط حزام اللاعب المحلي مع الصوت والتنبيه المعتادين. |
disableSeatbelt() | يفك حزام اللاعب المحلي مع الصوت والتنبيه المعتادين. |
toggleSeatbelt() | يبدّل حزام اللاعب المحلي. يُرجع true عندما تتغير الحالة فعلًا، لا الحالة الجديدة، حتى يمكن تمييز التبديل المرفوض (لا مركبة، أو لا حزام في هذا المقعد) عن التبديل الناجح. |
isAutoBuckled() | تُرجع true ما دام الحزام قد ربطته السيارة وليس اللاعب. |
autoBuckle(on: boolean) | يربط الحزام أو يفكه كحزام تلقائي، بالطريقة نفسها التي تفعلها السيارة ذاتية القيادة. |
getSeatbeltState() | تُرجع جدولًا فيه حالة الربط، وهل هو تلقائي، والمقعد، والمركبة. |
setSeatbeltEnabled(on: boolean) | يعطّل نظام الحزام بالكامل لهذا اللاعب أو يفعّله، للمشاهد السينمائية أو حالات الإدارة. |
isPlayerSeatbeltOn(serverId: number) | تُرجع حالة حزام لاعب آخر، مقروءة من حقيبة الحالة المنسوخة state bag. |
bucklesItselfVehicle(vehicle: number) | تُرجع هل تربط هذه المركبة ركّابها بنفسها، وفق قائمة الطرازات أو حقيبة الحالة agAuto. |
openSettings() | يفتح بطاقة الإعدادات. |
closeSettings() | يغلق بطاقة الإعدادات. |
isSettingsOpen() | تُرجع هل بطاقة الإعدادات مفتوحة. |
02تصديرات الخادم
| التصدير | الوصف |
|---|---|
isSeatbeltOn(source: number) | تُرجع على الخادم حالة حزام لاعب، مقروءة من حقيبة الحالة المنسوخة state bag. |
getBuckledPlayers() | تُرجع معرّفات الخادم لكل اللاعبين الذين يربطون الحزام حاليًا. |
setSeatbelt(source: number, on: boolean) | يربط حزام لاعب أو يفكه من الخادم. |
03الأحداث
| الاسم | الجهة | الوصف |
|---|---|---|
Agency-HUD:seatbeltStateChanged | العميل | يُطلق عند كل تغيير مع الحالة الجديدة. يستمع إليه Agency-HUD، ويمكن لأي مورد آخر ذلك أيضًا. |
+من المفيد معرفته
تدرج هذه الصفحة التصديرات المتاحة التي يوفرها Agency-Seatbelt للاستخدام في الموارد الأخرى. يمكن للمطورين استخدام هذه التصديرات على جانب العميل للتحكم أو الاستعلام عن حالة حزام الأمان للاعب المحلي. لا تتوفر تصديرات على جانب الخادم. تأكد من تشغيل Agency-Seatbelt قبل أي مورد يستخدم تصديراته لتجنب أخطاء وقت التشغيل أو السلوك غير المحدد.
- تصديرات على جانب العميل فقط
- يوفر Agency-Seatbelt أربعة تصديرات كلها على جانب العميل. تسمح هذه السكربتات بتمكين، تعطيل، تبديل، أو التحقق من حالة حزام الأمان للاعب المحلي. لا توجد تصديرات أو أحداث على جانب الخادم يوفرها هذا المورد.
- الاستخدام داخل الموارد الأخرى
- لاستخدام هذه التصديرات، تأكد من تشغيل Agency-Seatbelt قبل أي مورد يعتمد عليه. استدعِ التصديرات مباشرة من سكربتات العميل الخاصة بك لدمج وظيفة حزام الأمان أو فحوصات حالة HUD حسب الحاجة.
- لا تبعيات أو SQL
- لا يتطلب Agency-Seatbelt أي تبعيات خارجية أو إعداد SQL. جميع الميزات، بما في ذلك وظائف التصدير، متاحة مباشرة بعد تشغيل المورد.
?الأسئلة المتكررة
هل تتوفر تصديرات على جانب الخادم لـ Agency-Seatbelt؟
لا، يوفر Agency-Seatbelt فقط تصديرات على جانب العميل. لا توجد تصديرات أو أحداث على جانب الخادم مكشوفة. يجب إجراء كل التفاعل مع حالة حزام الأمان من خلال سكربتات العميل باستخدام التصديرات المتاحة.
ماذا يحدث إذا استدعيت تصديرًا قبل بدء تشغيل Agency-Seatbelt؟
إذا حاولت استخدام تصدير قبل بدء تشغيل Agency-Seatbelt، فلن يكون التصدير متاحًا وقد يرمي سكربتك خطأ أو يفشل في العمل كما هو متوقع. تأكد دائمًا من بدء تشغيل Agency-Seatbelt أولاً.
هل أحتاج إلى تكوين أي تبعيات أو استيراد SQL لاستخدام هذه التصديرات؟
لا، لا يتطلب Agency-Seatbelt أي تبعيات أو استيرادات SQL. التصديرات متاحة فور بدء تشغيل المورد، ولا يلزم أي إعداد إضافي.
كيف يمكنني التحقق مما إذا كان حزام أمان اللاعب المحلي مربوطًا من سكربت آخر؟
يمكنك استخدام تصدير العميل isSeatbeltOn() للتحقق مما إذا كان حزام أمان اللاعب المحلي مربوطًا حاليًا. استدعِ هذا التصدير من سكربت العميل الخاص بك لاسترجاع حالة حزام الأمان الحالية.