playSoundUI: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Some wiki formatting)
Line 22: Line 22:
|p5since= arma3 2.14
|p5since= arma3 2.14


|r1= [[Nothing]] or [[Number]] - id of the sound (0...65535), since v2.14  
|r1= [[Number]] - id of the sound (0...65535) since {{GVI|arma3|2.14}} (was [[Nothing]] before that)


|x1= <sqf>playSoundUI ["Alarm", 0.5, 0.5];</sqf>
|x1= <sqf>playSoundUI ["Alarm", 0.5, 0.5];</sqf>
Line 29: Line 29:


|x3= Sound file extension must be specified even if a config entry has none:
|x3= Sound file extension must be specified even if a config entry has none:
<sqf>playSoundUI ["A3\Sounds_F\sfx\alarm_independent", 5, 1]; // no sound
<sqf>
playSoundUI ["A3\Sounds_F\sfx\alarm_independent.wss", 5, 1]; // alarm</sqf>
playSoundUI ["A3\Sounds_F\sfx\alarm_independent", 5, 1]; // no sound
playSoundUI ["A3\Sounds_F\sfx\alarm_independent.wss", 5, 1]; // alarm
</sqf>


|seealso= [[stopSound]] [[soundParams]] [[say3D]] [[playSound]] [[say2D]] [[say]] [[createSoundSource]] [[setRandomLip]] [[getMissionPath]] [[playSound3D]]
|seealso= [[stopSound]] [[soundParams]] [[say3D]] [[playSound]] [[say2D]] [[say]] [[createSoundSource]] [[setRandomLip]] [[getMissionPath]] [[playSound3D]]
}}
}}

Revision as of 14:27, 1 July 2023

Hover & click on the images for description

Description

Description:
Plays given CfgSounds sound or a sound file given by file path through a dedicated UI sound channel unaffected by the global mixer volumes. If the file path is given, the leading slash will be ignored.
Groups:
Sounds

Syntax

Syntax:
playSoundUI [sound, volume, soundPitch, isEffect, offset]
Parameters:
sound: String - CfgSounds class or file as used in playSound3D (See Arma 3: Sound Files for available file names)
volume: Number - (Optional, default 1) Sound volume. A value greater than 5 gets capped
soundPitch: Number - (Optional, default 1)
  • 1.0 → normal
  • 0.5 → Darth Vader
  • 2.0 → Chipmunks
isEffect: Boolean - (Optional, default false) If true, diverts sound through effects channel (see fadeSound, soundVolume)
since Arma 3 logo black.png2.14
offset: Number - (Optional, default 0) Offset in seconds. Same as with playSound3D
Return Value:
Number - id of the sound (0...65535) since Arma 3 logo black.png2.14 (was Nothing before that)

Examples

Example 1:
playSoundUI ["Alarm", 0.5, 0.5];
Example 2:
playSoundUI ["A3\Sounds_F\sfx\blip1.wss"];
Example 3:
Sound file extension must be specified even if a config entry has none:
playSoundUI ["A3\Sounds_F\sfx\alarm_independent", 5, 1]; // no sound playSoundUI ["A3\Sounds_F\sfx\alarm_independent.wss", 5, 1]; // alarm

Additional Information

See also:
stopSound soundParams say3D playSound say2D say createSoundSource setRandomLip getMissionPath playSound3D

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