Uyumluluk
cylex_phone uyumluluğu
FX Phone'un koruduğu cylex_phone export adları, event'leri ve iframe mesajları ile isteğe bağlı shim resource'u.
FX Phone, cylex_phone'un export adlarını cylex'teki argüman biçimleriyle birlikte korur. cylex_phone için yazılmış bir script FX Phone üzerinde iki yoldan biriyle çalışır:
- Resource adını değiştir.
exports['cylex_phone']yerineexports['fx-phone']yaz. - Shim resource'unu başlat. Düzenleyemediğin script'ler için FX Phone,
cylex_phoneadında isteğe bağlı bir resource ile gelir; bu resourceexports['cylex_phone']çağrılarına yanıt verir ve her çağrıyı FX Phone'a iletir.
lua-- before
exports['cylex_phone']:getUserData(identifier)
-- after
exports['fx-phone']:getUserData(identifier)
Yeni script'lerde aşağıdaki tabloların sağ sütunundaki FX Phone adlarını kullan. Oyuncu verilerini cylex_phone'dan taşımak için bkz. cylex_phone'dan taşıma.
#Değişiklik yapmadan çalışanlar
| Alan | Davranış |
|---|---|
| Export adları | Aşağıdaki tablolardaki her ad exports['fx-phone'] üzerinde vardır. |
| Özel uygulama tanımı | AddCustomApp, cylex alanları olan appId, label, ui, icon ve defaultInstalled'ı okur. |
| Bildirim biçimi | PhoneNotification bir tablo ya da sıralı title, text, icon, timeout biçimini kabul eder. icon şu olabilir: { name = '...' }. data._data = { app, notification_sound } okunur. |
| Tetiklenen event'ler | cylex_phone:client:phoneLoaded, cylex_phone:customApp:opened, cylex_phone:customApp:closed. |
| Dinlenen event | cylex_phone:client:openPhone. |
| Iframe mesajları | Telefona { type: 'cylex_phone', ... } gönderen bir özel uygulama sayfası, { type: 'fx-phone', ... } gibi kabul edilir. |
#Event'ler
FX Phone bu client event'lerini kendisi tetikler. Shim gerekmez.
| Event | Argümanlar | Ne zaman tetiklenir | Birlikte tetiklenen FX Phone event'i |
|---|---|---|---|
cylex_phone:client:phoneLoaded |
yok | Telefonun yüklenmesi bittiğinde | fx-phone:client:phoneLoaded |
cylex_phone:customApp:opened |
appId |
Bir özel uygulama öne geldiğinde | fx-phone:customApp:opened |
cylex_phone:customApp:closed |
appId |
Bir özel uygulama kapandığında | fx-phone:customApp:closed |
FX Phone ayrıca bir cylex event'ini dinler:
| Event | Argümanlar | Davranış |
|---|---|---|
cylex_phone:client:openPhone |
open (isteğe bağlı boolean) |
Telefonu açar, kapatır ya da açık/kapalı durumunu değiştirir. Yalnızca cylex_phone adında bir resource başlatılmamışken işlenir; böylece cylex_phone için yazılmış meslek script'leri telefonu açmaya devam eder. |
Bu kontrol yüzünden shim resource'u çalışırken cylex_phone:client:openPhone işlenmez. Bu event'e dayanan script'ler shim olmadan çalışır; script'i düzenleyebildiğin yerlerde fx-phone:client:openPhone kullan.
#Client export'ları
| cylex_phone export'u | FX Phone export'u | Notlar |
|---|---|---|
setApp |
OpenApp |
Aynı fonksiyon, ikinci ad |
IsOpen |
IsOpen |
|
GetConfig |
GetConfig |
|
PhoneNotification |
PhoneNotification |
Tablo ya da title, text, icon, timeout. SendNotification yalnızca tablo alan biçimidir |
DoPhoneConfirmation |
DoPhoneConfirmation |
|
AddCustomApp |
AddCustomApp |
Hem cylex hem lb-phone tanımını okur |
RemoveCustomApp |
RemoveCustomApp |
|
SendCustomNUIMessage |
SendCustomAppMessage |
Aynı fonksiyon, ikinci ad |
ToggleFocusKeepInput |
ToggleFocusKeepInput |
SetInputFocus(focused) bunun tersidir |
getQuantity |
getQuantity |
Bir envanter item'ının adedi |
hasEnoughOfItem |
hasEnoughOfItem |
item, amount; amount varsayılan olarak 1'dir |
Başvuru: Telefon, Bildirimler, Diyaloglar, Özel uygulamalar, Diğer.
#Server export'ları
| cylex_phone export'u | FX Phone export'u | Notlar |
|---|---|---|
getSourceFromNumber |
GetSourceFromNumber |
Aynı fonksiyon, ikinci ad |
getUserData |
GetUserData |
Aynı fonksiyon, ikinci ad |
getUserDataBySource |
GetUserDataBySource |
Aynı fonksiyon, ikinci ad |
setUserData |
SetUserData |
Aynı fonksiyon, ikinci ad |
getUserDataList |
GetUserDataList |
Aynı fonksiyon, ikinci ad |
wipeUser |
WipeUser |
Aynı fonksiyon, ikinci ad |
PhoneNotification |
PhoneNotification |
src, data ya da src, title, text, icon, timeout |
sendMessage |
SendMessage |
Aynı fonksiyon, ikinci ad |
sendLocation |
SendCoords |
Aynı fonksiyon, ikinci ad |
sendMail |
SendMail |
cylex argümanlarıyla ayrı bir export, aşağıya bak |
addTransaction |
AddTransaction |
cylex argümanlarıyla ayrı bir export, aşağıya bak |
getBankData |
GetBankData |
Aynı fonksiyon, ikinci ad |
setBankData |
SetBankData |
Aynı fonksiyon, ikinci ad |
addBill |
AddInvoice |
cylex argümanlarıyla ayrı bir export, aşağıya bak |
addBilling |
AddInvoice |
cylex argümanlarıyla ayrı bir export, aşağıya bak |
addSystemBill |
AddInvoice |
cylex argümanlarıyla ayrı bir export, aşağıya bak |
getBills |
GetInvoices |
Aynı fonksiyon, ikinci ad |
deleteBill |
DeleteInvoice |
cylex argümanlarıyla ayrı bir export, aşağıya bak |
addGalleryPhoto |
AddGalleryPhoto |
Aynı fonksiyon, ikinci ad |
getPhotosData |
GetPhotos |
Aynı fonksiyon, ikinci ad |
Başvuru: Oyuncular, Bildirimler, Mesajlar ve posta, Banka, Faturalar, Medya.
#cylex argümanlarıyla çalışan export'lar
Bunlar yukarıdaki tabloda adı geçen FX Phone export'unun işini yapar, ama argümanlarını cylex_phone'daki gibi alır.
#addTransaction
Bir karakter için banka geçmişine bir satır ekler.
lua---@param identifier string
---@param data { amount: number, type?: 'deposit'|'withdraw', title?: string, user?: string, description?: string, date?: number|string }
---@return boolean
exports['fx-phone']:addTransaction(identifier, data)
luaexports['fx-phone']:addTransaction(citizenid, {
amount = 250, type = 'withdraw', title = 'Parking fine', description = 'Legion Square',
})
amount yoksa ya da 0 ise false döner. type değeri 'withdraw' olduğunda ya da amount negatif olduğunda satır giden işlem olarak kaydedilir.
#addBill
Bir oyuncu adına fatura gönderir.
lua---@param src number
---@param data { sender: string, receiver: { id?: number, identifier?: string }, price: number, description?: string }
---@return number|nil id
exports['fx-phone']:addBill(src, data)
luaexports['fx-phone']:addBill(source, {
sender = 'mechanic',
receiver = { id = targetSource },
price = 1500,
description = 'Engine repair',
})
sender bir meslek adı ya da bir etikettir.
#addBilling
Fatura gönderir. İlk argüman gönderenin identifier'ıdır.
lua---@param senderIdentifier string
---@param data { receiver: string, amount: number, description?: string, user?: string, type?: string }
---@return number|nil id
exports['fx-phone']:addBilling(senderIdentifier, data)
luaexports['fx-phone']:addBilling(senderIdentifier, {
receiver = citizenid,
amount = 1500,
description = 'Engine repair',
user = 'LS Customs',
type = 'mechanic',
})
receiver bir identifier ya da bir IBAN'dır. type meslektir.
#addSystemBill
Gönderen olarak bir oyuncu olmadan, sistem adına fatura gönderir.
lua---@param identifier string
---@param price number
---@param description string
---@param label? string
---@return number|nil id
exports['fx-phone']:addSystemBill(identifier, price, description, label)
luaexports['fx-phone']:addSystemBill(citizenid, 500, 'Speeding fine', 'City Hall')
#deleteBill
Bir faturayı siler.
lua---@param src number
---@param id number
---@return boolean
exports['fx-phone']:deleteBill(src, id)
luaexports['fx-phone']:deleteBill(source, invoiceId)
#sendMail
Bir karaktere e-posta gönderir.
lua---@param identifier string|nil
---@param src number|nil
---@param data { sender?: string, subject?: string, message?: string }
---@return number|false id
exports['fx-phone']:sendMail(identifier, src, data)
luaexports['fx-phone']:sendMail(citizenid, nil, {
sender = 'City Hall', subject = 'Reminder', message = 'Your licence expires soon.',
})
src verildiğinde identifier nil olabilir; bu durumda posta o oyuncunun karakterine gider.
#Shim resource'u
Shim fx-phone/setup/compat/cylex_phone içindedir. Yukarıdaki tablolardaki client ve server adlarını cylex_phone resource adı altında kaydeder ve her çağrıyı FX Phone'a iletir.
Shim'i yalnızca gerçek cylex_phone kurulu değilken başlat. İkisi aynı resource adını kullanır, birlikte çalışamaz.
setup/compat/cylex_phoneklasörünüfx-phonedışında, resources klasörüne kopyala ve klasör adınıcylex_phoneolarak bırak.- FX Phone'dan sonra başlat:
cfgensure fx-phone
ensure cylex_phone
dependencies altında 'cylex_phone' listeleyen script'ler değişiklik yapmadan başlar.
Shim üzerinden kaydedilen özel uygulamalar onu çağıran resource'a aittir ve o resource durduğunda kaldırılır. FX Phone, iletilen çağrıları yalnızca manifest'inde fx_phone_shim 'yes' bulunan, lb-phone ya da cylex_phone adındaki bir resource'tan kabul eder.