QBESXStandalone
Agency-Lifeinvader V3 Exports & API
L’agence de publicité de la ville pour FiveM sur QBCore, Qbox, ESX ou en mode totalement autonome.
v3.2.0Payant5 Pages
01Exports client
| Export | Description |
|---|---|
OpenApp(tab) | Ouvre l’application sur la page indiquée : 'feed', 'create', 'mine', 'drafts' ou 'settings'. Sans page précisée, elle s’ouvre sur la dernière page utilisée, ou sur le fil d’actualité. |
OpenFeed() | Ouvre l’application sur le fil d’actualité. |
CloseApp() | Ferme l’application. |
IsOpen() | Vaut true lorsque l’application est ouverte sur ce client. |
02Exports serveur
| Export | Description |
|---|---|
PostAd(text, opts) | Publie une publicité pour le serveur lui-même : gratuite, jamais soumise à vérification et placée en tête de file. opts : author, category, instant (lance immédiatement), reps, interval, duration et boosted. Renvoie l’identifiant de la publicité, ou nil et un code d’erreur. |
GetFeed(limit) | Le fil d’actualité tel qu’affiché dans l’application, du plus récent au plus ancien : id, text, category, boosted, author (nil pour les publicités anonymes), sentAt, created, sent et live. |
GetAd(id) | Une publicité au même format que le fil d’actualité, ou nil. |
IsAdmin(source) | Vaut true lorsque le joueur est administrateur Lifeinvader via ACE, son groupe ou son identifiant. |
03Événements
| Nom | Côté | Description |
|---|---|---|
agency-lifeinvader:adShown | Client | Événement local sur chaque client lorsqu’une publicité apparaît à l’écran, avec id, text, category, catLabel, icon, author (nil si anonyme), boosted, duration et system (true pour les annonces officielles). |
agency-lifeinvader:adBroadcast | Serveur | Événement local sur le serveur à chaque diffusion d’une publicité, avec la publicité au format du fil d’actualité. Pratique pour les logs ou un webhook Discord. |
agency_lifeinvader:openMenu | Client | Conservé depuis V3 : ouvre l’application sur Nouvelle publicité, pour que les scripts qui ouvraient l’ancien menu continuent de fonctionner. |
agency_lifeinvader:openRecentMenu | Client | Conservé depuis V3 : ouvre l’application sur le fil d’actualité. |
+Bon à savoir
D’autres scripts peuvent publier des annonces, lire le flux, ouvrir l’application et réagir à chaque annonce via les exports et les événements de Agency-LifeinvaderV3.
- Publier depuis vos scripts
- PostAd publie une annonce du serveur lui-même sur tous les écrans : elle est gratuite, n’est jamais soumise à examen et apparaît en tête de la file, avec son propre auteur et sa propre catégorie.
- Lire le flux
- GetFeed et GetAd renvoient les annonces au format du flux en direct, pour les sites web, les journaux ou les applications de téléphone.
- Réagir aux publicités
- agency-lifeinvader:adShown se déclenche chez chaque client lorsqu'une publicité apparaît, agency-lifeinvader:adBroadcast sur le serveur à chaque diffusion d'une publicité. Les événements V3 qui ouvraient les menus fonctionnent toujours.
?Questions fréquentes
PostAd coûte-t-il de l'argent ou nécessite-t-il une vérification ?
Non. Les publicités du serveur sont gratuites, ne sont jamais vérifiées et passent en tête de la file d'attente. Avec instant = true, la publicité est diffusée immédiatement.