Ö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;
  }
});
  • visibility false bildirdiğinde zamanlayıcıları ve animasyonları durdur.
  • true bildirdiğ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:phoneToggled açı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 insetTop ve insetBottom kadar 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 theme değerini sorgu dizesinden oku, sonra ready ve theme mesajlarını takip et. Telefon #f2f2f7 ve #000000 arka planlarını, #ffffff ve #1c1c1e kartlarını kullanır.
  • Metin girişi. Odaklanınca gönderilen focused: true içeren setFocus'u her zaman, odak kaybolunca gönderilen focused: false ile eşleştir.
  • Veriyle açma. OpenApp(id, data), sayfana ready'den sonra bir open mesajı 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:phoneLoaded olduğ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.