ai-voice dla deweloperów

ai-voice odpowiada na pma-voice 7.x: każdy poniższy eksport, który ma pma-voice, odpowiada też pod exports['pma-voice']. Serwer jest właścicielem całego stanu głosu (zasięg, częstotliwości, rozmowy, głośniki, wyciszenia) i zapisuje state bagi gracza; klienci tylko proszą. Żaden eksport nie czeka. Nie są typowane w @aicore-fivem/shared: z TypeScript używaj callExport("ai-voice", name, ...args) z biblioteki.

Eksporty serweraCopy Anchor Link

setPlayerRadioCopy Anchor Link

Ustawia gracza na częstotliwości radiowej i czyni ją aktywną (tą, na której mówi). Nazwa z pma-voice.

Strona: serwer · Czeka: nie

setPlayerRadio(source: number, channel: number | string): void

exports['pma-voice']:setPlayerRadio(source, 5)

ParametryCopy Anchor Link

ZwracaCopy Anchor Link

Nic. Rzuca wyjątek, gdy channel nie jest liczbą. Nic nie robi, gdy radio jest wyłączone w panelu. Częstotliwość, do której gracz nie może dołączyć (częstotliwość pracy albo addChannelCheck, który się nie zgadza), jest odrzucana z powiadomieniem „You cannot join this frequency”. Dołączenie do nowej częstotliwości opuszcza poprzednią aktywną; częstotliwości, których gracz tylko słucha, zostają.

setPlayerCallCopy Anchor Link

Wprowadza gracza do rozmowy telefonicznej lub go z niej wyprowadza. Nazwa z pma-voice.

Strona: serwer · Czeka: nie

setPlayerCall(source: number, callId: number | string): void

PrzykładCopy Anchor Link

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

let nextCall = 1000;

/** Connects two players; returns the call id to end it later. */
export function connect(caller: number, target: number): number {
  const id = nextCall++;
  callExport("ai-voice", "setPlayerCall", caller, id);
  callExport("ai-voice", "setPlayerCall", target, id);
  return id;
}

export function hangUp(...players: number[]): void {
  for (const p of players) callExport("ai-voice", "setPlayerCall", p, 0);
}

getPlayersInRadioChannelCopy Anchor Link

Członkowie częstotliwości. Odpowiada też jako GetPlayersInRadioChannel. Nazwa z pma-voice.

Strona: serwer · Czeka: nie

getPlayersInRadioChannel(channel: number | string): Record<string, boolean>

ZwracaCopy Anchor Link

Tabela z kluczami według ID na serwerze (jako ciąg) z true, gdy ten członek mówi, w przeciwnym razie false. {} dla pustej częstotliwości lub złej wartości.

addChannelCheckCopy Anchor Link

Dodaje własną zasadę dla jednej częstotliwości: twoja funkcja decyduje, kto może dołączyć. Usuwana, gdy twój zasób się zatrzymuje. Nazwa z pma-voice.

Strona: serwer · Czeka: nie

addChannelCheck(channel: number, check: (source: number) => boolean): void

exports['pma-voice']:addChannelCheck(911, function(source)
    return exports['ai-core']:GetDutyJob(source) == 'ambulance'
end)

Najpierw sprawdzane są zasady częstotliwości z panelu; potem twoja funkcja musi odpowiedzieć wartością prawdziwą. Rzuca wyjątek, gdy check nie jest funkcją.

overrideRadioNameGetterCopy Anchor Link

Zastępuje nazwę, którą członkowie radia widzą nawzajem (gdy Send names to radio members jest włączone). Nazwa z pma-voice.

Strona: serwer · Czeka: nie

overrideRadioNameGetter(channel: unknown, getter: (source: number) => string): void

Pierwszy argument jest ignorowany (zgodność z pma-voice); getter jest używany dla każdej częstotliwości.

isValidPlayerCopy Anchor Link

isValidPlayer(source: number): boolean

true, gdy ai-voice zna gracza (dołączył i jest skonfigurowany).

setPlayerProximityModeCopy Anchor Link

Przełącza gracza na jeden z zasięgów z panelu.

Strona: serwer · Czeka: nie

setPlayerProximityMode(source: number, index: number): boolean

ZwracaCopy Anchor Link

boolean: true, gdy przełączono. false, gdy gracz jest nieznany, index jest poza listą albo addProximityCheck odmówił.

setPlayerRangeCopy Anchor Link

Daje graczowi własny zasięg (megafon, mikrofon na scenie) albo przywraca mu wybrany przez niego zasięg.

Strona: serwer · Czeka: nie

setPlayerRange(source: number, metres: number | null): boolean

ZwracaCopy Anchor Link

boolean: true, gdy ustawiono. false, gdy gracz jest nieznany, metres jest poza 0,5-100 albo addProximityCheck odmówił.

PrzykładCopy Anchor Link

import { callExport, onClientEvent } from "@aicore-fivem/lib/server";

// Przedmiot megafon: 30 m, gdy jest trzymany.
onClientEvent("myscript:megaphone", { args: ([on]) => (typeof on === "boolean" ? [on] : null) }, (source, on) => {
  callExport("ai-voice", "setPlayerRange", source, on ? 30 : null);
});

getPlayerProximityCopy Anchor Link

getPlayerProximity(source: number): { index: number; distance: number; mode: string } | null

Bieżący zasięg gracza: index (pozycja na liście), distance w metrach, mode (nazwa zasięgu). null dla nieznanego gracza.

toggleMuteCopy Anchor Link

Wycisza gracza albo odcisza wyciszonego. To samo co /muteply.

Strona: serwer · Czeka: nie

toggleMute(source: number, seconds?: number): boolean

ZwracaCopy Anchor Link

boolean: true, gdy wyciszenie zostało przełączone, false dla nieznanego gracza. Gracz dostaje powiadomienie; wywoływane jest zdarzenie serwera pma-voice:playerMuted. Wyciszenia są przechowywane według licencji, więc przetrwają ponowne połączenie.

addProximityCheckCopy Anchor Link

Dodaje zasadę dla zmian zasięgu. Twoja funkcja dostaje (source, index, distance); odpowiedź false odrzuca zmianę (zarówno z klawisza gracza, jak i z eksportów). Usuwana, gdy twój zasób się zatrzymuje.

addProximityCheck(check: (source: number, index: number, distance: number) => boolean | void): void

Kilka częstotliwościCopy Anchor Link

Dodatki telefonuCopy Anchor Link

InneCopy Anchor Link

Eksporty klientaCopy Anchor Link

Eksporty klienta pma-voice (wszystkie także pod exports['pma-voice']):

Własne eksporty klienta ai-voice:

State bagiCopy Anchor Link

Zapisywane przez serwer na każdym graczu (Player(source).state, po stronie klienta LocalPlayer.state). Czytaj je; nigdy ich nie zapisuj.

GlobalState: ai-voice:backend ("mumble" lub "enhanced"), ai-voice:takeover (skrypty, które przynoszą własny efekt radia lub telefonu). ai-voice czyta bag dead z AI Core i bag isDead z pma-voice.

ZdarzeniaCopy Anchor Link

Zdarzenia sieciowe pma-voice (pma-voice:syncRadioData, addPlayerToRadio, removePlayerFromRadio, setTalkingOnRadio, clSetPlayerRadio, syncCallData, addPlayerToCall, removePlayerFromCall, clSetPlayerCall) zachowują nazwy i dane dla UI radia, które ich nasłuchują. Zdarzenia radia przenoszą częstotliwość jako dodatkowy ostatni argument; tabele członków mają klucze tekstowe.

// Klient: pokaż ikonę „on air”, gdy gracz mówi przez radio.
on("pma-voice:radioActive", (talking: boolean) => {
  SendNUIMessage({ action: "radio", data: talking });
});