Raises notifications when Asterisk detects silence or talking on a channel.
The TALK_DETECT function enables events on the channel it is applied to. These events can be emitted over AMI, ARI, and potentially other Asterisk modules that listen for the internal notification.
The function has two parameters that can optionally be passed when
set on a channel: dsp_talking_threshold and dsp_silence_threshold.
dsp_talking_threshold is the time in milliseconds of sound above what the dsp has established as base line silence for a user before a user is considered to be talking. By default, the value of silencethreshold from dsp.conf is used. If this value is set too tight events may be falsely triggered by variants in room noise.
Valid values are 1 through 2^31.
dsp_silence_threshold is the time in milliseconds of sound falling within what the dsp has established as baseline silence before a user is considered be silent. If this value is set too low events indicating the user has stopped talking may get falsely sent out when the user briefly pauses during mid sentence.
The best way to approach this option is to set it slightly above the maximum amount of ms of silence a user may generate during natural speech.
By default this value is 2500ms. Valid values are 1 through 2^31.
same => n,Set(TALK_DETECT(set)=) ; Enable talk detection
same => n,Set(TALK_DETECT(set)=1200) ; Update existing talk detection's silence threshold to 1200 ms
same => n,Set(TALK_DETECT(remove)=) ; Remove talk detection
same => n,Set(TALK_DETECT(set)=,128) ; Enable and set talk threshold to 128
This function will set the following variables:
remove- W/O. Remove talk detection from the channel.
( dsp_silence_threshold,dsp_talking_threshold )- W/O. Enable TALK_DETECT and/or configure talk detection parameters. Can be called multiple times to change parameters on a channel with talk detection already enabled.
dsp_silence_threshold- The time in milliseconds of sound falling below the dsp_talking_threshold option when a user is considered to stop talking. The default value is 2500.
dsp_talking_threshold- The minimum average magnitude per sample in a frame for the DSP to consider talking/noise present. A value below this level is considered silence. If not specified, the value comes from the
dsp.confsilencethreshold option or 256 if
dsp.confdoesn't exist or the silencethreshold option is not set.
This documentation was imported from Asterisk Version GIT-16-1038413