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
titleveyamessagestring değilsefalsedö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 veoffline = truedeğ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.Enabledfalseise5.- Oyuncu
Config.Townsiçinde listelenen bir kasabadaysa5(oyuncunun oyunu her sorguda kasabayı bildirir; bir bildirimConfig.Signal.IdleInterval× 3 ms, en az 6 saniye geçerlidir). - Aksi halde şunların en iyisi: aynı routing bucket'ta
Config.Signal.Pole.Rangemetre 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.ReceiveBarsile karşılaştırır. Başka her değerConfig.Signal.SendBarsile karşılaştırır.- Bir aksiyon hat gerektiriyorsa bunu özel uygulama aksiyonlarında çağır. Çekirdek, özel uygulamalar için sinyali kontrol etmez.