CommuniGate Pro
Version 5.2
Signals
 
 
Media

Media Server

The CommuniGate Pro Media Server component can terminate media for calls - it can play and record audio/video (media) information.

To play media data, the Media Server encodes it using a selected codec and sends it to the remote party via the RTP protocol.

To record media data, the Media Server decodes received RTP data, rearranges it to restore the original data frame sequence and converts the resulting data into a standard format.

To participate in a call, the Media Server creates a Media Channel. Each Media Channel uses two UDP ports and sockets for audio data (the AVP/RTP protocol), and, optionally, two UDP ports and sockets for video data.

A Media Channel is created and controlled with PBX Tasks.

A Task can connect its Media Channel to several remote parties, creating a conference.

Media Server Settings

To configure the Media Server component, open the Real-Time pages in the WebAdmin Settings realm, and follow the Media link.

Processing
Log Level: UDP TOS Tag:
Pre-playing: msec Lingered Playing: msec
Packet Size:msec Mixer Delay: msec
   Inband DTMF Threshold:
Log
Use this setting to specify the type of information the Media Server component should put in the Server Log. Usually you should use the Failure (unrecoverable problems only), Major, or Problems levels. When you experience problems with the Media Server component, you may want to set the Log Level setting to Low-Level or All Info: in this case the media processing internals will be recorded in the System Log. When the problem is solved, set the Log Level setting to its regular value, otherwise your System Log files will grow in size very quickly.
The Media Server component records in the System Log are marked with the MEDIA tag.
UDP TOS Tag
Use this setting to specify the TOS tag for all outgoing UDP packets sent with Media Channels. This tag can be used to set the Media traffic priority on your LAN.
Pre-playing
When a Media Channel plays a pre-recorded or pre-composed media data, it can initially send some data portions (packets) "in advance". If later network delays cause some packets to arrive to the remote party with a delay, the "pre-played" media data allow that other party to play data smoothly.
Use this setting to specify the amount of media data to be "pre-played".
Lingered Playing
PBX Applications often play several media files in a sequence, composing a phrase with several part files. To ensure smooth media parts "merging", a Media Channel reports playing completion when it still has some media data to play. This allows the application to prepare the next media data portion and submit it to the Media Channel for playing.
The Media Channel starts playing this next portion as soon as it actually finishes playing the previous one.
Use this setting to specify when Media Channels should report playing completion.
Packet Size
Use this setting to specify the size (time length) of each RTP packet the Media Server generates.
Mixer Delay
Use this setting to specify the initial amount of delay the Media Channel uses in the "mixer" mode. Increasing this value increases the mixer quality for lines with large or variable latency, but it also increases the "playback delay".
Inband DTMF Threshold
When the session SDP does not contain the telephone-event codec, the Media Channel processes incoming audio trying to detect "in-band" DTMF. Decreasing this setting value allows the Media Channel to detect lesser quality in-band DTMF, but it may also result in "false-positives", when some incoming sounds are incorrectly interpreted as DTMF signals.

The Media Server supports a set of audio codecs. The following panel allows you to control how these codecs are used:

Codecs
NamePriority
G729
PCMU
PCMA

There are two Priority settings for each codec - the primary and the secondary one.

When a Media Server composes an initial offer, the codecs are listed sorted by their primary and secondary priority values.
Codecs with the primary Priority set to Inactive or to 1 are not listed in the initial offer.

When a Media Server composes an answer or a non-initial offer, i.e. when the audio codecs supported by the peer are known, only the codecs supported by the peer are listed.
Codecs with the primary Priority set to Inactive are not listed in answeres and non-initial offers.
The Media Server codecs are listed sorted by their primary Priority values. If several Media Server codecs have the same primary Priority values, they are listed in the same order as they were listed in the peer's offer.

Note: the set of supported codecs depends on the platform CommuniGate Pro is running on.

Compressing codecs (such as G.729) require a lot of CPU resources. You may want to offload coding-encoding operations to separate Transcoder servers:

External Media Servers
Usage:
 

If the Usage setting is set to Transcoder, the Media Server tries to create a transcoder channel on one of the listed Transcoder servers. The peer is instructed to exchange media with the created transcoder channel, while the transcoder channel exchanges media with the CommuniGate Pro Media Server using the PCM (G.711) codec.

Transcoder servers are used in a round-robin manner. If a Transcoder refuses to create a transcoder channel, and there are more than 2 servers specified, the next server is contacted.

The CommuniGate Pro Server software or special CommuniGate Pro Transcoder software can be used to implement Transcoder servers.

Features

The Media Server supports clients connecting from remote NATed networks, using the same algorithms as those employed with the Media Proxy component. When a call media is terminated with the CommuniGate Pro Media Server, there is no need to build a Media Proxy to handle media transfer over a remote NAT.

The Media Server supports DTMF "codecs": if the peer announces support for such a codec, the Media Server detects audio packets sent using that codec and interprets the packet content as DTMF symbols. The Media Server can also send DTMF symbols using special DTMF "codecs".
If the peer does not announce support for a DTMF "codec", the Media Server detects DTMF symbols sent "in-band", analyzing the audio data received.


CommuniGate® Pro Guide. Copyright © 1998-2009, Stalker Software, Inc.