QBESXStandalone
Agency-Phone Exports & API
Désormais avec AgencyOS27 : une mise à jour gratuite pour tous ceux qui ont déjà le téléphone.
v27.1.2Payant8 Pages
01Exports client
| Export | Description |
|---|---|
IsPhoneOpen() | Renvoie true si l'interface du téléphone est actuellement ouverte. |
IsPhonePoweredOn() | Renvoie true si le téléphone est allumé (false si le joueur l'a éteint). |
GetPhoneData() | Renvoie la table PhoneData complète côté client (état d'ouverture, métadonnées, etc.). |
GetPhonePropEntity() | Renvoie le handle d'entité du prop de téléphone tenu en main, ou 0 s'il n'est pas visible. |
IsPhoneExpanded() | Alias de IsPhoneOpen() conservé pour la rétrocompatibilité. |
HasCarrierContract() | Renvoie true si le joueur a un forfait data actif. |
GetPhoneState() | Renvoie la table { isOpen, poweredOn, syncEnabled } qui résume l'état actuel du téléphone. |
HasPhone() | Renvoie true si le joueur a l'objet téléphone configuré dans son inventaire. |
RegisterAgencyPayPoint(id, data) | Enregistre à la volée un terminal Agency Pay à une coordonnée (marqueurs, blip, données de paiement). |
RemoveAgencyPayPoint(id) | Supprime par son id un terminal Agency Pay enregistré auparavant. |
StartAgencyPayCheckout(data) | Ouvre le téléphone si nécessaire et lance un paiement Agency Pay avec les données fournies. |
StartCall(contactData) | Lance un appel sortant vers le contact fourni ({ name, number, ... }). |
PhoneNotification(title, text, icon, color, timeout, acceptIcon, denyIcon) | Affiche une notification avec boutons accepter/refuser, attend la réponse de l'utilisateur et renvoie true/false. |
RegisterApp(config) | Ajoute une app de votre propre resource à l'écran d'accueil du téléphone et au Store. Renvoie true, ou false et une erreur. Voir Apps Personnalisées. |
UnregisterApp(id) | Retire une app ajoutée avec RegisterApp. Se fait tout seul quand la resource qui l'a enregistrée s'arrête. |
GetRegisteredApps() | Renvoie la table de toutes les apps enregistrées par d'autres resources, indexée par id. |
ClosePhone() | Ferme le téléphone, par exemple avant l'ouverture de votre propre interface. |
IsPhoneRadioActive() | Renvoie deux valeurs : true tant que la radio du téléphone joue, et la station en cours. |
StopPhoneRadio() | Arrête la radio du téléphone. |
02Exports serveur
| Export | Description |
|---|---|
SendMail(identifier, mailData) | Envoie un mail dans la boîte principale du joueur via son identifiant (renvoie le succès). |
AddChirp(chirpData) | Publie un post dans le fil Pulse au nom du script ({ identifier, firstName, lastName, message, postId }). |
usePhone(event, item, inventory, slot, data) | Hook ox_inventory enregistré quand ESX + ox_inventory est détecté ; ouvre le téléphone pour le détenteur de l'inventaire. |
VerifyAgencyPayCharge(source, requestId, minAmount) | Confirme côté serveur que ce joueur a payé le paiement Agency Pay portant cet id dans les 60 dernières secondes, pour au moins minAmount, puis consomme le paiement pour qu'il ne compte qu'une fois. requestId est l'id passé à StartAgencyPayCheckout. Renvoie true et le montant, ou false. À appeler avant de remettre la marchandise. |
03Événements
| Nom | Côté | Description |
|---|---|---|
agency-phone:client:notify | Client | Affiche une notification sur le téléphone (title, text, icon, color, timeout, silent). |
agency-phone:client:usePhoneItem | Client | Déclenche l'ouverture du téléphone quand l'objet téléphone est utilisé dans l'inventaire. |
agency-phone:client:openApp | Client | Demande au téléphone d'ouvrir une app personnalisée par son id (utilisé par les modules d'app). |
agency-phone:client:newMailNotify | Client | Informe le client qu'un nouveau mail vient d'arriver. |
agency-phone:server:requestPhoneData | Serveur | Demande une nouvelle synchronisation des données du téléphone pour le joueur appelant. |
agency-phone:server:cancelCall | Serveur | Annule ou termine un appel en cours. |
agency-phone:server:sendMessage | Serveur | Envoie un SMS (newMsg, targetNumber). |
agency-phone:server:saveSetting | Serveur | Enregistre pour le joueur un réglage du téléphone sous forme de clé/valeur. |
agency-phone:server:airdropPay | Serveur | Effectue un virement Agency Airdrop vers un joueur à proximité. |
agency-phone:server:buyDataPlan | Serveur | Achète un forfait data pour le joueur (price, planName). |
agency-phone:dispatch:create | Serveur | Crée une intervention à partir d'un appel ou SMS d'urgence. |