Agency-Phone Apps Personnalisées

🧩 Créer une app personnalisée pour Agency-Phone

Il existe deux façons d'ajouter une app au téléphone. Choisissez celle qui vous convient :

Si vous distribuez une app à d'autres serveurs, utilisez la méthode A. Elle ne demande aucun code source de notre part et continue de fonctionner après les mises à jour.

A SDK : enregistrer une app depuis votre propre resource

agency-phone fournit des exports qui permettent à n'importe quelle resource d'ajouter à la volée une app avec sa propre icône sur l'écran d'accueil du téléphone. L'interface de votre app reste dans votre resource ; le téléphone affiche l'icône et vous passe la main quand le joueur la touche. Aucune modification d'agency-phone, aucun build déverrouillé.

Exemple minimal

-- 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)

Configuration de RegisterApp

Exports du SDK (client)

L'événement au toucher

Quand le joueur touche votre icône, agency-phone déclenche ces deux événements côté client. Utilisez celui que vous préférez :

Ajoutez dependency 'agency-phone' à votre fxmanifest.lua pour que l'ordre de démarrage soit correct.

B Drop-in, un écran natif dans le téléphone

Pour un écran dessiné par le téléphone lui-même (et non par votre resource). Cela modifie les fichiers d'agency-phone.

Les étapes 3 et 4 se trouvent dans des fichiers chiffrés par l'escrow ; un écran natif nécessite donc un build avec sources ou déverrouillé. Si vous n'avez que la version escrow, utilisez plutôt la méthode A (votre écran vit dans votre propre resource). Fichiers de référence dans la resource : apps/testapp_client.lua et apps/dispatch_client.lua.

📋 Autres exports du téléphone

Client

Serveur

⇄ Pont NUI ↔ Lua (méthode B)

💳 Paiement AgencyPay

Débitez le wallet du joueur depuis n'importe quelle resource.

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)

Le résultat contient status (paid / cancelled / failed), amount, cardId, balance et vos metadata.

Un résultat paid qui arrive du client jusqu'à votre resource ne prouve rien à lui seul. Passez votre propre id à StartAgencyPayCheckout et appelez exports['agency-phone']:VerifyAgencyPayCharge(source, id, amount) côté serveur avant de remettre quoi que ce soit. La fonction ne renvoie true et le montant que si ce joueur a réglé ce paiement dans les 60 dernières secondes, puis elle consomme le paiement pour qu'il ne puisse pas être réclamé deux fois.

🐛 Dépannage

Des questions ou besoin d'un coup de main ? Rejoignez le Discord d'Agency Scripts.