ai-sirens для разработчиков

У ai-sirens только клиентские экспорты. Они делают то же самое, что клавиши водителя. vehicle необязателен: без него используется транспорт, в котором сидит игрок. Транспорт, который не является спецтранспортом (класс 18 и есть в списке моделей панели), игнорируется.

Lua вызывает их как exports['ai-sirens']:Name(...). Они не типизированы в @aicore-fivem/shared: в TypeScript используйте callExport("ai-sirens", "Name", ...args) из @aicore-fivem/lib/client.

Клиентские экспортыCopy Anchor Link

SetLightsCopy Anchor Link

Включает или выключает спецсигналы (и световую балку ONX, если есть).

Сторона: клиент · Ожидание: нет

SetLights(vehicle: number | undefined, on: boolean): boolean

local ok = exports['ai-sirens']:SetLights(vehicle, true)

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

true, если транспорт является спецтранспортом и огни установлены. Иначе false.

ToggleLightsCopy Anchor Link

Переключает спецсигналы.

Сторона: клиент · Ожидание: нет

ToggleLights(vehicle?: number): boolean

local ok = exports['ai-sirens']:ToggleLights()

ВозвращаетCopy Anchor Link

true, если транспорт является спецтранспортом. Иначе false.

SetSirenToneCopy Anchor Link

Устанавливает основной тон сирены. Тон больше 0 сначала включает огни.

Сторона: клиент · Ожидание: нет (сервер отвечает позже; локальное значение показывается сразу)

SetSirenTone(vehicle: number | undefined, tone: 0 | 1 | 2 | 3): boolean

local ok = exports['ai-sirens']:SetSirenTone(nil, 2)

ПараметрыCopy Anchor Link

ВозвращаетCopy Anchor Link

true, если запрос отправлен. false для транспорта, который не является спецтранспортом, или для тона вне 0-3. Запрос, который сервер не подтвердил за 1.5 секунды, считается отклонённым, и снова показывается старый тон.

ПримерCopy Anchor Link

import { callExport } from "@aicore-fivem/lib/client";

// Скрипт погони: тон 2, когда начинается погоня.
export function startPursuit(): void {
  if (!callExport("ai-sirens", "SetSirenTone", undefined, 2)) return;
  console.log("pursuit tone on");
}

ToggleSirenCopy Anchor Link

Останавливает сирену, если она работает, иначе запускает её на тоне 1 (сначала включая огни).

Сторона: клиент · Ожидание: нет

ToggleSiren(vehicle?: number): boolean

local ok = exports['ai-sirens']:ToggleSiren()

ВозвращаетCopy Anchor Link

true, если запрос отправлен, false для транспорта, который не является спецтранспортом.

CycleToneCopy Anchor Link

Следующий тон: 1, 2, 3, затем снова 1. При выключенной сирене запускает тон 1 (сначала включая огни).

Сторона: клиент · Ожидание: нет

CycleTone(vehicle?: number): boolean

local ok = exports['ai-sirens']:CycleTone()

ВозвращаетCopy Anchor Link

true, если запрос отправлен, false для транспорта, который не является спецтранспортом.

GetSirenToneCopy Anchor Link

Текущий основной тон сирены.

Сторона: клиент · Ожидание: нет

GetSirenTone(vehicle?: number): number

local tone = exports['ai-sirens']:GetSirenTone(vehicle)

ВозвращаетCopy Anchor Link

От 0 (выкл.) до 3. Также 0 для транспорта, который не является спецтранспортом.

AreLightsOnCopy Anchor Link

Включены ли спецсигналы.

Сторона: клиент · Ожидание: нет

AreLightsOn(vehicle?: number): boolean

local on = exports['ai-sirens']:AreLightsOn(vehicle)

ВозвращаетCopy Anchor Link

true, если включены. false, если выключены или это не спецтранспорт.

GetAirManuStateCopy Anchor Link

Состояние пневмосигнала и ручной сирены.

Сторона: клиент · Ожидание: нет

GetAirManuState(vehicle?: number): number

local state = exports['ai-sirens']:GetAirManuState(vehicle)

ВозвращаетCopy Anchor Link

0 выкл., 1 пневмосигнал, 2 ручная сирена, 3 оба. 0 для транспорта, который не является спецтранспортом.

GetLightbarModelCopy Anchor Link

Модель световой балки ONX, прикреплённой к транспорту.

Сторона: клиент · Ожидание: нет

GetLightbarModel(vehicle?: number): string | null

local model = exports['ai-sirens']:GetLightbarModel(vehicle)

ВозвращаетCopy Anchor Link

Название модели ("onx_pol_lbar_mdn1a") или null, если у транспорта её нет или он не является спецтранспортом.

State bagsCopy Anchor Link

Пишутся только сервером после его проверок. Читайте их на любом клиенте, чтобы знать состояние сирены транспорта.

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
local tone = Entity(vehicle).state['siren:lx'] or 0

СобытияCopy Anchor Link