QBESXStandalone
Agency-Phone Exports & API
Ahora con AgencyOS27: una actualización gratuita para todos los que ya tienen el teléfono.
v27.1.2De pago8 Páginas
01Exports de cliente
| Export | Descripción |
|---|---|
IsPhoneOpen() | Devuelve true si la interfaz del teléfono está abierta. |
IsPhonePoweredOn() | Devuelve true si el teléfono está encendido (false si el jugador lo apagó). |
GetPhoneData() | Devuelve la tabla PhoneData completa del cliente (estado de apertura, metadatos, etc.). |
GetPhonePropEntity() | Devuelve el handle de entidad del prop del teléfono en la mano, o 0 si no es visible. |
IsPhoneExpanded() | Alias de IsPhoneOpen() que se mantiene por compatibilidad. |
HasCarrierContract() | Devuelve true si el jugador tiene un plan de datos activo. |
GetPhoneState() | Devuelve la tabla { isOpen, poweredOn, syncEnabled } con el estado actual del teléfono. |
HasPhone() | Devuelve true si el jugador tiene en el inventario el objeto de teléfono configurado. |
RegisterAgencyPayPoint(id, data) | Registra en tiempo de ejecución un terminal Agency Pay en una coordenada (marcadores, blip, datos del cobro). |
RemoveAgencyPayPoint(id) | Elimina por su id un terminal Agency Pay registrado antes. |
StartAgencyPayCheckout(data) | Abre el teléfono si hace falta e inicia un cobro Agency Pay con los datos de pago indicados. |
StartCall(contactData) | Inicia una llamada saliente al contacto indicado ({ name, number, ... }). |
PhoneNotification(title, text, icon, color, timeout, acceptIcon, denyIcon) | Muestra una notificación con botones de aceptar/rechazar, espera la respuesta y devuelve true/false. |
RegisterApp(config) | Pone una app de tu propio resource en la pantalla de inicio del teléfono y en la Store. Devuelve true, o false y un error. Consulta Apps Personalizadas. |
UnregisterApp(id) | Quita una app añadida con RegisterApp. Ocurre por sí solo cuando se detiene el resource que la registró. |
GetRegisteredApps() | Devuelve la tabla de todas las apps registradas por otros resources, indexada por id. |
ClosePhone() | Cierra el teléfono, por ejemplo antes de que se abra tu propia interfaz. |
IsPhoneRadioActive() | Devuelve dos valores: true mientras suena la radio del teléfono, y la emisora que está sonando. |
StopPhoneRadio() | Detiene la radio del teléfono. |
02Exports de servidor
| Export | Descripción |
|---|---|
SendMail(identifier, mailData) | Envía un correo al buzón principal del jugador según su identificador (devuelve si tuvo éxito). |
AddChirp(chirpData) | Publica una entrada en el feed Pulse en nombre del script ({ identifier, firstName, lastName, message, postId }). |
usePhone(event, item, inventory, slot, data) | Hook de ox_inventory que se registra al detectar ESX + ox_inventory; abre el teléfono para el dueño del inventario. |
VerifyAgencyPayCharge(source, requestId, minAmount) | Confirma en el servidor que este jugador pagó el cobro Agency Pay con ese id en los últimos 60 segundos, por al menos minAmount, y consume el cobro para que cuente una sola vez. requestId es el id que pasaste a StartAgencyPayCheckout. Devuelve true y el importe, o false. Llámalo antes de entregar la mercancía. |
03Eventos
| Nombre | Lado | Descripción |
|---|---|---|
agency-phone:client:notify | Cliente | Muestra una notificación en el teléfono (title, text, icon, color, timeout, silent). |
agency-phone:client:usePhoneItem | Cliente | Inicia la apertura del teléfono cuando se usa el objeto de teléfono del inventario. |
agency-phone:client:openApp | Cliente | Pide al teléfono que abra una app personalizada por su id (lo usan los módulos de apps). |
agency-phone:client:newMailNotify | Cliente | Avisa al cliente de un correo recién recibido. |
agency-phone:server:requestPhoneData | Servidor | Solicita una nueva sincronización de los datos del teléfono para el jugador que llama. |
agency-phone:server:cancelCall | Servidor | Cancela o termina una llamada activa. |
agency-phone:server:sendMessage | Servidor | Envía un SMS (newMsg, targetNumber). |
agency-phone:server:saveSetting | Servidor | Guarda para el jugador un ajuste del teléfono como clave/valor. |
agency-phone:server:airdropPay | Servidor | Realiza una transferencia Agency Airdrop a un jugador cercano. |
agency-phone:server:buyDataPlan | Servidor | Compra un plan de datos para el jugador (price, planName). |
agency-phone:dispatch:create | Servidor | Crea un aviso de despacho a partir de una llamada o SMS de emergencia. |