Özel uygulamalar
Özel uygulama performansı
Ekranda değilken bir özel uygulamayı nasıl boşta tutarsın; uygulama sayfaları ve Lua tarafları için diğer öneriler.
#Neden önemli
Özel uygulama, oyuncunun oyununun içinde çalışmaya devam eden bir web sayfasıdır. Uygulama, uygulama değiştiricide olduğu sürece iframe yüklü kalır; keepOpen olan bir uygulama da kaldırılana kadar yüklü kalır. Sayfa arka planda ne yapıyorsa bunu her oyuncunun client'ında yapar.
#Gizliyken işi durdur
Telefon, sayfaya önde olup olmadığını visibility mesajıyla bildirir. visible, yalnızca uygulaman öndeyken ve telefon açık ve kilitsizken true olur.
jslet timer = null;
window.addEventListener('message', ({ data: msg }) => {
if (msg?.type !== 'fx-phone' || msg.action !== 'visibility') return;
if (msg.visible) {
timer ??= setInterval(tick, 1000);
} else {
clearInterval(timer);
timer = null;
}
});
visibilityfalsebildirdiğinde zamanlayıcıları ve animasyonları durdur.truebildirdiğinde yeniden başlat.
#Yoklama yapma, gönder
Sayfadan resource'unu yoklama. Bir şey değiştiğinde Lua'dan güncelleme gönder:
luaexports['fx-phone']:SendCustomAppMessage('garage', { action = 'vehicles', list = vehicles })
Lua tarafında, yalnızca uygulama öndeyken anlamlı olan işleri başlatıp durdurmak için fx-phone:customApp:opened ve fx-phone:customApp:closed kullan.
#keepOpen
keepOpen = true'yu yalnızca radyo ya da zamanlayıcı gibi arka planda çalışmaya devam etmesi gereken uygulamalar için kullan. keepOpen olan bir sayfa hiç kaldırılmaz; bu yüzden visibility false olduğunda kendi işini duraklatmalıdır.
#Dynamic Island güncellemeleri
Her tray güncellemesi, telefonun arayüzüne giden bir mesajdır.
- Yalnızca değişeni değiştir. Bütün tray'i yeniden göstermek yerine
UpdateMusicTray(id, 'playing', false). - İlerleyen bir konumu en fazla saniyede bir gönder.
- Yalnızca telefon açıkken gönder.
fx-phone:phoneToggledaçık olma durumunu bildirir.
lualocal phoneOpen = false
AddEventHandler('fx-phone:phoneToggled', function(open) phoneOpen = open end)
CreateThread(function()
while true do
Wait(1000)
if track and phoneOpen and MyPlayer.IsPlaying() then
exports['fx-phone']:UpdateMusicTray('myradio', 'position', position())
end
end
end)
Bir canlı etkinliği her karede değil, kendi mesafe ya da ilerleme kontrolünden güncelle.
#Sayfa boyutu
- Sayfayı hafif tut. Tek bir ekran için büyük bir framework gerekmez.
- Görselleri 390 px genişliğinde bir ekrana göre boyutlandır.
#Düzen ve giriş
- Kenar boşlukları. Sayfana
insetTopveinsetBottomkadar iç boşluk ver. Durum çubuğunun altında kalan başlıklara ve ana ekran çizgisinin altında kalan düğmelere güvenilir şekilde dokunulamaz. - Tema. İlk çizim için
themedeğerini sorgu dizesinden oku, sonrareadyvethememesajlarını takip et. Telefon#f2f2f7ve#000000arka planlarını,#ffffffve#1c1c1ekartlarını kullanır. - Metin girişi. Odaklanınca gönderilen
focused: trueiçerensetFocus'u her zaman, odak kaybolunca gönderilenfocused: falseile eşleştir. - Veriyle açma.
OpenApp(id, data), sayfanaready'den sonra biropenmesajı olarak ulaşır; böylece sayfa henüz yüklenmemiş olsa bile derin bağlantı çalışır.
#Kayıt
- Resource'un başladığında bir kez,
fx-phone:client:phoneLoadedolduğunda bir kez kaydet. Döngü içinde kaydetme. AddCustomApp'i aynı id ile yeniden çağırmak uygulamayı günceller; ikinci bir uygulama eklemez.
#Server tarafı
Sayfanın resource'una gönderdiği her şey oyuncunun client'ından gelir. Bunu server tarafında doğrula ve saklanan değerleri küçük tut: uygulama verisi anahtar başına 16 KB ile sınırlıdır.