{"name":"soundParams","operator":null,"title":"soundParams","type":"command","url":"https://community.bistudio.com/wiki/soundParams","revid":379075,"updated":"2026-09-26T11:21:04Z","groups":["Sounds"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"2.12"}],"since":{"game":"arma3","name":"Arma 3","version":"2.12"},"arma3_since":"2.12","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Returns various params for the given sound. The sound has to be playing otherwise command returns empty array []. In case of say3D, the sound is put in the queue so unless the sound is started instantly with 'playMode' 1 or 2, it will also return [].","syntaxes":[{"syntax":"soundParams id or sound","since":null,"effect":null,"exec":null,"params":[{"name":"id","type":"Number","optional":false,"default":null,"description":"id returned by playSoundUI and playSound3D commands, -1 to return all currently playing ids","types":["Number"],"since":null,"text":"id: Number - id returned by playSoundUI and playSound3D commands, -1 to return all currently playing ids"},{"name":"sound","type":"Object or NetObject","optional":false,"default":null,"description":"sound returned by say3D command or the unit, in which case current say3D unit's sound params are returned","types":["Object","NetObject"],"since":"arma3 2.24","text":"sound: Object or NetObject - sound returned by say3D command or the unit, in which case current say3D unit's sound params are returned"}],"returns":{"type":"- id != -1 : Array with [path, curPos, length, time, volume, source]","types":["Array"],"description":"path: String - the path to the played sound file - curPos: Number - current play position in 0...1 range - length: Number - total sound duration in seconds - time: Number - time passed since the start of playback - volume: Number - playback volume - Arma 3 v2.22 loop: Boolean - true if the sound is looping - Arma 3 v2.24 source: Object - Source object to which say3D sound is attached or objNull - Arma 3 v2.22 id == -1: Array with [sid1, sid2, sid3..., sidn], where sid is sound id returned by playSoundUI and playSound3D but not say3D","text":"- *id* != -1 : Array with [path, curPos, length, time, volume, source]\n  - path: String - the path to the played sound file\n  - curPos: Number - current play position in 0...1 range\n  - length: Number - total sound duration in seconds\n  - time: Number - time passed since the start of playback\n  - volume: Number - playback volume\n  - Arma 3 v2.22 loop: Boolean - true if the sound is looping\n  - Arma 3 v2.24 source: Object - Source object to which say3D sound is attached or objNull\n- Arma 3 v2.22 *id* == -1: Array with [sid1, sid2, sid3..., sidn], where sid is sound id returned by playSoundUI and playSound3D but not say3D"},"form":"unary","operator":null,"left":null,"right":{"text":"id or sound","types":[]}}],"examples":[{"text":"```sqf\nprivate _params = soundParams 10;\n```","code":["private _params = soundParams 10;"]},{"text":"Wait for sound to end:\n\n```sqf\nprivate _sound = playSound3D [\"A3\\Sounds_F\\sfx\\blip1.wss\", player];\nwaitUntil { soundParams _sound isEqualTo [] };\n```","code":["private _sound = playSound3D [\"A3\\Sounds_F\\sfx\\blip1.wss\", player];\nwaitUntil { soundParams _sound isEqualTo [] };"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["playSoundUI","playSound3D","stopSound"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Sounds","Introduced with Arma 3 version 2.12","Scripting Commands"]}