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:
- Resource adını değiştir. Script'in Lua kodunda
exports['lb-phone']yerineexports['fx-phone']yaz. Düzenleyebildiğin her script için tercih edilen yol budur. - Shim resource'unu başlat. Düzenleyemediğin script'ler için (escrow'lu uygulamalar,
dependenciesaltındalb-phonelisteleyen resource'lar) FX Phone,lb-phoneadında isteğe bağlı bir resource ile gelir; bu resourceexports['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
setup/compat/lb-phoneklasörünüfx-phonedışında, resources klasörüne kopyala ve klasör adınılb-phoneolarak bırak. FiveM,exports['lb-phone']çağrısını klasör adına göre çözer.lb-phone/ui/components.jsdosyasının var olduğunu kontrol et. Bu dosyafx-phone/html/compat/lb-components.jsdosyasının bir kopyasıdır. Bir FX Phone güncellemesinden sonra yeni dosyayı bunun üzerine kopyala.- 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.