API publique du Téléphone

Le nom de ressource attendu est zs-phone. Les appels client et serveur ne sont pas interchangeables.

Exports client

Export	Paramètre principal	Résultat ou effet
`isOpen`	aucun	indique si l'interface est ouverte
`isDisabled`	aucun	indique si l'usage est bloqué
`isOnCall`	aucun	indique si le joueur est en appel
`getNumber`	aucun	numéro actif du joueur
`open` / `close`	aucun	ouvre ou ferme le téléphone
`setDisabled`	booléen	bloque ou réactive le téléphone
`notify`	données de notification	affiche une notification locale
`makeCall`	numéro cible	lance un appel
`setAction`	action	met à jour l'action courante
`SetAnimations`	table	remplace les animations
`ResetAnimations`	aucun	restaure les animations configurées
`openCam`	aucun	ouvre la caméra

Les fonctions AddNotification, GetNotifications et ClearNotifications gèrent le centre de notifications. GetBatteryLevel, SetBatteryLevel, ChargeBattery, DrainBattery et IsCharging exposent la batterie.

Applications personnalisées

Export	Usage
`AddCustomApp`	enregistre une application au runtime
`RemoveCustomApp`	retire une application par identifiant
`SendCustomAppMessage`	transmet une donnée à l'application

Enregistrez l'application après le démarrage de zs-phone et retirez-la dans le handler onResourceStop de votre ressource.

Exports serveur

Export	Usage
`getVersion`	version du téléphone
`getUpdateStatus`	état de l'updater
`getNumber`	numéro associé à une source
`getSource`	source en ligne associée à un numéro
`isOnCall`	état d'appel d'une source
`notify`	notification persistante vers un numéro
`message`	envoi d'un message
`mail`	envoi d'un e-mail
`bill`	création d'une facture
`transaction`	ajout d'une transaction Wallet
`makeCall`	création d'un appel serveur
`endActiveCall`	termine l'appel d'une source

Exemples

local number = exports['zs-phone']:getNumber(source)
if number then
    exports['zs-phone']:notify(number, {
        app = 'Messages',
        title = 'Information',
        body = 'Votre commande est prête.',
    })
end

exports['zs-phone']:mail('[email protected]', {
    subject = 'Bienvenue',
    body = 'Votre compte a bien été créé.',
})

Compatibilité

Ajoutez dependency 'zs-phone' si votre ressource dépend entièrement du téléphone.
N'utilisez pas les callbacks NUI ou événements internes comme API.
Considérez un numéro comme une chaîne : son format peut contenir des séparateurs.
Vérifiez le résultat des exports qui peuvent échouer lorsque le joueur est hors ligne.
N'envoyez jamais une donnée non validée directement dans une notification ou une application personnalisée.