ai-policealert para desenvolvedores
Como enviar um alerta da polícia que chega ao ai-policealert (ou a qualquer outro script de alerta), os campos de DispatchAlert, e o próprio export do ai-policealert.
Para enviar um alerta da polícia a partir do seu script, chame o dispatch.alert(alert) da lib (TypeScript) ou aiLib.dispatch.alert(alert) (Lua). Ele passa pela camada de dispatch do AI Core e chega a qualquer sistema de alertas que o servidor usa: o ai-policealert, ou um script de alerta de terceiros suportado. Nunca chame o export do ai-policealert diretamente.
dispatch.alert
Envia um alerta da polícia (ou de outro emprego) através do AI Core. Os membros em serviço de jobs o recebem; sem jobs, quem recebe são os empregos de polícia do próprio sistema de alertas (para o ai-policealert: os Alert jobs do painel).
Lado: Servidor · Espera: não
dispatch.alert(alert: DispatchAlert): booleanlocal sent = aiLib.dispatch.alert(alert) -- booleanParâmetros
Prop
Type
DispatchAlert
Prop
Type
Retorno
true quando um sistema de alertas aceitou o alerta. false quando nenhum sistema de alertas está rodando ou o alerta é inválido (sem title).
Exemplo
import { dispatch, onClientCallback } from "@aicore-fivem/lib/server";
import { Locale } from "./locale"; // os textos traduzidos do seu recurso
// Um cliente diz que começou a arrombar um caixa eletrônico; o servidor alerta a polícia na posição do jogador.
onClientCallback("myscript:breakAtm", (source) => {
const sent = dispatch.alert({
code: "10-90",
title: Locale("ALERT_ATM_TITLE"),
message: Locale("ALERT_ATM_MESSAGE"),
source, // as coords vêm deste jogador
icon: "money-bill",
priority: "high",
});
if (!sent) console.log("no alert system is running");
return { ok: true };
});Os textos são mostrados como você os envia: traduza-os antes da chamada. Campos não listados acima são descartados. Não envie um alerta para cada ação repetida: o ai-police, por exemplo, mantém um alerta de disparos por 150 m a cada 30 s.
Export do servidor
DispatchAlert
O ponto de entrada próprio do ai-policealert. Só a camada de dispatch do AI Core o chama enquanto o ai-policealert é o sistema de alertas ativo; os scripts usam o dispatch.alert acima. Tipado como AiPoliceAlertServerExports em @aicore-fivem/shared.
Lado: Servidor · Espera: não
DispatchAlert(alert: DispatchAlert): voidexports['ai-policealert']:DispatchAlert(alert)Parâmetros
Prop
Type
Retorno
Nada. Chamá-lo diretamente pula a escolha de sistema de alertas do AI Core, e coords não é preenchido a partir de source (o AI Core faz isso antes de chamar o export).
Eventos privados
O contrato servidor-cliente próprio do script (resource/common/alerts.ts). Eles podem mudar entre versões: não os dispare nem os escute a partir de outros recursos.
| Nome | Direção | O que carrega |
|---|---|---|
ai-policealert:client:alerts | servidor -> policial | Os alertas ativos do emprego em serviço do policial (uma lista completa; uma lista vazia limpa os cartões). |
ai-policealert:client:alert | servidor -> policial | Um novo alerta. |