Agency-Phone تطبيقات مخصصة

🧩 بناء تطبيق مخصّص لـ Agency-Phone

هناك طريقتان لإضافة تطبيق إلى الهاتف. اختر ما يناسبك:

إذا كنت توزّع تطبيقًا على خوادم أخرى فاستخدم الطريقة A. لا تحتاج إلى الشيفرة المصدرية منا وتستمر في العمل بعد التحديثات.

A SDK: تسجيل تطبيق من موردك الخاص

يوفّر agency-phone تصديرات تتيح لأي مورد أن يضع أثناء التشغيل تطبيقًا بأيقونته الخاصة على الشاشة الرئيسية للهاتف. تبقى واجهة تطبيقك في موردك؛ ويعرض الهاتف الأيقونة ويسلّمك التحكم عندما ينقر عليها اللاعب. بلا تعديلات على agency-phone وبلا نسخة مفتوحة.

مثال مختصر

-- client side of YOUR resource
CreateThread(function()
    Wait(1500) -- let agency-phone boot
    exports['agency-phone']:RegisterApp({
        id        = 'myshop',
        label     = 'My Shop',
        icon      = 'fa-solid fa-cart-shopping', -- FontAwesome 6 class
        -- image  = 'https://cfx-nui-myresource/icon.png', -- or your own image instead
        color     = '#ff9500',
        colorDark = '#e08600',
    })
end)

-- fired when the player taps your icon on the phone
AddEventHandler('agency-phone:client:openApp', function(appId)
    if appId ~= 'myshop' then return end
    exports['agency-phone']:ClosePhone()
    -- open your own NUI here
end)

إعدادات RegisterApp

تصديرات SDK (العميل)

حدث النقر

عندما ينقر اللاعب على أيقونتك، يطلق agency-phone هذين الحدثين على العميل. استخدم ما تفضّله:

أضف dependency 'agency-phone' إلى ملف fxmanifest.lua ليكون ترتيب التشغيل صحيحًا.

B Drop-in، شاشة أصلية داخل الهاتف

لشاشة يرسمها الهاتف نفسه (وليس موردك). يتطلب ذلك تعديل ملفات agency-phone.

الخطوتان 3 و4 في ملفات يشفّرها escrow، لذلك تحتاج الشاشة الأصلية إلى نسخة بالشيفرة المصدرية أو نسخة مفتوحة. إذا كانت لديك نسخة escrow فقط فاستخدم الطريقة A بدلًا منها (تبقى شاشتك في موردك الخاص). ملفات مرجعية داخل المورد: apps/testapp_client.lua وapps/dispatch_client.lua.

📋 تصديرات أخرى للهاتف

العميل

الخادم

⇄ جسر NUI ↔ Lua (الطريقة B)

💳 الدفع عبر AgencyPay

اخصم من محفظة اللاعب من أي مورد.

exports['agency-phone']:StartAgencyPayCheckout({
    merchant = 'My Shop', title = 'Agency Pay', subtitle = 'Checkout',
    label = 'Premium Coffee', amount = 24.50,
    icon = 'fa-solid fa-mug-hot', accent = '#ff9f0a',
    clientEvent = 'myshop:client:agencyPayResult',
    serverEvent = 'myshop:server:agencyPayResult',
    metadata = { orderId = 'order_2048' },
})

RegisterNetEvent('myshop:client:agencyPayResult', function(result)
    if result.status == 'paid' then
        -- deliver the goods
    end
end)

تتضمن النتيجة status (paid / cancelled / failed) وamount وcardId وbalance وmetadata الخاصة بك.

نتيجة paid القادمة من العميل إلى موردك لا تثبت شيئًا وحدها. مرّر id خاصًا بك إلى StartAgencyPayCheckout واستدعِ exports['agency-phone']:VerifyAgencyPayCharge(source, id, amount) على الخادم قبل تسليم أي شيء. لا يُرجع true والمبلغ إلا إذا دفع هذا اللاعب هذه العملية خلال آخر 60 ثانية، ثم يستهلك الدفعة حتى لا يمكن المطالبة بها مرتين.

🐛 حل المشكلات

لديك أسئلة أو تحتاج إلى مساعدة؟ انضم إلى Discord الخاص بـ Agency Scripts.