OnClientResourceFileDownload: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Fix error with code ( the first parameter was used as resource name ))
Line 19: Line 19:
This example will output the file's resource name/file name/size/state when downloading:
This example will output the file's resource name/file name/size/state when downloading:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function writeMsg (resourceName, fileName, fileSize, fileState)
function writeMsg (fileResource, fileName, fileSize, state)
     outputChatBox ("Resource name: "..resourceName..", file name: "..fileName..", size: "..fileSize..", state: "..fileState)
    local resourceName = getResourceName( fileResource )
     outputChatBox ( "Resource name: " .. resourceName .. ", file name: " .. fileName .. ", size: " .. fileSize .. ", state: " .. state)
end
end



Revision as of 18:03, 4 October 2021

This event is triggered every time a resource file download is queued, finished or has failed.

Dialog-warning.png Warning: This event is NOT related to downloadFile and onClientFileDownloadComplete!

Parameters

resource fileResource, string fileName, number fileSize, string state
  • fileResource: Resource the file belongs to.
  • fileName: Relative resource file path.
  • fileSize: Size of the file in bytes.
  • state: Possible values: "queued" or "finished" or "failed".

Source

The source of this event is the resource's root element.

Example

This example will output the file's resource name/file name/size/state when downloading:

function writeMsg (fileResource, fileName, fileSize, state)
    local resourceName = getResourceName( fileResource )
    outputChatBox ( "Resource name: " .. resourceName .. ", file name: " .. fileName .. ", size: " .. fileSize .. ", state: " .. state)
end

addEventHandler ("onClientResourceFileDownload", root, writeMsg)

Requirements

Minimum server version n/a
Minimum client version 1.5.8-9.20788

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.5.8-9.20788" />

See Also

Client resource events


Client event functions