playMusic: Difference between revisions

Latest revision as of 21:24, 2 September 2024

1.00

Hover & click on the images for description

Description

Description:

Plays music defined in Description.ext's CfgMusic or config.cpp. If the musicName could not be found a message is logged into the .rpt file: Music <musicName> not found.

ⓘ

To stop the music, use playMusic "";.

Groups:

Sounds

Syntax

Syntax:: playMusic musicName
Parameters:: musicName: String - music classname
Return Value:: Nothing

Alternative Syntax

Syntax:: playMusic [musicName, start]
Parameters:: musicName: String - music classname
: start: Number - start, in seconds. Can be negative.
Return Value:: Nothing

Examples

Example 1:: playMusic "RadioAmbient1";
Example 2:: playMusic ["RadioAmbient3", 3]; // start to play from 00:00:03
Example 3:: Play from 00:00:01 to 00:00:05:
0 spawn { playMusic ["RadioAmbient5", 1]; sleep 4; playMusic ""; };

Additional Information

See also:: getMusicPlayedTime playSound say createSoundSource addMusicEventHandler fadeMusic Arma 3 Jukebox Utility

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

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| ofp
+|game1= ofp
+|version1= 1.00
-|1.00
+|game2= ofpe
+|version2= 1.00
+|game3= arma1
+|version3= 1.00
+|game4= arma2
+|version4= 1.00
+|game5= arma2oa
+|version5= 1.50
+|game6= tkoh
+|version6= 1.00
+|game7= arma3
+|version7= 0.50
 |eff= local
@@ Line 9: / Line 26: @@
 |gr1= Sounds
-| Plays music defined in [[Description.ext#CfgMusic|Description.ext's CfgMusic]] or config.cpp. If the ''musicName'' could not be found a message is logged into the .rpt file: <tt>Music <''musicName''> not found</tt>.
+|descr= Plays music defined in [[Description.ext#CfgMusic|Description.ext's CfgMusic]] or config.cpp. If the ''musicName'' could not be found a message is logged into the .rpt file: {{hl|Music <''musicName''> not found}}.
-* [[Arma 3 CfgMusic]]
+* [[Arma 3: CfgMusic]]
 * [[Arma 2: CfgMusic]]
-* [[ArmA: CfgMusic]]
+* [[ArmA: Armed Assault: CfgMusic]]
+* [[Operation Flashpoint: CfgMusic]]
-{{Feature | Informative | To stop the music, use {{ic|[[playMusic]] ""}}.}}
+{{Feature|informative|To stop the music, use <sqf inline>playMusic "";</sqf>.}}
-{{Feature|arma3 | See [[Arma 3 CfgMusic]] for possible vanilla values. Since {{arma3}} v1.67 one can use the [[Arma_3_Utilities#Jukebox|Jukebox Utility]] to preview in-game music.}}
+|s1= [[playMusic]] musicName
-| [[playMusic]] musicName
 |p1= musicName: [[String]] - music classname
-|[[Nothing]]
+|r1= [[Nothing]]
 |s2= [[playMusic]] [musicName, start]
@@ Line 32: / Line 48: @@
 |r2= [[Nothing]]
-|x1= <code>[[playMusic]] "RadioAmbient1";</code>
+|x1= <sqf>playMusic "RadioAmbient1";</sqf>
-|x2= <code>[[playMusic]] ["RadioAmbient3", 3]; {{cc|start to play from 00:00:03}}</code>
+|x2= <sqf>playMusic ["RadioAmbient3", 3]; // start to play from 00:00:03</sqf>
 |x3= Play from 00:00:01 to 00:00:05:
-<code>[] [[spawn]] {
+<sqf>
-	[[playMusic]] ["RadioAmbient5", 1];
+spawn {
-	[[sleep]] 4;
+	playMusic ["RadioAmbient5", 1];
-	[[playMusic]] "";
+	sleep 4;
-};</code>
+	playMusic "";
+};
+</sqf>
-|seealso= [[getMusicPlayedTime]], [[playSound]], [[say]], [[createSoundSource]], [[addMusicEventHandler]], [[fadeMusic]]
+|seealso= [[getMusicPlayedTime]] [[playSound]] [[say]] [[createSoundSource]] [[addMusicEventHandler]] [[fadeMusic]] [[Arma_3_Utilities#Jukebox|{{arma3}} Jukebox Utility]]
 }}
-{{GameCategory|arma1|Scripting Commands}}
-{{GameCategory|arma2|Scripting Commands}}
-{{GameCategory|arma3|Scripting Commands}}