QBESXStandalone
Agency-Phone Экспорты & API
Теперь с AgencyOS27: бесплатное обновление для всех, у кого уже есть телефон.
v27.1.2Платно8 Страницы
01Клиентские экспорты
| Экспорт | Описание |
|---|---|
IsPhoneOpen() | Возвращает true, если интерфейс телефона сейчас открыт. |
IsPhonePoweredOn() | Возвращает true, если телефон включён (false, если игрок его выключил). |
GetPhoneData() | Возвращает полную клиентскую таблицу PhoneData (состояние открытия, метаданные и т. д.). |
GetPhonePropEntity() | Возвращает хэндл сущности пропа телефона в руке или 0, если он не виден. |
IsPhoneExpanded() | Псевдоним IsPhoneOpen(), оставлен для обратной совместимости. |
HasCarrierContract() | Возвращает true, если у игрока есть активный тариф оператора. |
GetPhoneState() | Возвращает таблицу { isOpen, poweredOn, syncEnabled } с текущим состоянием телефона. |
HasPhone() | Возвращает true, если у игрока в инвентаре есть настроенный предмет телефона. |
RegisterAgencyPayPoint(id, data) | Регистрирует во время работы терминал Agency Pay в заданной точке (маркеры, метка на карте, данные оплаты). |
RemoveAgencyPayPoint(id) | Удаляет ранее зарегистрированный терминал Agency Pay по id. |
StartAgencyPayCheckout(data) | При необходимости открывает телефон и запускает оплату Agency Pay с переданными данными. |
StartCall(contactData) | Начинает исходящий звонок указанному контакту ({ name, number, ... }). |
PhoneNotification(title, text, icon, color, timeout, acceptIcon, denyIcon) | Показывает уведомление с кнопками «Принять» и «Отклонить», ждёт ответа и возвращает true/false. |
RegisterApp(config) | Добавляет приложение из вашего ресурса на главный экран телефона и в Store. Возвращает true или false и ошибку. См. «Кастомные Приложения». |
UnregisterApp(id) | Удаляет приложение, добавленное через RegisterApp. Происходит само, когда останавливается ресурс, который его зарегистрировал. |
GetRegisteredApps() | Возвращает таблицу всех приложений, зарегистрированных другими ресурсами, с ключами по id. |
ClosePhone() | Закрывает телефон, например перед открытием вашего собственного интерфейса. |
IsPhoneRadioActive() | Возвращает два значения: true, пока играет радио телефона, и текущую станцию. |
StopPhoneRadio() | Останавливает радио телефона. |
02Серверные экспорты
| Экспорт | Описание |
|---|---|
SendMail(identifier, mailData) | Отправляет письмо в основной почтовый ящик игрока по идентификатору (возвращает результат). |
AddChirp(chirpData) | Добавляет пост в ленту Pulse от имени скрипта ({ identifier, firstName, lastName, message, postId }). |
usePhone(event, item, inventory, slot, data) | Хук ox_inventory, регистрируется при обнаружении ESX + ox_inventory; открывает телефон владельцу инвентаря. |
VerifyAgencyPayCharge(source, requestId, minAmount) | Проверяет на сервере, что этот игрок оплатил счёт Agency Pay с этим id за последние 60 секунд и не меньше minAmount, и списывает платёж, чтобы он засчитался только один раз. В requestId передаётся id из StartAgencyPayCheckout. Возвращает true и сумму или false. Вызывайте перед выдачей товара. |
03События
| Название | Сторона | Описание |
|---|---|---|
agency-phone:client:notify | Клиент | Показывает уведомление на телефоне (title, text, icon, color, timeout, silent). |
agency-phone:client:usePhoneItem | Клиент | Запускает открытие телефона при использовании предмета телефона из инвентаря. |
agency-phone:client:openApp | Клиент | Просит телефон открыть собственное приложение по id (используется модулями приложений). |
agency-phone:client:newMailNotify | Клиент | Сообщает клиенту о только что полученном письме. |
agency-phone:server:requestPhoneData | Сервер | Запрашивает свежую синхронизацию данных телефона для вызывающего игрока. |
agency-phone:server:cancelCall | Сервер | Отменяет или завершает активный звонок. |
agency-phone:server:sendMessage | Сервер | Отправляет SMS (newMsg, targetNumber). |
agency-phone:server:saveSetting | Сервер | Сохраняет для игрока одну настройку телефона в виде ключа и значения. |
agency-phone:server:airdropPay | Сервер | Выполняет перевод Agency Airdrop игроку поблизости. |
agency-phone:server:buyDataPlan | Сервер | Покупает игроку тариф оператора (price, planName). |
agency-phone:dispatch:create | Сервер | Создаёт вызов диспетчеру из экстренного звонка или SMS. |