Geliştiriciler için ai-voice

ai-voice pma-voice 7.x’i cevaplar: aşağıdaki export’lardan pma-voice’ta da olan her biri exports['pma-voice'] altında da cevap verir. Tüm ses durumu (mesafe, frekanslar, görüşmeler, hoparlörler, susturmalar) server’a aittir ve oyuncu state bag’lerini server yazar; client’lar sadece ister. Export’ların hiçbiri beklemez. @aicore-fivem/shared içinde tiplenmemişlerdir: TypeScript’ten lib callExport("ai-voice", name, ...args) kullan.

Server export’larıCopy Anchor Link

setPlayerRadioCopy Anchor Link

Bir oyuncuyu bir telsiz frekansına koyar ve onu aktif frekansı (konuştuğu frekans) yapar. pma-voice adı.

Taraf: Server · Bekler: hayır

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

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

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey. channel sayı değilse hata fırlatır. Panelde telsiz kapalıysa hiçbir şey yapmaz. Oyuncunun katılamayacağı bir frekans (bir meslek frekansı ya da hayır diyen bir addChannelCheck) "You cannot join this frequency" bildirimiyle reddedilir. Yeni bir frekansa katılmak önceki aktif frekanstan çıkarır; oyuncunun sadece dinlediği frekanslar kalır.

setPlayerCallCopy Anchor Link

Bir oyuncuyu bir telefon görüşmesine sokar veya çıkarır. pma-voice adı.

Taraf: Server · Bekler: hayır

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

ÖrnekCopy Anchor Link

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

let nextCall = 1000;

/** İki oyuncuyu bağlar; daha sonra bitirmek için görüşme id’sini döner. */
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

Bir frekansın üyeleri. GetPlayersInRadioChannel olarak da cevap verir. pma-voice adı.

Taraf: Server · Bekler: hayır

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

Dönüş değeriCopy Anchor Link

Anahtarı server id (string olarak) olan bir tablo; o üye konuşurken değer true, değilse false. Boş bir frekans veya hatalı bir değer için {}.

addChannelCheckCopy Anchor Link

Bir frekans için kendi kuralını ekler: kimin katılabileceğine senin fonksiyonun karar verir. Resource’un durduğunda kaldırılır. pma-voice adı.

Taraf: Server · Bekler: hayır

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

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

Önce panelin frekans kuralları kontrol edilir; sonra fonksiyonunun truthy bir değer dönmesi gerekir. check fonksiyon değilse hata fırlatır.

overrideRadioNameGetterCopy Anchor Link

Telsiz üyelerinin birbiri için gördüğü adı değiştirir (Send names to radio members açıkken). pma-voice adı.

Taraf: Server · Bekler: hayır

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

İlk argüman yok sayılır (pma-voice uyumluluğu); getter her frekans için kullanılır.

isValidPlayerCopy Anchor Link

isValidPlayer(source: number): boolean

ai-voice oyuncuyu tanıyorsa (katılmış ve hazırlanmış) true.

setPlayerProximityModeCopy Anchor Link

Bir oyuncuyu panelin mesafelerinden birine geçirir.

Taraf: Server · Bekler: hayır

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

Dönüş değeriCopy Anchor Link

boolean: geçirildiyse true. Oyuncu bilinmiyorsa, index listenin dışındaysa veya bir addProximityCheck reddettiyse false.

setPlayerRangeCopy Anchor Link

Bir oyuncuya kendi belirlediğin bir mesafe verir (megafon, sahnedeki mikrofon) ya da oyuncunun seçtiği mesafeyi geri verir.

Taraf: Server · Bekler: hayır

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

Dönüş değeriCopy Anchor Link

boolean: ayarlandıysa true. Oyuncu bilinmiyorsa, metres 0.5-100 dışındaysa veya bir addProximityCheck reddettiyse false.

ÖrnekCopy Anchor Link

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

// Bir megafon eşyası: tutulurken 30 m.
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

Oyuncunun mevcut mesafesi: index (listedeki sıra), metre cinsinden distance, mode (mesafenin adı). Bilinmeyen bir oyuncu için null.

toggleMuteCopy Anchor Link

Bir oyuncuyu susturur ya da susturulmuş birinin susturmasını kaldırır. /muteply ile aynı.

Taraf: Server · Bekler: hayır

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

Dönüş değeriCopy Anchor Link

boolean: susturma değiştirildiyse true, bilinmeyen bir oyuncu için false. Oyuncu bir bildirim alır; pma-voice:playerMuted server event’i tetiklenir. Susturmalar license’a göre tutulur, bu yüzden yeniden bağlanınca da devam eder.

addProximityCheckCopy Anchor Link

Mesafe değişiklikleri için bir kural ekler. Fonksiyonun (source, index, distance) alır; false dönmek değişikliği reddeder (hem oyuncunun tuşu hem export’lar için). Resource’un durduğunda kaldırılır.

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

Birden fazla frekansCopy Anchor Link

Telefon ekleriCopy Anchor Link

DiğerleriCopy Anchor Link

Client export’larıCopy Anchor Link

pma-voice’un client export’ları (hepsi exports['pma-voice'] altında da):

ai-voice’un kendi client export’ları:

State bag’lerCopy Anchor Link

Server tarafından her oyuncuya yazılır (Player(source).state, client’ta LocalPlayer.state). Onları oku; asla yazma.

GlobalState: ai-voice:backend ("mumble" veya "enhanced"), ai-voice:takeover (kendi telsiz veya telefon efektini getiren script’ler). ai-voice AI Core’un dead bag’ini ve pma-voice’un isDead bag’ini okur.

Event’lerCopy Anchor Link

pma-voice’un net event’leri (pma-voice:syncRadioData, addPlayerToRadio, removePlayerFromRadio, setTalkingOnRadio, clSetPlayerRadio, syncCallData, addPlayerToCall, removePlayerFromCall, clSetPlayerCall), onları dinleyen telsiz arayüzleri için adlarını ve içeriklerini korur. Telsiz event’leri frekansı ek bir son argüman olarak taşır; üye tablolarının anahtarları string’dir.

// Client: oyuncu telsizde konuşurken bir "yayında" simgesi göster.
on("pma-voice:radioActive", (talking: boolean) => {
  SendNUIMessage({ action: "radio", data: talking });
});