TriggerLatentServerEvent: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 37: Line 37:
local data = fileRead(file,100*1024*1024) --Max 100 MB
local data = fileRead(file,100*1024*1024) --Max 100 MB
fileClose(file) --Close File
fileClose(file) --Close File
triggerLantentClientEvent("onClientReadFile",5000,false,root,data) --trigger
triggerLatentClientEvent("onClientReadFile",5000,false,root,data) --trigger
end
end
</syntaxhighlight>
</syntaxhighlight>

Revision as of 15:41, 20 July 2016

This function is the same as triggerServerEvent except the transmission rate of the data contained in the arguments can be limited and other network traffic is not blocked while the data is being transferred.

Syntax

bool triggerLatentServerEvent ( string event, [int bandwidth=5000, bool persist=false,] element theElement, [arguments...] )

Required Arguments

  • event: The name of the event to trigger server-side. You should register this event with addEvent and add at least one event handler using addEventHandler.
  • theElement: The element that is the source of the event. This could be another player, or if this isn't relevant, use the root element.

Optional Arguments

  • bandwidth: The bytes per second rate to send the data contained in the arguments.
  • persist: A bool indicating whether the transmission should be allowed to continue even after the resource that triggered it has since stopped.
  • arguments...: A list of arguments to trigger with the event. You can pass any lua data type (except functions). You can also pass elements. The total amount of data should not exceed 100MB.

Returns

Returns true if the event trigger has been sent, false if invalid arguments were specified.

Example

Click to collapse [-]
Client
addEvent("onClientReadFile",true)
addEventHandler("onClientReadFile",root,function(data)
	local file = fileCreate("text.txt")					Save "data" into "text.txt"
	fileWrite(file,data)
	fileClose(file)
end)
Click to collapse [-]
Server
if fileExists("text.txt")
	file = fileOpen("test.txt")						--Open a file (you can create it yourself).
	local data = fileRead(file,100*1024*1024)				--Max 100 MB
	fileClose(file)								--Close File
	triggerLatentClientEvent("onClientReadFile",5000,false,root,data)	--trigger
end

Requirements

Minimum server version n/a
Minimum client version 1.3.0-9.03772

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3.0-9.03772" />

See Also