QBESXStandalone
Agency-Lifeinvader V3 Exports & API
A agência de publicidade da cidade para FiveM em QBCore, Qbox, ESX ou totalmente independente.
v3.2.0Pago5 Páginas
01Exports do cliente
| Export | Descrição |
|---|---|
OpenApp(tab) | Abre o app na página indicada: 'feed', 'create', 'mine', 'drafts' ou 'settings'. Sem uma página, abre a última página usada ou o feed ao vivo. |
OpenFeed() | Abre o app no feed ao vivo. |
CloseApp() | Fecha o app. |
IsOpen() | Verdadeiro enquanto o app estiver aberto neste cliente. |
02Exports do servidor
| Export | Descrição |
|---|---|
PostAd(text, opts) | Publica um anúncio do próprio servidor: gratuito, nunca revisado e primeiro na fila. opts: author, category, instant (executa imediatamente), reps, interval, duration e boosted. Retorna o ID do anúncio ou nil e um código de erro. |
GetFeed(limit) | O feed ao vivo como aparece no app, do mais recente para o mais antigo: id, text, category, boosted, author (nil para anúncios anônimos), sentAt, created, sent e live. |
GetAd(id) | Um anúncio no mesmo formato do feed ou nil. |
IsAdmin(source) | Verdadeiro quando o jogador é administrador do Lifeinvader por ACE, grupo ou identificador. |
03Eventos
| Nome | Lado | Descrição |
|---|---|---|
agency-lifeinvader:adShown | Cliente | Evento local em cada cliente quando um anúncio aparece na tela, com id, text, category, catLabel, icon, author (nil quando anônimo), boosted, duration e system (true para anúncios oficiais). |
agency-lifeinvader:adBroadcast | Servidor | Evento local no servidor sempre que um anúncio é executado, com o anúncio no formato do feed. Útil para logs ou um webhook do Discord. |
agency_lifeinvader:openMenu | Cliente | Mantido desde V3: abre o app em Novo anúncio, para que os scripts que abriam o menu antigo continuem funcionando. |
agency_lifeinvader:openRecentMenu | Cliente | Mantido desde V3: abre o app no feed ao vivo. |
+Bom saber
Outros scripts podem publicar anúncios, ler o feed, abrir a aplicação e reagir a todos os anúncios através dos exports e eventos de Agency-LifeinvaderV3.
- Publicar a partir dos seus scripts
- PostAd coloca um anúncio do próprio servidor em todos os ecrãs: gratuito, nunca sujeito a revisão e sempre no início da fila, com autor e categoria próprios.
- Ler o feed
- GetFeed e GetAd devolvem anúncios no formato do feed em direto, para sites, jornais ou aplicações de telemóvel.
- Reaja aos anúncios
- agency-lifeinvader:adShown é acionado em cada cliente quando um anúncio aparece, agency-lifeinvader:adBroadcast é acionado no servidor sempre que um anúncio é exibido. Os eventos V3 que abriam os menus continuam funcionando.
?Perguntas frequentes
PostAd custa dinheiro ou precisa de aprovação?
Não. Os anúncios do servidor são gratuitos, nunca são revisados e passam para o início da fila. Com instant = true, o anúncio é exibido imediatamente.