AddRemoteEvent: Difference between revisions
From Onset Developer Wiki
No edit summary |
No edit summary |
||
(7 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{Info|Function|Server & Client|1.0}} | {{Info|Function|Server & Client|1.0}} | ||
{{FuncDescription| | {{FuncDescription|Register a remote event that can then be called from server to client or vice versa using [[CallRemoteEvent]]}} | ||
{{FuncSyntax|AddRemoteEvent( | {{FuncSyntax|AddRemoteEvent(RemoteEventName, LuaFunction)}} | ||
{{FuncSyntaxClient|AddRemoteEvent(RemoteEventName, LuaFunction)}} | {{FuncSyntaxClient|AddRemoteEvent(RemoteEventName, LuaFunction)}} | ||
{{FuncParameters}} | {{FuncParameters}} | ||
{{FuncParam|RemoteEventName|The remote event name.}} | {{FuncParam|RemoteEventName|The remote event name.}} | ||
{{FuncParam|LuaFunction|The lua function you want to call.}} | {{FuncParam|LuaFunction|The lua function you want to call. Values you return from this function won't be transmitted to the originating CallRemoteEvent.}} | ||
{{FuncReturnValue|This function | {{FuncReturnValue|This function returns '''true''' on success.}} | ||
== Example == | == Example == | ||
Line 17: | Line 16: | ||
-- This example calls the remote event from the server side to the client side | -- This example calls the remote event from the server side to the client side | ||
-- Client side | -- Client side | ||
function ClientSetTime(time) | |||
SetTime(time) | |||
end) | end | ||
AddRemoteEvent("ClientSetTime", ClientSetTime) | |||
-- Server side | -- Server side | ||
function cmd_time(player, player_time) | |||
if (player_time == nil) then | |||
end) | return AddPlayerChat(player, "Usage: /time <time 0.0-24.0>") | ||
end | |||
player_time = tonumber(player_time) | |||
if (player_time == nil or player_time < 0 or player_time > 24) then | |||
return AddPlayerChat(player, "Parameter \"time\" 0.0-24.0") | |||
end | |||
CallRemoteEvent(player, "ClientSetTime", player_time) | |||
end | |||
AddCommand("time", cmd_time) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 37: | Line 48: | ||
-- Server side | -- Server side | ||
AddRemoteEvent( | AddRemoteEvent("OnClientRadio", function(playerid) | ||
AddPlayerChat(playerid, "Client activated radio") | AddPlayerChat(playerid, "Client activated radio") | ||
end) | end) | ||
Line 45: | Line 56: | ||
* [[CallEvent]] | * [[CallEvent]] | ||
* [[CallRemoteEvent]] | * [[CallRemoteEvent]] | ||
* [[BroadcastRemoteEvent]] | |||
* [[AddEvent]] | |||
* [[AddRemoteEvent]] | * [[AddRemoteEvent]] |
Latest revision as of 17:07, 30 December 2020
Description
Register a remote event that can then be called from server to client or vice versa using CallRemoteEvent
Syntax
AddRemoteEvent(RemoteEventName, LuaFunction)
Client Syntax
AddRemoteEvent(RemoteEventName, LuaFunction)
Parameters
- RemoteEventName
The remote event name. - LuaFunction
The lua function you want to call. Values you return from this function won't be transmitted to the originating CallRemoteEvent.
Return Value
- This function returns true on success.
Example
-- This example calls the remote event from the server side to the client side
-- Client side
function ClientSetTime(time)
SetTime(time)
end
AddRemoteEvent("ClientSetTime", ClientSetTime)
-- Server side
function cmd_time(player, player_time)
if (player_time == nil) then
return AddPlayerChat(player, "Usage: /time <time 0.0-24.0>")
end
player_time = tonumber(player_time)
if (player_time == nil or player_time < 0 or player_time > 24) then
return AddPlayerChat(player, "Parameter \"time\" 0.0-24.0")
end
CallRemoteEvent(player, "ClientSetTime", player_time)
end
AddCommand("time", cmd_time)
-- This example calls the remote event from the client side to the server side
-- Client side
AddEvent("OnKeyPress", function(key)
if key == 'R' then
CallRemoteEvent("OnClientRadio")
end
end)
-- Server side
AddRemoteEvent("OnClientRadio", function(playerid)
AddPlayerChat(playerid, "Client activated radio")
end)