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:

  1. Resource adını değiştir. exports['cylex_phone'] yerine exports['fx-phone'] yaz.
  2. Shim resource'unu başlat. Düzenleyemediğin script'ler için FX Phone, cylex_phone adında isteğe bağlı bir resource ile gelir; bu resource exports['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.

  1. setup/compat/cylex_phone klasörünü fx-phone dışında, resources klasörüne kopyala ve klasör adını cylex_phone olarak bırak.
  2. 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.

#İlgili sayfalar