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.