OnClientResourceFileDownload: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client event}}  
{{Client event}}  
{{New feature/item|3.0160|1.5.8|20788|This event is triggered every time a resource file download is queued, finished or has failed.}}
{{Added feature/item|1.5.9|1.5.8|20788|This event is triggered every time a [[resource]] file download is queued, finished or has failed.}}
 
{{Warning|This event is '''NOT''' related to [[downloadFile]] and [[onClientFileDownloadComplete]]!|true}}
{{Warning|This event is '''NOT''' related to [[downloadFile]] and [[onClientFileDownloadComplete]]!|true}}


==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
resource fileResource, string fileName, number fileSize, string state
resource fileResource, string fileName, int fileSize, string state
</syntaxhighlight>
</syntaxhighlight>
*'''fileResource:''' resource the file belongs to
*'''fileResource:''' [[Resource]] the file belongs to.
*'''fileName:''' relative resource file path
*'''fileName:''' Relative [[resource]] file path.
*'''fileSize:''' size of the file in bytes
*'''fileSize:''' Size of the file in bytes.
*'''state:''' possible values: <code>"queued"</code> or <code>"finished"</code> or <code>"failed"</code>
*'''state:''' Possible values: <code>"queued"</code> or <code>"finished"</code> or <code>"failed"</code>.


==Source==
==Source==
Line 18: Line 17:


==Example==
==Example==
{{Needs_Example}}
This example will output the file's resource name/file name/size/state when downloading:
function writeMsg (name,size,state)
<syntaxhighlight lang="lua">
function writeMsg (fileResource, fileName, fileSize, state)
    local resourceName = getResourceName( fileResource )
    outputChatBox ( "Resource name: " .. resourceName .. ", file name: " .. fileName .. ", size: " .. fileSize .. ", state: " .. state)
end


outputChatBox("resource "..name.." downloading...",0,200,0)
addEventHandler ("onClientResourceFileDownload", root, writeMsg)
 
</syntaxhighlight>
end
addEventHandler("OnClientResourceFileDownload", root, writeMsg)


==Requirements==
==Requirements==
{{Requirements||1.5.8-9.20788|}}
{{Requirements|n/a|1.5.8-9.20788|}}


==See Also==
==See Also==

Latest revision as of 15:53, 27 December 2023

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, int 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