Agency-Phone Özel Uygulamalar

🧩 Agency-Phone için özel bir uygulama geliştirin

Telefona bir uygulama eklemenin iki yolu vardır. Size uygun olanı seçin:

Bir uygulamayı başka sunuculara dağıtıyorsanız şunu kullanın: Yöntem A. Bizden herhangi bir kaynak kod gerektirmez ve güncellemeler boyunca çalışmaya devam eder.

A SDK: Kendi resource'unuzdan bir uygulama kaydedin

agency-phone, herhangi bir kaynağın çalışma zamanında telefonun ana ekranına kendi simgesiyle bir uygulama yerleştirmesine olanak tanıyan exportlar sunar. Uygulamanızın arayüzü kendi kaynağınızda yer alır; telefon simgeyi gösterir ve oyuncu dokunduğunda kontrolü size devreder. agency-phone üzerinde değişiklik yok, kilitsiz derleme yok.

Minimal örnek

-- 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 yapılandırması

SDK export'ları (client)

Dokunma olayı

Oyuncu simgenize dokunduğunda, agency-phone istemcide bunların her ikisini de tetikler. Hangisini tercih ederseniz onu kullanın:

Ekle dependency 'agency-phone' sizin fxmanifest.lua böylece başlatma sırası doğru olur.

B Doğrudan entegre, telefon içinde yerel bir ekran

Telefonun kendisi tarafından işlenen bir ekran için (sizin resource'unuz değil). Bu işlem agency-phone'un kendi dosyalarını düzenler.

Adım 3 ve 4 escrow ile şifrelenmiş dosyalarda yer alır, bu nedenle yerel bir ekran için kaynak / kilitli olmayan (unlocked) bir derleme gerekir. Yalnızca escrow sürümüne sahipseniz şunu kullanın: Yöntem A yerine (ekranınız kendi resource'unuz içinde yer alır). Resource içindeki dosyalara referans verin: apps/testapp_client.lua ve apps/dispatch_client.lua.

📋 Diğer telefon exportları

Client

Sunucu

⇄ NUI ↔ Lua köprüsü (Yöntem B)

💳 AgencyPay ödeme

Oyuncunun cüzdanından herhangi bir kaynaktan ücret tahsil edin.

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)

Sonuç payload'ı şunları içerir: status (paid / cancelled / failed), amount, cardId, balance ve sizin metadata.

A paid istemciden resource'unuza ulaşan sonuç tek başına hiçbir şeyi kanıtlamaz. Kendi id kime StartAgencyPayCheckout ve çağırın exports['agency-phone']:VerifyAgencyPayCharge(source, id, amount) herhangi bir şey vermeden önce server tarafında. Şunu döndürür: true ve tutarı yalnızca bu oyuncu ilgili ödemeyi son 60 saniye içinde yaptıysa uygular ve bakiyeyi kullanır, böylece aynı ödeme iki kez talep edilemez.

🐛 Sorun Giderme

Sorularınız mı var veya yardıma mı ihtiyacınız var? Katılın: Agency Scripts Discord.