Radyal menü

Radyal menü, oyuncuların hızlı aksiyonlar seçmek için bir tuşla açtığı tekerlektir (araç kapıları, emote’lar, meslek aksiyonları). Script’ler öğelerini ai-core’a ekler, ai-core da onları sunucunun çalıştırdığı radyal menüye verir: ai-radialmenu ya da desteklenen üçüncü taraf biri (tgiann-radialmenu, qb-radialmenu, codem-supreme-radialmenu, ox_lib’in radyali).

ai-core her öğeyi tutar. Radyal menü yeniden başladığında ya da sunucu sahibi başka birine geçtiğinde ai-core her öğeyi kendiliğinden yeniden ekler, bu yüzden script’in öğelerini açılışta bir kez ekler ve radyal resource’u asla izlemek zorunda kalmaz. Öğeler onları ekleyen resource durduğunda kaldırılır.

AddRadialItemCopy Anchor Link

Radyal menüye bir öğe ekler ya da aynı id’ye sahip öğeyi değiştirir. Öğenin fonksiyonları (canShow, onPressed) senin resource’unun içinde çalışır.

Taraf: Client · Bekler: hayır

AddRadialItem(item: RadialItem): void

exports['ai-core']:AddRadialItem(item) -- ya da aiLib.radial.add(item)

ParametrelerCopy Anchor Link

RadialItemCopy Anchor Link

Ayrıca bkz. RadialItem.

Dönüş değeriCopy Anchor Link

Hiçbir şey. Metin bir id ya da label olmayan bir öğe eklenmez ve ai-core resource’unun adını veren bir uyarı yazar.

ÖrnekCopy Anchor Link

import { cache, radial } from "@aicore-fivem/lib/client";
import { RADIAL_VEHICLE } from "@aicore-fivem/shared";
import { Locale } from "common";

// Açılışta bir kez: araç alt menüsünde yalnızca sürücü için bir motor anahtarı.
radial.add({
  id: "myscript_engine",
  label: Locale("RADIAL_ENGINE"),
  icon: "power-off",
  parent: RADIAL_VEHICLE,
  canShow: () => cache.vehicle !== false && cache.seat === -1,
  onPressed: () => {
    if (cache.vehicle === false) return;
    SetVehicleEngineOn(cache.vehicle, !GetIsVehicleEngineRunning(cache.vehicle), false, true);
  },
});

RemoveRadialItemCopy Anchor Link

Bir öğeyi id’sine göre kaldırır.

Taraf: Client · Bekler: hayır

RemoveRadialItem(id: string): void

exports['ai-core']:RemoveRadialItem(id) -- ya da aiLib.radial.remove(id)

ParametrelerCopy Anchor Link

Dönüş değeriCopy Anchor Link

Hiçbir şey.

ÖrnekCopy Anchor Link

import { onPlayerData, radial } from "@aicore-fivem/lib/client";
import { Locale } from "common";

// Yalnızca polis olarak mesaideyken bir kelepçe aksiyonu.
onPlayerData("duty", (duty) => {
  if (duty === "police")
    radial.add({ id: "myscript_cuff", label: Locale("RADIAL_CUFF"), icon: "handcuffs", onPressed: () => ExecuteCommand("cuff") });
  else radial.remove("myscript_cuff");
});

RefreshRadialCopy Anchor Link

Açık bir tekerleğin her canShow’unu yeniden okur, böylece oyuncu bakarken öğeler belirir ya da kaybolur. Bir canShow’un okuduğu bir şey değiştikten sonra çağır (oyuncu araca bindi, mesaiye girdi).

Taraf: Client · Bekler: hayır

RefreshRadial(): void

exports['ai-core']:RefreshRadial() -- ya da aiLib.radial.refresh()

ParametrelerCopy Anchor Link

Yok.

Dönüş değeriCopy Anchor Link

Hiçbir şey. Çalışan bir radyal menü yokken hiçbir şey yapmaz.

ÖrnekCopy Anchor Link

import { onCache, radial } from "@aicore-fivem/lib/client";

// Araç öğeleri koltuğa bağlıdır: değiştiğinde yenile.
onCache("seat", () => radial.refresh());