MixMonitor

Record A Call Natively

Description

 MixMonitor(<file>.<ext>[|<options>[|<command>]])

Records The audio on the current channel to the specified file.

Valid Options:
 b - Only save audio to the file while the channel is bridged. *does not include conferences*
 a - Append to the file instead of overwriting it.
 v(<x>) - Adjust the heard volume by a factor of <x> -4/4.
 V(<x>) - Adjust the spoken volume by a factor of <x> -4/4.
 W(<x>) - Adjust the overall volume by a factor of <x> -4/4.

<command> will be executed when the recording is over. Any strings matching ^{X} will be unescaped to ${X} and all variables will be evaluated at that time. (NOTE by Netoguy: My experience shows that variables are actually evaluated when MixMonitor is Called and NOT when the recoring is completed and the command is run.)
The variable MixMonitor_FILENAME will be present as well. Where <command> is a system (Linux shell) command, see Asterisk cmd System for example values. Note do NOT include the dialplan command System(blah), just blah. If you don't specify a full path, the file will be stored in the "monitor" subdir of the path specified with astspooldir in asterisk.conf (so default will be /var/spool/asterisk/monitor).

Note that no environment variables are given to <command> — you must pass these on via command-line arguments.

The audio file is closed and processing of <command> is started *after* the 'h' extension priorities have been run.

Version

New in Asterisk 1.2

Details

This application is similar to the Monitor application only it's designed to record 1 audio and mix them natively as the call is in progress to avoid the need to spawn external processes which lead to harmful cpu usage spikes.

Benefits:

• One call can record to mutiple files at the same time.
• Allows for recording a call to a single g729 file
• An append mode allows an agent to record all their calls in 1 file
• A bridge flag allows recording to only take place when the channel is bridged.
• The volume for either side of the channel may be adjusted seperatly.
• a cli interface makes it possible to start and stop the monitoring at will from a manager session or the cli prompt.

See also

• Asterisk cmd StopMixMonitor
• Asterisk cmd Monitor
• Asterisk cmd Record
• Asterisk cmd ChanSpy
• submitted in bug/patch 4735
• StopMixMonitor submitted in bug/patch 6122
• RTP MixSound: This tool takes the contents of a .wav or tcpdump format file and mixes the sound into an active conversation.

---

Asterisk | Applications | Functions | Variables | Expressions | Asterisk FAQ