---
name: "soundParams"
type: command
status: ok
groups: ["Sounds"]
arma3_since: "2.12"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/soundParams
revid: 379075
updated: 2026-09-26T11:21:04Z
---

# soundParams

*Command · Sounds · Arma 3 v2.12*

## Description

Returns various params for the given sound. The sound has to be playing otherwise command returns empty array []. In case of [say3D](../commands/say3D.md), the sound is put in the queue so unless the sound is started instantly with 'playMode' 1 or 2, it will also return [].

## Syntax

```sqf
soundParams id or sound
```

**Parameters:**

- `id`: [Number](../topics/Number.md) - id returned by [playSoundUI](../commands/playSoundUI.md) and [playSound3D](../commands/playSound3D.md) commands, -1 to return all currently playing ids
- `sound`: [Object](../topics/Object.md) or NetObject - sound returned by [say3D](../commands/say3D.md) command or the unit, in which case current [say3D](../commands/say3D.md) unit's sound params are returned *(since arma3 2.24)*

**Returns:** - *id* != -1 : [Array](../topics/Array.md) with [path, curPos, length, time, volume, source]
  - path: [String](../topics/String.md) - the path to the played sound file
  - curPos: [Number](../topics/Number.md) - current play position in 0...1 range
  - length: [Number](../topics/Number.md) - total sound duration in seconds
  - time: [Number](../topics/Number.md) - time passed since the start of playback
  - volume: [Number](../topics/Number.md) - playback volume
  - Arma 3 v2.22 loop: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if the sound is looping
  - Arma 3 v2.24 source: [Object](../topics/Object.md) - Source object to which [say3D](../commands/say3D.md) sound is attached or [objNull](../commands/objNull.md)
- Arma 3 v2.22 *id* == -1: [Array](../topics/Array.md) with [sid1, sid2, sid3..., sidn], where sid is sound id returned by [playSoundUI](../commands/playSoundUI.md) and [playSound3D](../commands/playSound3D.md) but not [say3D](../commands/say3D.md)

## Examples

### Example 1

```sqf
private _params = soundParams 10;
```

### Example 2

Wait for sound to end:

```sqf
private _sound = playSound3D ["A3\Sounds_F\sfx\blip1.wss", player];
waitUntil { soundParams _sound isEqualTo [] };
```

## See also

[playSoundUI](../commands/playSoundUI.md) · [playSound3D](../commands/playSound3D.md) · [stopSound](../commands/stopSound.md)

<sub>Source: [BI Community Wiki — soundParams](https://community.bistudio.com/wiki/soundParams) (revision 379075).</sub>