Server exportları

Bildirimler ve sinyal

Bir oyuncunun defterine bildirim gönderen ve oyuncunun sinyalini okuyan server export'ları.

Bu export'ları her resource çağırabilir.

#Notify

Bir oyuncunun defterine bildirim gönderir.

lua---@param src integer player server id
---@param data table { title, message, app?, offline?, kind?, icon?, duration?, progress? }
---@return boolean sent
exports['fx-pocketbook']:Notify(src, data)
luaexports['fx-pocketbook']:Notify(source, {
    title = 'Sheriff',
    message = 'Your hunting licence expires tomorrow.',
    app = 'kartlarim',
    kind = 'warn',
})

Alanlar client [Notify](/phone/docs/pocketbook/exports/client/notifications-and-signal) ile aynıdır: yalnızca title ve message zorunludur, geçersiz bir alan atlanır.

Alan Tür Ne yapar
title string Zorunlu. 64 karaktere kısaltılır.
message string Zorunlu. 220 karaktere kısaltılır.
app string Gönderen uygulamanın id'si: adı, çizimi, sesi ve rozeti. Karta tıklamak uygulamayı açar.
offline boolean true olursa oyuncunun sinyali yokken de gösterilir.
kind string 'info', 'success', 'warn', 'error', 'money', 'mail' ya da 'telegram': renkli bir şerit. Aynı app ve kind bildirimleri "+N yeni" sayısıyla tek kartta birleşir.
icon string Kartın gönderenin çizimi yerine göstereceği çizimin uygulama id'si.
duration number Ekranda kalma süresi, ms, 1500 ile 15000 arası.
progress number ya da false Sabit çizgi için 0 ile 1 arası, çizgisiz için false.
  • Oyuncunun yüklü bir karakteri yoksa ya da title veya message string değilse false döndürür.
  • true, bildirimin oyuncuya gönderildiği anlamına gelir. Oyuncu tarafında client [Notify](/phone/docs/pocketbook/exports/client/notifications-and-signal) ile aynı kurallar geçerlidir: sinyal yoksa ve offline = true değilse sinyal gelene kadar bekler.
  • Her çağrı, çağıran resource ile birlikte server log'una yazılır.

#GetSignal

Bir oyuncunun sinyal çubuklarını server'ın gördüğü şekilde döndürür.

lua---@param src integer
---@return integer bars 0 to 5
exports['fx-pocketbook']:GetSignal(src)
lualocal bars = exports['fx-pocketbook']:GetSignal(source)

Server şöyle hesaplar:

  • Config.Signal.Enabled false ise 5.
  • Oyuncu Config.Towns içinde listelenen bir kasabadaysa 5 (oyuncunun oyunu her sorguda kasabayı bildirir; bir bildirim Config.Signal.IdleInterval × 3 ms, en az 6 saniye geçerlidir).
  • Aksi halde şunların en iyisi: aynı routing bucket'ta Config.Signal.Pole.Range metre içindeki her sinyal direği ve ayrı fx-radio resource'u başlatılmışken şarjlı aküsüyle sırtta takılı telsiz. Oyuncu direğe ne kadar yakınsa o kadar çok çubuk alır.

#CanUseOnline

Bir oyuncunun sinyalinin göndermeye ya da almaya yetip yetmediğini döndürür.

lua---@param src integer
---@param operation 'send'|'receive'
---@return boolean ok
exports['fx-pocketbook']:CanUseOnline(src, operation)
luaif not exports['fx-pocketbook']:CanUseOnline(source, 'send') then
    return { ok = false, error = 'No telegraph line here.' }
end
  • 'receive' çubukları Config.Signal.ReceiveBars ile karşılaştırır. Başka her değer Config.Signal.SendBars ile karşılaştırır.
  • Bir aksiyon hat gerektiriyorsa bunu özel uygulama aksiyonlarında çağır. Çekirdek, özel uygulamalar için sinyali kontrol etmez.