addMusicEventHandler: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\|s([0-9])\= '''([^' ]+)'''([^ ]+) " to "|s$1= $2$3 ") |
m (fix typo) |
||
(14 intermediate revisions by 3 users not shown) | |||
Line 3: | Line 3: | ||
|game1= arma3 | |game1= arma3 | ||
|version1= 0.50 | |version1= 0.50 | ||
|eff= local | |||
|gr1= Event Handlers | |gr1= Event Handlers | ||
Line 8: | Line 10: | ||
|gr2= Sounds | |gr2= Sounds | ||
|descr= Adds [[playMusic]] event handler. Returns id of the handler or -1 when failed. | |descr= Adds [[playMusic]] event handler. Returns id of the handler or -1 when failed. Like [[addMissionEventHandler]], the music event handler is attached to the mission. | ||
See {{Link|Arma 3: Event Handlers#Music Event Handlers}}. | |||
|s1= [[addMusicEventHandler]] [type, function] | |s1= [[addMusicEventHandler]] [type, function] | ||
|p1= | |p1= type: [[String]] - "MusicStart" or "MusicStop" | ||
|p2 | |p2= function: [[String]] or [[Code]] - passed params array is [musicClassname, eventHandlerId] where: | ||
<sqf>params ["_musicClassname", "_eventHandlerId", "_currentPosition", "_totalLength"];</sqf> | |||
* musicClassName: [[String]] - [[Description.ext#Music|CfgMusic]] class name of the music that started | |||
* | * eventHandlerId: [[Number]] - event handler id (same as returned by [[addMusicEventHandler]] usage) | ||
* | * {{GVI|arma3|2.18|size= 0.75}} currentPosition: [[Number]] - current playback position in 0..1 range (see [[getMusicPlayedTime]]) | ||
* {{GVI|arma3|2.18|size= 0.75}} totalLength: [[Number]] - track total length in seconds | |||
|r1= [[Number]] - event handler id | |r1= [[Number]] - event handler id | ||
|x1= < | |x1= <sqf>private _ehID = addMusicEventHandler ["MusicStart", { hint str _this }];</sqf> | ||
|x2= < | |x2= <sqf>private _ehID = addMusicEventHandler ["MusicStop", { hint str _this }];</sqf> | ||
|seealso= [[ | |seealso= [[removeMusicEventHandler]] [[playMusic]] {{Link|Arma 3: Event Handlers#Music Event Handlers}} [[removeAllMusicEventHandlers]] [[getEventHandlerInfo]] | ||
}} | }} | ||
{{Note | |||
|user= Druid | |||
|timestamp= 20130304133000 | |||
|text= There are these two types at this time: | |||
* '''MusicStart''' - It is triggered when the music is started (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]]. | |||
* '''MusicStop''' - It is triggered when the music is ended (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]]. | |||
'''MusicStart''' - It is triggered when the music is started (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]]. | }} | ||
'''MusicStop''' - It is triggered when the music is ended (command [[playMusic]]). In variable _this is stored class name from [[Description.ext#Music|CfgMusic]]. | |||
Latest revision as of 13:01, 6 November 2024
Description
- Description:
- Adds playMusic event handler. Returns id of the handler or -1 when failed. Like addMissionEventHandler, the music event handler is attached to the mission. See Arma 3: Event Handlers - Music Event Handlers.
- Groups:
- Event HandlersSounds
Syntax
- Syntax:
- addMusicEventHandler [type, function]
- Parameters:
- type: String - "MusicStart" or "MusicStop"
- function: String or Code - passed params array is [musicClassname, eventHandlerId] where:
- musicClassName: String - CfgMusic class name of the music that started
- eventHandlerId: Number - event handler id (same as returned by addMusicEventHandler usage)
- 2.18 currentPosition: Number - current playback position in 0..1 range (see getMusicPlayedTime)
- 2.18 totalLength: Number - track total length in seconds
- Return Value:
- Number - event handler id
Examples
- Example 1:
- Example 2:
Additional Information
- See also:
- removeMusicEventHandler playMusic Arma 3: Event Handlers - Music Event Handlers removeAllMusicEventHandlers getEventHandlerInfo
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
- Posted on Mar 04, 2013 - 13:30 (UTC)
- There are these two types at this time: