ai-radialmenu dla deweloperów

Dodawanie pozycji (zalecany sposób)Copy Anchor Link

radial.addCopy Anchor Link

Dodaje pozycję do koła albo zastępuje pozycję o tym samym id.

Strona: klient · Czeka: nie

radial.add(item: RadialItem): void

aiLib.radial.add(item)

ParametryCopy Anchor Link

RadialItemCopy Anchor Link

ZwracaCopy Anchor Link

Nic.

PrzykładCopy Anchor Link

import { radial, notify, onPlayerData, getPlayerData } from "@aicore-fivem/lib/client";
import { RADIAL_VEHICLE } from "@aicore-fivem/shared";
import Locale from "common/locale";

// Kategoria policji na głównym kole, widoczna tylko na służbie.
radial.add({
  id: "police",
  label: Locale("RADIAL_POLICE"),
  icon: "shield-halved",
  canShow: () => getPlayerData("duty") === "police",
  items: [
    { id: "police_cuff", label: Locale("RADIAL_CUFF"), icon: "handcuffs", onPressed: () => emit("myscript:cuffNearest") },
  ],
});

// Pozycja we wbudowanej kategorii pojazdu.
radial.add({
  id: "myscript_windows",
  label: Locale("RADIAL_WINDOWS"),
  icon: "car-side",
  parent: RADIAL_VEHICLE,
  keepOpen: true,
  onPressed: () => notify(Locale("WINDOWS_TOGGLED"), "info"),
});

// Zmieniła się służba: ponownie odczytaj każde canShow otwartego koła.
onPlayerData("duty", () => radial.refresh());

radial.removeCopy Anchor Link

Usuwa jedną z twoich pozycji według ID. Strona: klient · Czeka: nie.

radial.remove(id: string): void

aiLib.radial.remove('myscript_windows')

radial.refreshCopy Anchor Link

Ponownie odczytuje każde canShow otwartego koła. Wywołaj to po zmianie danych, które czyta twoje canShow, gdy koło może być otwarte. Strona: klient · Czeka: nie.

radial.refresh(): void

aiLib.radial.refresh()

Własne eksporty klienta ai-radialmenuCopy Anchor Link

Wywołuje je warstwa radialna AI Core. Są typowane jako AiRadialClientExports w @aicore-fivem/shared.

Pozycje, podmenu i stany pozycji zasobu są usuwane, gdy ten zasób się zatrzymuje.

API, na które odpowiadaCopy Anchor Link

ai-radialmenu robi provide dla dwóch innych kół, więc ich nazwy eksportów do niego trafiają:

• qb-radialmenu: AddOption(data, id?) zwraca ID, pod którym przechowywana jest pozycja; RemoveOption(id). Pola pozycji title, icon (akceptowane fas fa-x), items, action (funkcja) albo type + event (client, server, command, qbcommand), shouldClose = false zostawia koło otwarte.
• tgiann-radialmenu-target: AddMenuItem(item | items, parentId?), RemoveMenuItem(id, parentId?), ClearMenuItems(), RegisterSubMenu({ id, items }), RefreshMenu(), DisableMenu(state), IsMenuDisabled(), OpenMenu(), CloseMenu(), IsMenuOpen(), HasMenuItem(id), SetMenuItemHidden(id, state), IsMenuItemHidden(id), UpdateMenuItem(id, { label?, icon? }), ResetMenuItem(id). Pola pozycji label (tekst albo { en, tr } wybierane według convara ai:locale), canInteract(args), onSelect(args), event + type + args, command, export { resource, name, args }, menu, shouldClose, whileDead.

Bez odpowiedzi: GetCurrentMenuId z tgiann-radialmenu-target, jego ustawienia i eksporty serwera oraz jego lokalne zdarzenia (menuOpened, itemSelected). Na jego API targetu odpowiada ai-target.

ZdarzeniaCopy Anchor Link

Brak dla innych skryptów. Wiadomości NUI koła (open, update, close) i callbacki (select, close) są wewnętrzne.