Agency Docs

QBESXStandalone

Agency-Phone التصديرات وواجهة البرمجة

الآن مع AgencyOS27: تحديث مجاني لكل من يملك الهاتف بالفعل.

v27.1.2مدفوع8 صفحات

اشترِ من المتجر العودة إلى القائمة

01تصديرات العميل

التصدير	الوصف
`IsPhoneOpen()`	تُرجع true إذا كانت واجهة الهاتف مفتوحة حاليًا.
`IsPhonePoweredOn()`	تُرجع true إذا كان الهاتف قيد التشغيل (وfalse إذا أطفأه اللاعب).
`GetPhoneData()`	تُرجع جدول PhoneData الكامل على جهة العميل (حالة الفتح، البيانات الوصفية وغيرها).
`GetPhonePropEntity()`	تُرجع مُعرّف الكيان لمجسم الهاتف المحمول في اليد، أو 0 إذا لم يكن ظاهرًا.
`IsPhoneExpanded()`	اسم بديل لـ IsPhoneOpen() أُبقي عليه للتوافق مع الإصدارات السابقة.
`HasCarrierContract()`	تُرجع true عندما يكون لدى اللاعب باقة بيانات فعّالة لدى المشغّل.
`GetPhoneState()`	تُرجع الجدول { isOpen, poweredOn, syncEnabled } الذي يلخّص حالة الهاتف الحالية.
`HasPhone()`	تُرجع true إذا كان عنصر الهاتف المُعَد موجودًا في مخزون اللاعب.
`RegisterAgencyPayPoint(id, data)`	يسجّل أثناء التشغيل جهاز دفع Agency Pay عند إحداثية معيّنة (علامات، رمز على الخريطة، بيانات الدفع).
`RemoveAgencyPayPoint(id)`	يزيل جهاز دفع Agency Pay مسجّلًا سابقًا بواسطة المعرّف.
`StartAgencyPayCheckout(data)`	يفتح الهاتف عند الحاجة ويبدأ عملية دفع Agency Pay ببيانات الدفع المُمرَّرة.
`StartCall(contactData)`	يبدأ مكالمة صادرة إلى جهة الاتصال المُمرَّرة ({ name, number, ... }).
`PhoneNotification(title, text, icon, color, timeout, acceptIcon, denyIcon)`	يعرض إشعارًا بزرّي قبول ورفض، وينتظر حتى يستجيب المستخدم ثم يُرجع true أو false.
`RegisterApp(config)`	يضع تطبيقًا من موردك الخاص على الشاشة الرئيسية للهاتف وفي Store. يُرجع true، أو false مع رسالة خطأ. راجع تطبيقات مخصصة.
`UnregisterApp(id)`	يزيل تطبيقًا أُضيف عبر RegisterApp. يحدث ذلك تلقائيًا عند توقّف المورد الذي سجّله.
`GetRegisteredApps()`	يُرجع جدول كل التطبيقات التي سجّلتها موارد أخرى، مفهرسًا حسب المعرّف.
`ClosePhone()`	يغلق الهاتف، مثلًا قبل فتح واجهتك الخاصة.
`IsPhoneRadioActive()`	يُرجع قيمتين: true ما دام راديو الهاتف يعمل، والمحطة التي تُبث حاليًا.
`StopPhoneRadio()`	يوقف راديو الهاتف.

02تصديرات الخادم

التصدير	الوصف
`SendMail(identifier, mailData)`	يرسل بريدًا إلى صندوق البريد الرئيسي للاعب عبر المعرّف (ويُرجع نجاح العملية).
`AddChirp(chirpData)`	يضيف منشورًا في خلاصة Pulse باسم السكربت ({ identifier, firstName, lastName, message, postId }).
`usePhone(event, item, inventory, slot, data)`	خطّاف ox_inventory يُسجَّل عند اكتشاف ESX مع ox_inventory؛ ويفتح الهاتف لصاحب المخزون.
`VerifyAgencyPayCharge(source, requestId, minAmount)`	يؤكّد على الخادم أن هذا اللاعب دفع عملية Agency Pay بهذا المعرّف خلال آخر 60 ثانية، بمبلغ لا يقل عن minAmount، ثم يستهلك الدفعة لتُحتسب مرة واحدة فقط. requestId هو المعرّف الذي مرّرته إلى StartAgencyPayCheckout. يُرجع true والمبلغ، أو false. استدعِه قبل تسليم البضاعة.

03الأحداث

الاسم	الجهة	الوصف
`agency-phone:client:notify`	العميل	يعرض إشعارًا على الهاتف (title, text, icon, color, timeout, silent).
`agency-phone:client:usePhoneItem`	العميل	يبدأ فتح الهاتف عند استخدام عنصر الهاتف من المخزون.
`agency-phone:client:openApp`	العميل	يطلب من الهاتف الانتقال إلى تطبيق مخصّص بواسطة المعرّف (تستخدمه وحدات التطبيقات).
`agency-phone:client:newMailNotify`	العميل	يُعلم العميل ببريد وصل للتو.
`agency-phone:server:requestPhoneData`	الخادم	يطلب مزامنة جديدة لبيانات الهاتف للاعب المُستدعي.
`agency-phone:server:cancelCall`	الخادم	يلغي مكالمة جارية أو ينهيها.
`agency-phone:server:sendMessage`	الخادم	يرسل رسالة SMS (newMsg, targetNumber).
`agency-phone:server:saveSetting`	الخادم	يحفظ للاعب إعدادًا واحدًا من إعدادات الهاتف كمفتاح وقيمة.
`agency-phone:server:airdropPay`	الخادم	ينفّذ تحويلًا عبر Agency Airdrop إلى لاعب قريب.
`agency-phone:server:buyDataPlan`	الخادم	يشتري باقة بيانات لدى المشغّل للاعب (price, planName).
`agency-phone:dispatch:create`	الخادم	يُنشئ بلاغًا للإرسال من مكالمة طوارئ أو رسالة SMS طارئة.

ما زلت عالقًا بعد هذه الصفحة؟ فريق الدعم يتولّى الأمر من هنا.

افتح مركز الدعم مجتمع ديسكورد