Exports serveur

Tous les exemples de cette page s'exécutent côté serveur.

Numéros et joueurs

---@param source number
---@return string|nil
local number = exports['zs-phone']:getNumber(source)

---@param phoneNumber string
---@return number|nil
local playerSource = exports['zs-phone']:getSource('555-0142')

getSource retourne uniquement un joueur actuellement connecté et portant ce numéro.

État des appels

local inCall = exports['zs-phone']:isOnCall(source)

Démarrer un appel

local callId = exports['zs-phone']:makeCall(source, '555-0142', {
    callerLabel = 'Standard LSPD',
    receiverLabel = 'Urgences',
    anonymous = false
})

Retourne un identifiant d'appel, ou false si l'appel ne peut pas être créé. Le joueur appelant doit avoir un numéro chargé et le destinataire doit être en ligne.

local ended = exports['zs-phone']:endActiveCall(source)

Retourne false si la source n'est dans aucun appel, sinon termine l'appel et retourne true.

Notification distante

local delivered = exports['zs-phone']:notify('555-0142', {
    app = 'services',
    title = 'Central',
    body = 'Nouvelle intervention'
})

Retourne false si le numéro est hors ligne, sinon true après l'envoi au client.

Envoyer un mail

local accepted = exports['zs-phone']:mail('[email protected]', {
    sender = 'Banque de Los Santos',
    subject = 'Relevé mensuel',
    body = 'Votre relevé est disponible.'
})

Retourne false si l'adresse ou les données manquent. L'insertion est asynchrone ; true indique que la demande a été acceptée, pas que l'adresse existe.

Créer une facture

local accepted = exports['zs-phone']:bill(
    senderNumber,
    recipientNumber,
    250,
    'Réparation moteur',
    'mechanic'
)

senderNumber peut être nil pour une facture système. Cet export crée la facture interne et avertit le destinataire s'il est en ligne ; il ne doit pas être appelé en plus d'un provider de facturation qui crée déjà la même facture.

Ajouter une transaction visuelle

local accepted = exports['zs-phone']:transaction(
    '555-0142',
    -250,
    'Supérette',
    'https://example.com/klm-brand.png?v=20261013-logos2'
)

Cet export ajoute une ligne dans l'historique Portefeuille. Il ne retire et n'ajoute aucun argent au joueur.

Version

local version = exports['zs-phone']:getVersion()

La valeur est la version interne utilisée par l'updater. Ne la convertissez pas en nombre pour prendre une décision métier.

État de l'updater

local status = exports['zs-phone']:getUpdateStatus()

Retourne l'état courant de l'auto-updater du téléphone. À utiliser pour un affichage ou un diagnostic, pas comme condition de démarrage : l'updater gère lui-même son cycle.