Versions Compared

Old Version 8

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version 9

changes.mady.by.user Ribbon Communications

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

REST API Method: PUT /rest/voicecodecprofile/{identifier}

Creates a Voice Codec Profile given a specific Table ID.

Note
titleNote

The Voice Codec Profile identifier can only be within the range 1-9999 (inclusive)

URL:

https://192.168.0.111/rest/voicecodecprofile/{identifier}

HTTP Method

PUT

Requires Authentication:

true

Noprint
Panel
bgColortransparent
titleBGColor#DDD
title[voicecodecprofile - REST API Methods|Resource - voicecodecprofile]

Page Tree
root@parent

Parameters

Parameter Name Required Service Affecting Data Type Default Value Possible Values Description
DescriptionNoNostringnone64 - Max LengthIdentifies this profile so it can be easily recognized when selecting a codec.
MediaTypeYesYesEnum3Possible values:
  • 0 - mcNone
  • 1 - mcUnknown
  • 2 - mcG711A
  • 3 - mcG711u
  • 4 - mcG723
  • 5 - mcG726
  • 6 - mcG729A
  • 7 - mcT38Fax
  • 8 - mcCN
  • 9 - mcEventSignal
  • 10 - mcRTPRedundancy
  • 11 - mcTransparent
  • 12 - mcFaxRelay
  • 13 - mcFaxRelayAlaw
  • 14 - mcFaxRelayUlaw
  • 15 - mcModemRelay
  • 16 - mcModemRelayAlaw
  • 17 - mcModemRelayUlaw
  • 18 - mcG722
  • 19 - mcG722_2
 Specifies the voice coding and encoding scheme used towards the IP side of a VoIP call. The chosen codec affects the audio quality and bandwidth consumption of VoIP calls to which you apply this Voice Codec Profile (in the Media List Profile).
Info

Only the following codecs are currently supported:

  • mcG711A - 2
    - G.711 A-Law
  • mcG711u - 3
    - G.711 Mu-Law
  • mcG723 - 4
    - G.723.1
  • mcG726 - 5
    - G.726
  • mcG729A - 6
    - G.729
  • mcG722 - 18
    - G.722
  • mcG722_2 - 19
    - G.722.2

VoiceRateInBitsPerSecondNoNoint0Possible values:
  • 0 - Minimum
  • 64000 - Maximum
 Voice sampling rate in bits/sec to be used by the codec. This setting applies to G.723.1 and G.726 codecs only. For all other codecs, the voice sampling rate is fixed and defined in the appropriate specification for that codec.
Info

This option is available when Codec is set to G.723.1, G.726, G.722, or G.722.2.

  • For G.723.1 - acceptable values are 5300 and 6300.
  • For G.726 - acceptable value is 32000
  • For G.722 - acceptable value is 64000
  • For G.722.2 - acceptable values are 6600, 8850, 12650, 14250, 15850, 18250, 19850, 23050, and 23850

PayloadTypeNoNoint0Possible values:
  • 0 - Minimum
  • 127 - Maximum
 Specifies the payload type for this profile. Acceptable values for different codecs are as follows:
  • G.711 Mu-law: 0
  • G.711 A-law: 8
  • G.723.1: 4
  • G.729: 18
  • G.722: 9
  • For G.726 : 2 and any number between 96-127. 2 is the payload at 32Kbps.
  • For G.722.2 : any number between 96-127.
Info

This option is available when Codec is G.726 or G.722.2.

Note

The Payload Type selected for G.726 or G.722.2 must not conflict with that selected for Digit Relay (in Media List Profile).

PTimeInMilliSecondsNoNoint0Possible values:
  • 0 - Minimum
  • 90 - Maximum
Real-Time Transport Protocol (RTP) packet payload size in milliseconds. Smaller payload sizes decrease audio transport latency at the expense of higher bandwidth consumption.
Info

Valid values for the different media types are:

  • G.711 A-law: 10, 20, 30, 40, 50, 60 ms
  • G.711 Mu-law: 10, 20, 30, 40, 50, 60 ms
  • G.723.1: 30, 60, 90 ms
  • G.729: 10, 20, 30, 40, 50, 60, 70, 80 ms
  • G.726: 10, 20, 30, 40, 50, 60 ms
  • G.722: 20 ms
  • G.722.2: 20, 40, 60, 80 ms

PayloadFormatYesYesEnum0Possible values:
  • 0 - AMR_WB_BWE
  • 1 - AMR_WB_OTA
Payload format for packetization of AMR and AMR-WB encoded speech signals into the Real-time Transport Protocol.
Info

Following payload formats are supported:

  • Bandwidth Efficient Mode
  • Octet Aligned Mode