...
For a list of supported audio codecs, see Audio Support see
Link_in_new_tab |
---|
Text | Audio Codecs |
---|
URL | Audio Codecs |
---|
|
page.
Command Syntax
The syntax is categorized into different groups according to applicable codecs.
...
Parameter | Length/Range | Description |
---|
codecEntry
| N/A | Specifies the name of an entity consisting of a codec type along with the set of parameters to use with it. Select a default codec name or enter a custom name. Defaults are: G711-DEFAULT G711SS-DEFAULT G723-DEFAULT G723A-DEFAULT G726-DEFAULT G729A-DEFAULT G729AB-DEFAULT
|
codec
| N/A | Select a supported codec. (see Link_in_new_tab |
---|
Text | Audio Codecs |
---|
URL | Audio Codecs |
---|
| )
|
activeCodecSet | N/A | The active code set is applicable to certain AMR narrow-band codecs. Multiple rates may be selected using comma (,). Valid values are: AMR-0-4.75kbps AMR- 1-5.15kbps
AMR- 2-5.90kbps
AMR- 3-6.70kbps
AMR- 4-7.40kbps
AMR- 5-7.950kbps
AMR- 6-10.20kbps
AMR- 7-12.20kbps
|
codingRate
| N/A | Coding rate examples: |
Codec | Coding Rates (kbps) |
---|
G.722, G.722ss | 48, 56, 64 |
G.722.1, G.722.1ss | 16, 24, 32 |
G.723.1, G.723.1a | 5.3, 6.3 |
G.726, G.276ss | 32 |
evrcb, evrcb0 | 4.8 5.8 6.2 6.6 7.0 7.5 8.5 9.3 |
ilbc, ilbcss | 13.3, 15.2The audio coding rate. See Audio Codecs for details.
dtmf
| N/A | Use this parameter to describe how to handle DTMF digits in the media stream. relay – Type of DTMF relay. Select any one of the relay:bothOobAnd2833 – Out-of-Band and RFC 2883 are equally received and both can be transmitted. This option would normally be used only in the case where the OOB DTMF signaling is absorbed and not regenerated. For example, the OOB DTMF might go to an application server that needs to detect the DTMF for control purposes but does not process RTP and the 2833 DTMF would go to the destination media address as part of the RTP stream.eitherOobOrRfc2833 – Out-of-Band and RFC 2833 are equally received and only one is transmitted. The one transmitted is the one preferred by the peer or RFC 2833 as the default.none – Leaves the DTMF tones in-band as encoded audio.outOfBand – Carries DTMF in the signaling protocol.rfc2833 – Encodes DTMF into RTP using format and payload type distinct from audio encoding.
removeDigits – Enables the removal of DTMF digits from the media stream. This applies only if DTMF relay is configured as outOfBand or rfc2833.
|
fax
| N/A | The treatment taken when the fax tone is detected. failureHandling –The behavior when a fax tone is detected but treatment fails for any reason:continue – (default) Continue to process the call.disconnect – Release the call.
toneTreatment –Treatment taken when the fax tone is detected. Configuration options are:disconnect – Disconnect the call when the fax tone is detected.fallbackToG711 – Fall back to G.711 when the fax tone is detected.fallbackToG711AllowPeerToNegotiateFaxRelay – Upon detecting a fax tone, SBC transitions call to G.711 if current codec is not already G.711. After transiting to G.711, SBC accepts any T.38 reINVITE from the peer.faxRelay – Switch to fax relay (T.38) when the fax tone is detected.faxRelayOrFallbackToG711 – Switch to fax relay (T.38) if supported or fall back to G.711 when fax tone is detected.ignoreDetectionAllowPeerToNegotiateFaxRelay – Accept a T.38 reINVITE (either from a calling party or a called party) and ignore own fax tone detection event..none – (default) Do nothing when the fax tone is detected.notifyPeer – For SIP signaling, notify the peer when the fax tone is detected and let the peer decide the next action.
Note |
---|
For G.711 calls, Notify Peer, Disconnect, Fax Relay, and Fax Relay or Fallback to G.711 require allocation of a compression resource. |
|
fecRedundancy
| 0, 1, 2 | Sets the level for Forward-Error-Correction (FEC) Redundancy [AMR only]. The default value of "0" means FEC redundancy is disabled.
|
law
| N/A | Specifies the G.711 law to use. Values are:: ALaw ULaw deriveFromOtherLeg (default)
|
maxAverageBitRate | 6000-510000 | Maximum Average Bit Rate For OPUS Codec in bits/second. Default = 20000 |
maxInterleaveDepth | 0-7 | Use this parameter to specify the maximum interleave depth value to apply to an endpoint (default = 0). Note |
---|
This parameter only applies to EVRC and EVRCB calls. |
Note |
---|
maxInterleaveDepth is only visible under following conditions:
codec is set to "evrc" or "evrcb "packetSize is set to "40" or "60"
|
|
modeChangeNeighbor | N/A | Enable to force mode change to neighboring modes in active codec set as per RFC4867 (applies to AMR and AMRWB). |
modem
| N/A | Specifies the treatment taken when the modem tone is detected, which can be: failureHandling – The behavior when a modem tone is detected but the treatment fails for any reason. The behavior can be:continue (default) – Continue to process the call.disconnect – Release the call.
toneTreatment – Treatment taken when the modem tone is detected, which can be:applyFaxTreatment – Treat the modem tone as a fax tone, and apply the fax treatment for the selected codec.
disconnect – Disconnect the call when the modem tone is detected.
fallbackToG711 – Fall back to G.711 when the modem tone is detected.
none (default) – Do nothing when the modem tone is detected.
notifyPeer – Notify the peer when the modem tone is detected and let the peer decide the next action.
Note |
---|
applyFaxTreatment is not supported for Gateway Links.
|
|
modeSet | N/A | The AMR mode set is applicable to certain AMR wide-band codecs. The possible values are: AMR-0-6.6
AMR- 1-8.85
AMR- 2-12.65
AMR- 3-14.25
AMR- 4-15.85
AMR- 5-18.25
AMR- 6-19.85
AMR- 7-23.05
AMR- 8-23.85
|
packetSize
| N/A | The packet size in milliseconds (ms). Options are based on the type of codec chosen. (See Packet Sizes per Codec table below for details) |
preferredRtpPayloadType
| 0-128 | Specifies the preferred Real Time Protocol (RTP) payload type to be included in the RTP header of the data packet. Enter a value in the range 0-128. Default is 128. |
sendSid
| N/A | Enable or disable for sending SIDs. |
silenceSuppression | N/A | Enable/disable Silence Suppression mode. |
useCbr | 0, 1 | Use this flag to specify either Constant Bit Rate (CBR) or Variable Bit Rate (VBR) for OPUS codec (default = 0). 0 – Variable Bit Rate1 – Constant Bit Rate
Note |
---|
Configuring an Opus profile using a very low maxAverageBitRate with useCbr set to "1 " may result in degraded voice quality. |
|
useDtx
| 0, 1 | Set flag to "1" to use Discontinuous Transmission (DTX) For OPUS codec (default = 0). 0 – Do not use DTX1 – Use DTX
|
useFec
| 0, 1 | Set flag to "1" to use Forward Error Correction (FEC) for OPUS codec (default = 0). - 0 – Do not use FEC
1 – Use FEC
|
...