Ducking rules

The "Ducking Rules" configuration value specifies the behavior of audio streams when they are affected by other streams. The configuration file lists the audio stream types in order of priority, from highest to lowest, and the behavior of each audio stream type when it is pre-empted by a higher-priority stream.

Every audio stream can be set to one the following:

• a value from 1 to 100 specifying the volume level to which the stream with be set when it is interrupted; this value is a percentage of the current volume.
• "mute" (-1). The stream will mute if interrupted by a higher-priority stream.
• "no effect" (INT_MIN). The stream will not be affected by any other stream.

Example

The code snippet below shows an example of ducking rules. Note that these rules are not relevent for some audio streams, such as voice recordings.

 
"Devices":{
    "Description":"Specify the default values of the attributes of the audio devices",
    "speaker":{
      "supported":"true",
      "path":"/dev/snd/pcmPreferredp",
      "input.path":"/dev/snd/pcmPreferredc",
      "connected":"true",
      "numchans":"1",
      "order":"FL",
      "audioconfig":"2.0",
      "inchans":"0",
      "hwinchans":"0",
      "volumecontrol":"percentage",
      "dependency":"",
      "keepalive":"false",
      "suspended":"false",
      "controlpps":"",
      "audioprocessing":"false",
      "vadsupport":"",
      "public":"true",
      "mutable":"true",
      "mixer":"Master",
      "input.mixer":"Input Gain"
    },
    ...