Agency-Phone Własne Aplikacje

🧩 Stwórz własną aplikację dla Agency-Phone

Są dwa sposoby na dodanie aplikacji do telefonu. Wybierz ten, który ci odpowiada:

Jeśli udostępniasz aplikację na inne serwery, użyj Metoda A. Nie wymaga kodu źródłowego od nas i działa niezmiennie pomiędzy aktualizacjami.

A SDK: zarejestruj aplikację z własnego resource

agency-phone udostępnia exporty, które pozwalają dowolnemu resource dodać aplikację z własną ikoną na ekranie głównym telefonu w czasie działania. Interfejs Twojej aplikacji znajduje się w Twoim własnym resource; telefon wyświetla ikonę i przekazuje Ci kontrolę, gdy gracz w nią kliknie. Bez edycji agency-phone, bez odblokowanego buildu.

Minimalny przykład

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

Konfiguracja RegisterApp

Eksporty SDK (client)

Zdarzenie tapnięcia

Gdy gracz dotknie twojej ikony, agency-phone wywołuje oba te zdarzenia na kliencie. Użyj tego, które wolisz:

Dodaj dependency 'agency-phone' do Twojego fxmanifest.lua aby kolejność uruchamiania była poprawna.

B Drop-in: natywny ekran wewnątrz telefonu

Dla ekranu renderowanego przez sam telefon (nie twój zasób). To edytuje własne pliki agency-phone.

Kroki 3 i 4 znajdują się w plikach zaszyfrowanych przez escrow, więc natywny ekran wymaga wersji źródłowej / odblokowanej. Jeśli masz tylko wersję escrow, użyj Metoda A zamiast tego (twój ekran znajduje się we własnym zasobie). Pliki referencyjne wewnątrz zasobu: apps/testapp_client.lua i apps/dispatch_client.lua.

📋 Inne exporty telefonu

Klient

Serwer

⇄ Mostek NUI ↔ Lua (metoda B)

💳 Płatność AgencyPay

Obciąż portfel gracza z poziomu dowolnego zasobu.

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)

Payload wynikowy zawiera status (paid / cancelled / failed), amount, cardId, balance i Twój metadata.

A paid wynik, który trafia do twojego zasobu od klienta, sam w sobie niczego nie dowodzi. Przekaż własny id do StartAgencyPayCheckout i wywołaj exports['agency-phone']:VerifyAgencyPayCharge(source, id, amount) na serwerze, zanim cokolwiek wydasz. Zwraca true oraz kwotę tylko wtedy, gdy ten gracz opłacił to zamówienie w ciągu ostatnich 60 sekund, a całość wykorzystuje charge up, więc ta sama płatność nie może zostać odebrana dwukrotnie.

🐛 Rozwiązywanie problemów

Masz pytania lub potrzebujesz pomocy? Dołącz do Agency Scripts Discord.