FiveM olayları: RegisterNetEvent, TriggerServerEvent, TriggerClientEvent

Oyun ve sunucu arasındaki çoğu betik hatası olaylara indirgenir: hiçbir zaman çalışmayan bir işleyici, kimseye gönderilmeyen bir olay veya yanlış oyuncuya işaret eden bir source.

Bu makale ağ olaylarının nasıl çalıştığını, her iki yönde nasıl kaydedilecekleri ve tetiklenecekleri ve iki betiğin hiçbir zaman çarpışmayacağı şekilde adlandırılması açıklar.

#İki taraf

FiveM kaynağı istemci (oyuncu başına bir kopya) ve sunucu (bir kopya) üzerinde kod olabilir. Olaylar aracılığıyla konuşurlar:

Argümanlar serileştirilir, bu nedenle sayılar, dizeler, boolean'lar ve tablolar gönderebilirsiniz. İşlevleri gönderemezsiniz. Varlık tutamaçları her makineye yereldir, bu nedenle bunun yerine bir ağ kimliği (NetworkGetNetworkIdFromEntity) gönderin.

#İşleyici kaydetme

İşleyici, olay geldiğinde çalışan bir işlevdir. Ağdan gelen bir olay için bunu da izin verilen olarak işaretlemeniz gerekir:

RegisterNetEvent('my_script:client:notify', function(message)
    print(message)
end)

Kısa form bu: RegisterNetEvent işlevi ikinci argüman olarak olayı kaydeder ve işleyiciyi ekler. Uzun form aynı iki adımda yapar:

RegisterNetEvent('my_script:client:notify')
AddEventHandler('my_script:client:notify', function(message)
    print(message)
end)

Yalnızca AddEventHandler kullanırsanız, işleyici yerel TriggerEvent çağrıları için çalışır, ancak diğer taraftan TriggerServerEvent veya TriggerClientEvent görmezden gelinir. Bu, hiçbir şey yapmayan bir olayın en yaygın nedenidir.

#İstemciden sunucuya

-- client
TriggerServerEvent('my_script:server:buy', 'water', 2)

-- server
RegisterNetEvent('my_script:server:buy', function(item, amount)
    local src = source
    print(('player %s wants %s x %s'):format(src, amount, item))
end)

Sunucuda, global source olayı tetikleyen oyuncunun kimliğini tutar. İstemci bunu göndermez, bu nedenle argümanlarını değiştiren bir istemci tarafından sahte yapılamaz.

#Sunucudan istemciye

-- server: to one player
TriggerClientEvent('my_script:client:notify', src, 'Purchase done')

-- server: to everyone
TriggerClientEvent('my_script:client:notify', -1, 'Server restart in 5 minutes')

-- client
RegisterNetEvent('my_script:client:notify', function(message)
    print(message)
end)

TriggerClientEvent ikinci argümanı her zaman hedeftir. Unutursanız, ilk veri argümanınız oyuncu kimliği olarak okunur ve olay hiç yere gitmez.

#Beklemeden önce source'u kaydedin

source sahip olduğunuz bir değer değildir, çalışan olay için runtime'ın ayarladığı globaldir. İşleyiciniz Wait çağırırsa veya MySQL.query.await gibi getiri veren bir şey çağırırsa, bu arada başka olay çalışabilir ve source değişir.

RegisterNetEvent('my_script:server:buy', function(item, amount)
    local src = source            -- copy it first

    Wait(500)                     -- or any await
    print(src)                    -- still the right player
    print(source)                 -- may be someone else now
end)

Her sunucu işleyicisinin ilk satırı local src = source yapın ve bundan sonra src kullanın. Aynı şey, bir işleve ilettiğiniz geri çağırı içinde de geçerlidir.

#Olayları adlandırma

Olaylar tüm sunucuya globaldir: herhangi bir kaynak herhangi bir olay adını tetikleyebilir. İki betik de buy veya server:buy kaydederse, her iki işleyici de çalışır ve oyuncu ada göre tetikleyebilir.

Her olayın ön eki kaynağı ve tarafı:

'my_script:server:buy'
'my_script:client:updateJob'

Diğer betiklerin olay adlarını yeniden kullanmayın ve olayınızı giveMoney gibi genel bir ad vermeyin. Okunabilir bir ad da konsolda hangi betiğin ne gönderdiğini açık yapar.

#İstemciye asla güvenmeyin

TriggerServerEvent aracılığıyla gelen her şey bir hileci tarafından herhangi bir argümanla, herhangi bir zamanda tetiklenebilir. Sunucuda kontrol edin:

• oyuncunun bunu yapmasına izin verileceğini (iş, mesafe, soğuma),
• tutarlar ve öğe adlarının geçerli olduğunu,
• asla argümanlardan fiyat veya ödül almadığını.

RegisterNetEvent('my_script:server:buy', function(item, amount)
    local src = source
    if type(amount) ~= 'number' or amount < 1 or amount > 10 then return end
    -- look the price up on the server, do not read it from the client
end)

Tam liste sunucu olaylarını güvenli hale getirme kısmında. Arayanın geri dönmesi gereken sonuç için geri çağırı iki olaydan daha temiz: bkz. ESX, QBCore ve ox_lib'deki sunucu geri çağırıları.

#Büyük veya sık olaylar

Her olay bir ağ mesajıdır. Her karede birini tetiklemeyín ve tüm oyunculara çok büyük bir tablo göndermeyín. Sunucu konsolu güvenilir olaylar taştığında söylerse, çok fazla, çok hızlı gönderiyorsunuz: bkz. güvenilir ağ olay taşması.

#Kontrol Listesi