AI Core
API başvurusuai-core client export’ları

ai-core client export’ları

ai-core’un client export’larının ne olduğu, onları TypeScript ve Lua’dan nasıl çağıracağın ve her birini hangi lib yardımcısının sardığı.

Bir client export’u, ai-core’un client tarafının aynı oyuncunun oyunundaki diğer her resource’a sunduğu bir fonksiyondur. Client script’in onu yerel oyuncunun verisini okumak, HUD’ı gizlemek, bir radyal menü öğesi eklemek, bir eşyayı kontrol etmek, bir emote oynatmak vb. için çağırır.

Bu export’ların çoğu katmandır: ai-core işi kendisi yapmaz, çağrıyı sunucunun o iş için çalıştırdığı script’e iletir (envanter, kıyafet script’i, radyal menü, emote menüsü, ölüm script’i, MDT). Script’in tek bir adı çağırır ve sunucu sahibi bu script’lerden birini başkasıyla değiştirdiğinde çalışmaya devam eder.

Başlamadan önce

  • Her client export’u senkrondur: hemen cevap verir ve asla beklemez. Bu sayfalardaki hiçbir şey Promise döndürmez ve Lua’da hiçbir şey thread gerektirmez. Cevabı zaman isteyen tek export (OpenItemPicker) bir event ile cevap verir.
  • Onları yalnızca client kodundan çağır. Server’ın kendi listesi vardır: ai-core server export’ları.
  • ai-core başlatılmış olmalıdır. ai-core olmadan çalışabilecek bir resource TypeScript’te optionalExport("ai-core") kullanır (ai-core durmuşken null’dır).
  • Her export ilk harfinin büyük/küçük hali değiştirilmiş adıyla da cevap verir: GetPlayerData ve getPlayerData aynı fonksiyondur.
  • Bir resource’un bu export’larla eklediği şeyler (HUD gizleme sebepleri, tuş ipuçları, radyal öğeler, dünya senkronu duraklatmaları) o resource’a aittir. Resource durduğunda ai-core onları kaldırır, böylece bir çökme ya da yeniden başlatma asla HUD’ı gizli ya da arkada ölü bir menü öğesi bırakmaz.

Export çağırmak

resource/client/index.ts
import { resourceExport } from "@aicore8/lib/client";

// Tek bir tipli tutamaç, dosyanın en üstünde. Tipler @aicore8/shared’dan (AiCoreClientExports) gelir.
const core = resourceExport("ai-core");

RegisterCommand(
  "myjob",
  () => {
    const data = core.GetPlayerData();
    console.log(data ? `job: ${data.job.job}` : "no character loaded");
  },
  false,
);

Varsa lib yardımcısını kullan

Çoğu export’un @aicore8/lib/client içinde bir yardımcısı, Lua resource’ları için de aiLib üzerinde aynı yardımcısı vardır (shared_script '@ai-lib/init.lua'). Yardımcılar export’u senin için çağırır, cevabını kontrol eder ve varsa bir değişiklik dinleyicisi ekler. Onları tercih et; lib’i kullanamadığında export’u doğrudan çağır.

ExportTypeScript libLua aiLibSayfa
GetPlayerData, IsPlayerLoaded, GetDefinitionsgetPlayerData, onPlayerDataaiLib.playerData.get, aiLib.playerData.onChangeOyuncu
HideHud, ShowHud, IsHudVisiblehud.hide, hud.show, hud.visible, hud.onChangeaiLib.hud.hide, aiLib.hud.show, aiLib.hud.visibleHUD
OpenHudSettings, HasHudSettingsyokyokHUD
ShowKeyHint, HideKeyHintkeyHints.show, keyHints.hideaiLib.keyHints.show, aiLib.keyHints.hideKeybind’lar ve tuş ipuçları
GetKeybindKey, GetKeyHints, OpenKeyboardyokyokKeybind’lar ve tuş ipuçları
PauseWorldSync, ResumeWorldSyncworld.pauseSync, world.resumeSyncaiLib.world.pauseSync, aiLib.world.resumeSyncHava ve saat senkronu
OpenInventory, HasItem, GetCurrentWeaponinventory.openInventory, inventory.hasItem, inventory.currentWeaponaiLib.inventory.* (aynı adlar)Eşyalar
OpenItemPickeritemPickeraiLib.itemPickerEşyalar
AddRadialItem, RemoveRadialItem, RefreshRadialradial.add, radial.remove, radial.refreshaiLib.radial.* (aynı adlar)Radyal menü
IsHandsUp, IsPointing, GetGestureProvider, PlayEmote, CancelEmote, GetEmoteProvidergestures.*aiLib.gestures.*Hareketler ve emote’lar
ApplyAppearance, GetPedAppearance, OpenClothingMenu, WearOutfit, ReloadSkinappearance.apply, read, openMenu, wearOutfit, reloadSkinaiLib.appearance.* (aynı adlar)Görünüm
IsDeadmedical.isDead, medical.onChangeyok (export’u çağır)Sağlık
GetSeatbelt, GetSeatbeltProviderseatbelt.isOn, seatbelt.provider, seatbelt.onChangeaiLib.seatbelt.* (aynı adlar)Emniyet kemeri
OpenMdtmdt.openaiLib.mdt.openMDT
ExternalNotifyyok (ai-lib kullanır)yokBildirimler

Export’ları her karede çağırma

Export’lar bir resource sınırını geçer, bu da yerel bir fonksiyon çağrısından daha pahalıdır. Bir değeri bir kez oku, sonra ne zaman değiştiğini söyleyen event’i izle. Her sayfa o event’i adlandırır; hepsi Event’ler ve durum sayfasında listelenir.

Menüler, girdi diyalogları, bildirimler, istemler, ilerleme çubuğu ve mini oyunlar ai-core’un değil, ai-lib’indir. Lib’in notify, menu, input, progress ve skillCheck’ini (ya da aiLib üzerindeki aynı adları) kullan.

Bu sayfada