Eksporty klienckie ai-core
Czym są eksporty klienckie ai-core, jak je wywoływać z TypeScript i Lua oraz która funkcja pomocnicza liba opakowuje każdy z nich.
Eksport kliencki to funkcja, którą kliencka strona ai-core oferuje każdemu innemu zasobowi w grze tego samego gracza. Twój skrypt kliencki wywołuje go, aby odczytać dane lokalnego gracza, ukryć HUD, dodać element menu radialnego, sprawdzić przedmiot, odtworzyć emotkę i tak dalej.
Większość tych eksportów to warstwy: ai-core nie wykonuje zadania sam, tylko przekazuje wywołanie do skryptu, którego serwer używa do tego zadania (ekwipunek, skrypt ubrań, menu radialne, menu emotek, skrypt śmierci, MDT). Twój skrypt wywołuje jedną nazwę i działa dalej, gdy właściciel serwera zamieni jeden z tych skryptów na inny.
Zanim zaczniesz
- Każdy eksport kliencki jest synchroniczny: odpowiada od razu i nigdy nie czeka. Nic na tych stronach nie zwraca Promise i nic nie potrzebuje wątku w Lua. Jedyny eksport, którego odpowiedź wymaga czasu (
OpenItemPicker), odpowiada przez zdarzenie. - Wywołuj je tylko z kodu klienckiego. Serwer ma własną listę: eksporty serwerowe ai-core.
- ai-core musi być uruchomiony. Zasób, który może działać bez ai-core, używa w TypeScript
optionalExport("ai-core")(jestnull, dopóki ai-core jest zatrzymany). - Każdy eksport odpowiada też z zamienioną wielkością pierwszej litery:
GetPlayerDataigetPlayerDatato ta sama funkcja. - Rzeczy, które zasób dodaje przez te eksporty (powody ukrycia HUD, podpowiedzi klawiszy, elementy radialne, wstrzymania synchronizacji świata), należą do tego zasobu. ai-core usuwa je, gdy zasób się zatrzymuje, więc awaria lub restart nigdy nie zostawia ukrytego HUD ani martwego elementu menu.
Wywołanie eksportu
import { resourceExport } from "@aicore8/lib/client";
// Jeden typowany uchwyt na początku pliku. Typy pochodzą z @aicore8/shared (AiCoreClientExports).
const core = resourceExport("ai-core");
RegisterCommand(
"myjob",
() => {
const data = core.GetPlayerData();
console.log(data ? `job: ${data.job.job}` : "no character loaded");
},
false,
);Używaj funkcji pomocniczej liba, gdy istnieje
Większość eksportów ma funkcję pomocniczą w @aicore8/lib/client i tę samą funkcję w aiLib dla zasobów Lua (shared_script '@ai-lib/init.lua'). Funkcje pomocnicze wywołują eksport za ciebie, sprawdzają jego odpowiedź i dodają nasłuchiwanie zmian, gdzie ono istnieje. Preferuj je; wywołuj eksport bezpośrednio, gdy nie możesz użyć liba.
| Eksport | Lib TypeScript | aiLib w Lua | Strona |
|---|---|---|---|
GetPlayerData, IsPlayerLoaded, GetDefinitions | getPlayerData, onPlayerData | aiLib.playerData.get, aiLib.playerData.onChange | Gracz |
HideHud, ShowHud, IsHudVisible | hud.hide, hud.show, hud.visible, hud.onChange | aiLib.hud.hide, aiLib.hud.show, aiLib.hud.visible | HUD |
OpenHudSettings, HasHudSettings | brak | brak | HUD |
ShowKeyHint, HideKeyHint | keyHints.show, keyHints.hide | aiLib.keyHints.show, aiLib.keyHints.hide | Skróty i podpowiedzi klawiszy |
GetKeybindKey, GetKeyHints, OpenKeyboard | brak | brak | Skróty i podpowiedzi klawiszy |
PauseWorldSync, ResumeWorldSync | world.pauseSync, world.resumeSync | aiLib.world.pauseSync, aiLib.world.resumeSync | Synchronizacja pogody i czasu |
OpenInventory, HasItem, GetCurrentWeapon | inventory.openInventory, inventory.hasItem, inventory.currentWeapon | aiLib.inventory.* (te same nazwy) | Przedmioty |
OpenItemPicker | itemPicker | aiLib.itemPicker | Przedmioty |
AddRadialItem, RemoveRadialItem, RefreshRadial | radial.add, radial.remove, radial.refresh | aiLib.radial.* (te same nazwy) | Menu radialne |
IsHandsUp, IsPointing, GetGestureProvider, PlayEmote, CancelEmote, GetEmoteProvider | gestures.* | aiLib.gestures.* | Gesty i emotki |
ApplyAppearance, GetPedAppearance, OpenClothingMenu, WearOutfit, ReloadSkin | appearance.apply, read, openMenu, wearOutfit, reloadSkin | aiLib.appearance.* (te same nazwy) | Wygląd |
IsDead | medical.isDead, medical.onChange | brak (wywołaj eksport) | Leczenie |
GetSeatbelt, GetSeatbeltProvider | seatbelt.isOn, seatbelt.provider, seatbelt.onChange | aiLib.seatbelt.* (te same nazwy) | Pas bezpieczeństwa |
OpenMdt | mdt.open | aiLib.mdt.open | MDT |
ExternalNotify | brak (używany przez ai-lib) | brak | Powiadomienia |
Nie wywołuj eksportów w każdej klatce
Eksporty przechodzą przez granicę zasobu, co kosztuje więcej niż wywołanie lokalnej funkcji. Odczytaj wartość raz, potem śledź zdarzenie, które mówi, kiedy się zmienia. Każda strona wymienia to zdarzenie; wszystkie są w Zdarzenia i stan.
Menu, okna wprowadzania, powiadomienia, podpowiedzi, pasek postępu i minigry należą do ai-lib, nie do ai-core. Używaj notify, menu, input, progress i skillCheck z liba (albo tych samych nazw w aiLib).