Entegrasyon
Tüm export'lar
fx-pocketbook'un bütün client ve server export'ları; hangi tarafta çalıştıkları, kimin çağırabileceği ve başvuru sayfalarının bağlantıları.
Başka bir resource'un FX Pocketbook üzerinde çağırabileceği her şey:
lualocal book = exports['fx-pocketbook']
local open = book:IsOpen()
Resource klasörünün adı fx-pocketbook olmalıdır. Adını değiştirdiysen exports[...] içinde o adı kullan.
#Başlamadan önce
- Client export'ları oyuncunun kendi oyununda çalışır ve o oyuncunun defteri üzerinde işlem yapar.
- Server export'ları bir oyuncu (
src, server id) ya da bir karakter kimliği alır. Karakter kimliği, framework adı ile karakter anahtarından oluşur:'vorp:12'(VORP charidentifier) ya da'rsg:ABC12345'(RSG citizenid). Kartlarim export'ları, karakter kimliği verildiğinde çevrimdışı karakterler için de çalışır. - Bank ve Kartlarim export'larında para sent cinsindendir (100 = 1 dolar). Fatura export'ları dolar alır ve dolar döndürür.
- Tarihler unix saniyesidir (
os.time()). - Veritabanını okuyan ya da yazan server export'ları veritabanını bekler. Bunları her karede değil, bir thread'den ya da bir event handler'dan çağır.
- Bazı export grupları yalnızca adıyla izin verdiğin resource'lara cevap verir. Aşağıdaki erişim sütununa bak.
#Client export'ları
| Export | Amaç | Başvuru |
|---|---|---|
Open |
Defteri açar | Defter |
Close |
Defteri kapatır | Defter |
IsOpen |
Defterin açık olup olmadığı | Defter |
OpenApplication |
Defteri yerleşik bir uygulamada açar | Defter |
IsPlacingRelay |
Oyuncunun direk ya da fonograf yerleştirip yerleştirmediği | Defter |
Notify |
Defterde bildirim gösterir | Bildirimler ve sinyal |
GetSignal |
Sinyal çubukları, 0 ile 5 arası | Bildirimler ve sinyal |
CanUseOnline |
Sinyalin göndermeye ya da almaya yetip yetmediği | Bildirimler ve sinyal |
AddCustomApp |
Deftere kendi uygulamanı ekler | Özel uygulamalar |
RemoveCustomApp |
Uygulamanı kaldırır | Özel uygulamalar |
OpenApp |
Defteri senin uygulamanda açar | Özel uygulamalar |
SendCustomAppMessage |
Uygulamanın sayfasına veri gönderir | Özel uygulamalar |
#Server export'ları
| Export | Amaç | Erişim | Başvuru |
|---|---|---|---|
Notify |
Bir oyuncuya bildirim gönderir | her resource | Bildirimler ve sinyal |
GetSignal |
Bir oyuncunun sinyal çubukları | her resource | Bildirimler ve sinyal |
CanUseOnline |
Bir oyuncunun sinyalinin yetip yetmediği | her resource | Bildirimler ve sinyal |
IssueDocument |
Belge verir (kimlik, ruhsat) | Kartlarim listesi | Belgeler |
RevokeDocument |
Belgeyi siler | Kartlarim listesi | Belgeler |
SetDocumentStatus |
Belgeyi geçerli, askıda ya da süresi dolmuş yapar | Kartlarim listesi | Belgeler |
GetDocuments |
Bir karakterin belgeleri | Kartlarim listesi | Belgeler |
HasValidDocument |
Karakterin bir türde geçerli belgesi olup olmadığı | Kartlarim listesi | Belgeler |
AddDeed |
Tapu verir (ev, çiftlik, dükkân, ahır) | Kartlarim listesi | Tapular ve anahtarlar |
RemoveDeed |
Tapuyu ve anahtarlarını siler | Kartlarim listesi | Tapular ve anahtarlar |
TransferDeed |
Tapuyu yeni sahibine geçirir | Kartlarim listesi | Tapular ve anahtarlar |
SetDeedTax |
Tapudaki vergi satırını değiştirir | Kartlarim listesi | Tapular ve anahtarlar |
GiveDeedKey |
Birine anahtar verir | Kartlarim listesi | Tapular ve anahtarlar |
TakeDeedKey |
Anahtarı geri alır | Kartlarim listesi | Tapular ve anahtarlar |
GetDeedAccess |
Karakterin tapunun sahibi mi, anahtarı mı olduğu | Kartlarim listesi | Tapular ve anahtarlar |
GetDeeds |
Bir karakterin sahibi olduğu tapular | Kartlarim listesi | Tapular ve anahtarlar |
BankAddTransaction |
Karakterin banka geçmişine satır yazar | her resource | Banka |
GetBankData |
Karakterin hesap numarası ve ek hesapları | her resource | Banka |
CreateInvoice (SendInvoice) |
Bir oyuncu adına fatura keser | Billing listesi | Faturalar |
PayInvoice |
Bir oyuncu adına fatura öder | Billing listesi | Faturalar |
CancelInvoice |
Faturayı gönderen olarak iptal eder | Billing listesi | Faturalar |
CancelInvoices |
Birkaç faturayı iptal eder | Billing listesi | Faturalar |
GetInvoices |
Bir oyuncunun faturalarından bir sayfa | Billing listesi | Faturalar |
GetInvoice |
Ödemeleriyle birlikte tek bir fatura | Billing listesi | Faturalar |
GetInvoiceStats |
Bir oyuncunun fatura toplamları | Billing listesi | Faturalar |
CheckUnpaidInvoices |
Oyuncunun gecikmiş ödenmemiş faturası olup olmadığı | Billing listesi | Faturalar |
HelpCall |
Görevdeki doktorlara yardım çağrısı bırakır | her resource | Yardım çağrıları |
SendGovernmentTelegram |
Her posta kutusuna resmî telgraf gönderir | Telegram listesi | Telgraf yönetimi |
GetGovernmentTelegramStatus |
Resmî telgrafın ilerleyişi | Telegram listesi | Telgraf yönetimi |
CancelGovernmentTelegram |
Resmî telgrafı durdurur | Telegram listesi | Telgraf yönetimi |
InspectTelegramMailbox |
Bir posta kutusunun telgraflarını okur | Telegram listesi | Telgraf yönetimi |
ReassignTelegramAddress |
Posta kutusunun adresini değiştirir | Telegram listesi | Telgraf yönetimi |
ForceCloseTelegramMailbox |
Kişisel bir posta kutusunu kapatır | Telegram listesi | Telgraf yönetimi |
RegisterApplication |
Uygulamana server aksiyonları ekler | her resource | Özel uygulama aksiyonları |
UnregisterApplication |
Uygulamanın aksiyonlarını kaldırır | yalnız sahibi | Özel uygulama aksiyonları |
ValidateApplicationPlayer |
Bir değişiklikten önce oyuncuyu yeniden kontrol eder | yalnız sahibi | Özel uygulama aksiyonları |
Parantez içindeki adlar aynı fonksiyonun başka bir adıdır.
#Erişim listeleri
Üç server export grubu, yalnızca sunucuda okunan bir config dosyasından izin listesi okur. Bu listeler boşken aynı davranmaz.
| Grup | Ayar | Boş liste demek |
|---|---|---|
| Kartlarim | apps/kartlarim/config_server.lua > API.AllowedResources |
her resource çağırabilir |
| Billing | apps/billing/config_server.lua > API.AllowedResources |
hiçbir resource çağıramaz |
| Telegram | apps/telegram/config_server.lua > Administration.AllowedResources |
hiçbir resource çağıramaz |
Bir resource'u tam klasör adıyla ekle:
luaAPI = { AllowedResources = { ['my-housing'] = true, ['my-licenses'] = true } }
Listede olmayan bir resource'tan gelen çağrı false, 'forbidden' (Kartlarim) ya da ok = false olan bir tablo (Billing, Telegram) döndürür.
#Yalnız sahibinin çağırabildiği export'lar
RemoveCustomApp, OpenApp, SendCustomAppMessage, UnregisterApplication ve ValidateApplicationPlayer yalnızca uygulamayı kaydeden resource için çalışır. Başka bir resource'tan gelen çağrı false döndürür.