Uyumluluk

lb-phone uyumluluğu

lb-phone için yazılmış script'lerin ve özel uygulamaların FX Phone'da çalışması için gerekenler ve hangi export adlarının aynen kaldığı.

FX Phone, lb-phone'un PascalCase export adlarını izler ve lb-phone'un özel uygulama tanımını kabul eder. lb-phone için yazılmış bir script ya da uygulama FX Phone üzerinde iki yoldan biriyle çalışır:

  1. Resource adını değiştir. Script'in Lua kodunda exports['lb-phone'] yerine exports['fx-phone'] yaz. Düzenleyebildiğin her script için tercih edilen yol budur.
  2. Shim resource'unu başlat. Düzenleyemediğin script'ler için (escrow'lu uygulamalar, dependencies altında lb-phone listeleyen resource'lar) FX Phone, lb-phone adında isteğe bağlı bir resource ile gelir; bu resource exports['lb-phone'] çağrılarına yanıt verir ve her çağrıyı FX Phone'a iletir.
lua-- before
exports['lb-phone']:SendNotification({ app = 'garage', title = 'Garage', content = 'Vehicle delivered.' })
-- after
exports['fx-phone']:SendNotification({ app = 'garage', title = 'Garage', content = 'Vehicle delivered.' })

FX Phone'un kendisi lb-phone resource adı altında hiçbir şey kaydetmez. Bunu yalnızca shim yapar.

#Değişiklik yapmadan çalışanlar

Alan Davranış
Export adları Aşağıdaki tablolardaki adlar exports['fx-phone'] üzerinde aynı adla vardır.
Özel uygulama tanımı AddCustomApp, lb-phone'un alanlarını okur: identifier, name, description, developer, defaultApp, size, price, images, ui, icon. fixBlur kabul edilir ama etkisi yoktur.
Event Telefon her açıldığında ya da kapandığında client'ta fx-phone:phoneToggled ile birlikte open (boolean) argümanıyla lb-phone:phoneToggled tetiklenir. Bunun için shim gerekmez.
Sayfa sinyali Telefon, kendi ready mesajının hemen ardından özel uygulama sayfasına düz 'componentsLoaded' metnini gönderir; sıra lb-phone'daki gibidir.
Sayfa fonksiyonları html/compat/lb-components.js, lb-phone'un sayfa global'lerini FX Phone'un iframe protokolü üzerinde yeniden kurar. Shim bu dosyayı lb-phone uygulamalarının zaten yüklediği URL'den sunar.
Düğme rengi Açılır pencerelerde ve bağlam menülerinde lb-phone'un color = 'red' değeri style = 'destructive' gibi okunur.
Bildirim biçimi SendNotification; title, content (ya da text veya description), icon, thumbnail, app ve timeout alanlarını okur.

#Shim resource'u

Shim fx-phone/setup/compat/lb-phone içindedir. Bu sayfada listelenen export adlarını client ve server tarafında kaydeder ve her çağrıyı iletir.

Shim'i yalnızca gerçek lb-phone kurulu değilken başlat. Shim ile lb-phone aynı resource adını kullanır, birlikte çalışamaz.

#Kurulum

  1. setup/compat/lb-phone klasörünü fx-phone dışında, resources klasörüne kopyala ve klasör adını lb-phone olarak bırak. FiveM, exports['lb-phone'] çağrısını klasör adına göre çözer.
  2. lb-phone/ui/components.js dosyasının var olduğunu kontrol et. Bu dosya fx-phone/html/compat/lb-components.js dosyasının bir kopyasıdır. Bir FX Phone güncellemesinden sonra yeni dosyayı bunun üzerine kopyala.
  3. FX Phone'dan sonra başlat:
cfgensure fx-phone
ensure lb-phone

dependencies altında 'lb-phone' listeleyen script'ler değişiklik yapmadan başlar, çünkü bu adda bir resource çalışmaktadır.

#Çağrılar kime yazılır

Shim, kendisini çağıran resource'un adını da iletir. Shim üzerinden kaydedilen özel uygulamalar, island tepsileri, açılır pencereler, tuş atamaları ve kontroller çağıran resource'a aittir ve o resource durduğunda kaldırılır; tıpkı exports['fx-phone']'u kendisi çağırmış gibi.

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.

Argüman biçimleri FX Phone'unkilerdir. Bunlar lb-phone'u izler; bir export farklı bir şey alıyorsa, o export'un başvuru sayfası bunu belirtir.

#Shim'in yanıt verdiği client export'ları

Aşağıdaki her ad, aynı adlı FX Phone export'una iletilir.

lb-phone export'u FX Phone export'u Başvuru
IsOpen IsOpen Telefon
IsPhoneOnScreen IsOpen (alias IsPhoneOnScreen) Telefon
ToggleOpen ToggleOpen Telefon
OpenApp OpenApp Telefon
CloseApp CloseApp Telefon
GetPhoneNumber GetPhoneNumber Telefon
GetEquippedPhoneNumber GetPhoneNumber (alias GetEquippedPhoneNumber) Telefon
GetConfig GetConfig Telefon
GetSettings GetSettings Telefon
GetTheme GetTheme Telefon
HasPhoneItem HasPhoneItem Telefon
ToggleDisabled ToggleDisabled Telefon
IsDisabled IsDisabled Telefon
SetPhoneVariation SetPhoneVariation Telefon
SendNotification SendNotification Bildirimler
PhoneNotification PhoneNotification Bildirimler
AddCustomApp AddCustomApp Özel uygulamalar
RemoveCustomApp RemoveCustomApp Özel uygulamalar
SendCustomAppMessage SendCustomAppMessage Özel uygulamalar
SendCustomNUIMessage SendCustomAppMessage (alias SendCustomNUIMessage) Özel uygulamalar
SetInputFocus SetInputFocus Özel uygulamalar
ToggleFocusKeepInput ToggleFocusKeepInput Özel uygulamalar
SetAppBadge SetAppBadge Özel uygulamalar
SetAppInstalled SetAppInstalled Özel uygulamalar
SetAppHidden SetAppHidden Özel uygulamalar
DoPhoneConfirmation DoPhoneConfirmation Diyaloglar
ShowComponent ShowComponent Diyaloglar
SetPopUp SetPopUp Diyaloglar
SetContextMenu SetContextMenu Diyaloglar
ShowMusicTray ShowMusicTray Dynamic Island
UpdateMusicTray UpdateMusicTray Dynamic Island
RemoveMusicTray RemoveMusicTray Dynamic Island
ShowLiveTray ShowLiveTray Dynamic Island
UpdateLiveTray UpdateLiveTray Dynamic Island
RemoveLiveTray RemoveLiveTray Dynamic Island
SetIslandIndicator SetIslandIndicator Dynamic Island
CreateCall CreateCall Aramalar
EndCall EndCall Aramalar
IsInCall IsInCall Aramalar
AddContact AddContact Aramalar
OpenCamera OpenCamera Kamera
IsCameraOpen IsCameraOpen Kamera
SaveToGallery SaveToGallery Kamera
ToggleFlashlight ToggleFlashlight Pil ve sinyal
GetFlashlight GetFlashlight Pil ve sinyal
GetCryptoWallet GetCryptoWallet Diğer
GetCoinValue GetCoinValue Diğer
AddKeyBind AddKeyBind Diğer
AddCheck AddCheck Kontroller
RemoveCheck RemoveCheck Kontroller

#Shim'in yanıt verdiği server export'ları

lb-phone export'u FX Phone export'u Başvuru
GetPhoneNumber GetPhoneNumber Oyuncular
GetEquippedPhoneNumber GetPhoneNumber (alias GetEquippedPhoneNumber) Oyuncular
GetSourceFromNumber GetSourceFromNumber Oyuncular
GetNumberFromIdentifier GetNumberFromIdentifier Oyuncular
GetIdentifierFromNumber GetIdentifierFromNumber Oyuncular
GetUserData GetUserData Oyuncular
GetUserDataBySource GetUserDataBySource Oyuncular
GetUserDataList GetUserDataList Oyuncular
SetUserData SetUserData Oyuncular
WipeUser WipeUser Oyuncular
FactoryReset FactoryReset Oyuncular
SendNotification SendNotification Bildirimler
PhoneNotification PhoneNotification Bildirimler
NotifyEveryone NotifyEveryone Bildirimler
QueueNotificationForOffline QueueNotificationForOffline Bildirimler
EmergencyNotification EmergencyNotification Bildirimler
DoPhoneConfirmation DoPhoneConfirmation Bildirimler
SendMessage SendMessage Mesajlar ve posta
SendCoords SendCoords Mesajlar ve posta
SentMoney SentMoney Mesajlar ve posta
SendMail SendMail Mesajlar ve posta
SendCompanyMessage SendCompanyMessage Mesajlar ve posta
GetOnDutyWorkers GetOnDutyWorkers Mesajlar ve posta
CreateCall CreateCall Aramalar
EndCall EndCall Aramalar
IsInCall IsInCall Aramalar
GetCall GetCall Aramalar
AddContact AddContact Aramalar
AddTransaction AddTransaction Banka
GetBankData GetBankData Banka
SetBankData SetBankData Banka
AddInvoice AddInvoice Faturalar
GetInvoices GetInvoices Faturalar
DeleteInvoice DeleteInvoice Faturalar
AddCrypto AddCrypto Kripto
RemoveCrypto RemoveCrypto Kripto
AddCustomCoin AddCustomCoin Kripto
GetCoin GetCoin Kripto
GetOwnedCoin GetOwnedCoin Kripto
AddGalleryPhoto AddGalleryPhoto Medya
GetPhotos GetPhotos Medya
AirShare AirShare Medya
GetSocialAccount GetSocialAccount Sosyal
GetActiveSocialAccount GetActiveSocialAccount Sosyal
SetSocialVerified SetSocialVerified Sosyal
SetAppData SetAppData Uygulama verisi
GetAppDataFor GetAppDataFor Uygulama verisi
GetConfig GetConfig Diğer
GetVersionStatus GetVersionStatus Diğer
AddCheck AddCheck Kontroller
RemoveCheck RemoveCheck Kontroller

Server tarafında GetPhoneNumber ve GetEquippedPhoneNumber bir server id ya da bir karakter identifier'ı alır. Sayısal bir değer önce server id olarak, sonra identifier olarak denenir.

Bu tablolarda olmayan bir ada shim yanıt vermez. Burada listelenmeyen FX Phone export'larını (örneğin pil, SIM ve yatay görünüm export'ları) doğrudan exports['fx-phone'] üzerinden çağır. Tam liste export dizininde.

#Özel uygulama sayfaları

lb-phone uygulamaları HTML'lerinde bu script'i yükler ve tanımladığı global'leri çağırır:

html<script src="https://cfx-nui-lb-phone/ui/components.js"></script>

Shim çalışırken bu URL, script'in FX Phone sürümünü sunar. Sayfa değişiklik yapmadan çalışır ve çağrıları FX Phone'un iframe mesajları üzerinden gider. Sayfa FX Phone içinde değilse script hiçbir şey yapmaz.

Sayfa global'i FX Phone'da ne yapar
resourceName, appName Sayfanın sahibi olan resource ve uygulama id'si
fetchNui(event, data) https://<resource>/<event> adresine, yani uygulamanın kendi NUI callback'ine POST yapar. Ayrıştırılmış yanıtı, hata olursa null döndürür
getSettings() { display: { theme } } değerine çözülür; theme, 'light' ya da 'dark' olur
onSettingsChange(listener) Tema değiştiğinde listener'ı aynı nesneyle çağırır
sendNotification({ title, description, icon }) Uygulamadan bir bildirim şeridi. content, description olarak; thumbnail, icon olarak okunur
setContextMenu({ title, buttons }) Bir eylem menüsü. Seçilen düğmenin cb'si çağrılır
setPopUp({ title, description, buttons }) Bir uyarı penceresi. Seçilen düğmenin cb'si çağrılır
selectGallery({ includeVideos, includeImages, multiple, cb }) Galeri seçicisi. cb, { src, type, thumbnail } alır; multiple ile bunların bir listesini alır
useCamera(cb, options) Kamera uygulamasını açar ve kaydedilen öğenin URL'siyle cb'yi çağırır
selectGif(cb), selectGIF(cb) GIF seçicisi. cb URL'yi alır
selectEmoji(cb) Emoji seçicisi. cb emojiyi alır

Script ayrıca sayfadaki bir metin alanı odaklandığında bunu telefona bildirir; böylece yazarken karakter hareket etmez. lb-phone sayfalarının bunu kendilerinin yapması gerekmez.

getSettings() yalnızca temayı döndürür. Bu nesneden lb-phone'un diğer ayarlarını okuyan bir sayfa, onlar için undefined alır.

NUI callback'leri için lb-phone'un yedek yolunu kullanan bir uygulama, bunları appId, action ve data ile <resource>:phoneApp:event client event'i olarak alır. Bkz. özel uygulama API'si.

#İlgili sayfalar