Difference between revisions of "playSound3D"
Jump to navigation
Jump to search
m (Add max value for volume) |
killzone_kid (talk | contribs) (max volume emphasized) |
||
| (5 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{Command|= | + | {{Command|Comments= |
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| − | | arma3 | | + | | arma3 |Game name= |
| − | |0.50| | + | |0.50|Game version= |
| − | |arg= global |= | + | |arg= global |Multiplayer Arguments= |
| − | |eff= global |= | + | |eff= global |Multiplayer Effects= |
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| − | | Plays positional sound with given filename on every computer on network. At least 2 parameters must be specified. | + | | Plays positional sound with given filename on every computer on network. At least 2 parameters must be specified.<br><br> |
| + | {{ Warning | Since A3 v1.91.145537 the maximum volume allowed is '''5'''. Exceeding this will result in sound not being played when executed remotely. }} |DESCRIPTION= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| Line 43: | Line 44: | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| − | | [[say3D]], [[playSound]], [[say2D]], [[say]], [[createSoundSource]] [[setRandomLip]] |SEEALSO= | + | | [[say3D]], [[playSound]], [[say2D]], [[say]], [[createSoundSource]], [[setRandomLip]], [[getMissionPath]] |SEEALSO= |
| |MPBEHAVIOUR= | | |MPBEHAVIOUR= | ||
Latest revision as of 22:56, 16 November 2019
0.50
Hover & click on the images for descriptions
Description
- Description:
- Plays positional sound with given filename on every computer on network. At least 2 parameters must be specified.
Since A3 v1.91.145537 the maximum volume allowed is 5. Exceeding this will result in sound not being played when executed remotely.
Syntax
- Syntax:
- playSound3D [filename, soundSource, isInside, soundPosition, volume, soundPitch, distance]
- Parameters:
- [filename, soundSource, isInside, soundPosition, volume, soundPitch, distance]: Array
- filename: String - see Arma_3:_SoundFiles for available filenames
- soundSource: Object - the object emitting the sound. If "sound position" is specified this param is ignored
- isInside: Boolean (optional) Default: false
- soundPosition: PositionASL (optional) - position for sound emitter, will override "sound source" position. Default: [0,0,0]
- volume: Number (optional) Default: 1 Maximum value: 5 (limited since A3 v1.91.145537)
- soundPitch: Number (optional) - 1: Normal, 0.5: Darth Vader, 2: Chipmunks, etc. Default: 1
- distance: Number (optional) - How far is sound audible (0 = no max distance) Default: 0.
- Return Value:
- Nothing
Examples
- Example 1:
-
playSound3D ["A3\Sounds_F\sfx\blip1.wav", player] - Example 2:
-
playSound3D ["A3\Sounds_F\sfx\blip1.wav", player, false, getPosASL player, 1, 1, 0] - Example 3:
- Sound file extension must be specified even if a config entry has none:
playSound3D ["A3\Sounds_F\sfx\alarm_independent", player]; //no sound playSound3D ["A3\Sounds_F\sfx\alarm_independent.wss", player]; //alarm
Additional Information
Notes
Only post proven facts here. Report bugs on the feedback tracker. Use the Talk page or the Forums for discussions.
Notes
- Posted on September 23, 2013
- Killzone_Kid
- This command works well with addon sounds, however getting it to play mission sound files is a bit tricky. Follow this guide
Bottom Section
- Posted on September 26, 2014 - 09:18 (UTC)
- Killzone Kid
- Currently, playSound3D is not JIP compatible, so joining players will not hear the sound if is started before and is still playing when player joins.
- Posted on October 16, 2013 - 08:21 (UTC)
- Jacmac
- You need to get the correct path for custom mission sounds. Use missionConfigFile with BIS_fnc_trimString (to trim off "description.ext"), then add your mission's sound directory and sound file:
_soundPath = [(str missionConfigFile), 0, -15] call BIS_fnc_trimString; _soundToPlay = _soundPath + "sounds\some_sound_file.ogg"; playSound3D [_soundToPlay, _sourceObject, false, getPos _sourceObject, 10, 1, 50]; //Volume db+10, volume drops off to 0 at 50 meters from _sourceObject
- Posted on November 8, 2014 - 21:48 (UTC)
- Killzone Kid
-
When object is supplied but not a position, the position is taken from object, otherwise the position is taken from supplied position. That doesn't mean that when position is taken from object it is going to follow object when it changes position. The sound is generated at object position and it stays there.
One other important note: If soundSource param is objNull then his command develops the same bug with first person view as createSoundSource and say3D. If soundSource param is player then the bug is inverted. It seems that passing vehicle player as soundSource param is the only way to make it behave correctly when vehicles involved.
