Dialogic DIALOGIC MULTIMEDIA SOFTWARE FOR ADVANCEDTCA RELEASE 1.0 Supported RTP Payload Format

Page 33

This feature is only supported when using the Session Initiation Protocol (SIP). None of the available Session Description Protocol (SDP) options are currently supported through Global Call (that is, direct first-party call control). The options are only available using third-party call control (3PCC), where the application is responsible for interpreting received SDP text strings and for constructing all outbound SDP text strings.

Dialogic® IP Media Library API Support

The bit rate can be controlled using a new media type in the IPM_MEDIA structure. The Dialogic® IP Media Library API allows the application to provide a preferred bit rate and a rule to determine how changes in the received CMR value control the transmitted bit rate.

Preferred bit rate

The preferred bit rate is specified by setting the eMediaType in the IPM_MEDIA structure to MEDIATYPE_AUDIO_REMOTE_CODER_INFO and setting the CoderInfo.eCoderType to the desired transmit bit rate.

CMR value

The transmitted CMR value is specified by setting the eMediaType in the IPM_MEDIA structure to MEDIATYPE_AUDIO_LOCAL_CODER_INFO and setting the CoderInfo.eCoderType to the desired CMR value.

The CMR rules are specified by a new media type called

MEDIATYPE_AUDIO_REMOTE_CODER_OPTIONS_INFO. A new field AudioCoderOptionsInfo (of type IPM_AUDIO_CODER_OPTIONS_INFO) has been added to the IPM_MEDIA union. The CMR control is implemented by allowing the host application to specify one of two rules.

The first rule, “CMR Tracking,” indicates that the transmit bit rate should follow the CMR value in the received packet.

The second rule, “CMR Limit,” indicates that the transmit bit rate should follow the CMR value in the received packet with a maximum value specified by the preferred bit rate.

With both CMR rules, it is necessary to specify a preferred rate to avoid the specific case of determining what rate to transmit at before the first CMR value is received. The software will transmit at the preferred rate before the first packet is received or when a CMR value of 15 (don't care) is received from the opposite side.

The CMR rules are set in the AudioCoderOptionsInfo.unCoderOptions field by ORing in either CODER_OPT_AMR_CMR_TRACK or CODER_OPT_AMR_CMR_LIMIT.

Specifying a CMR rule is mandatory and the rules are mutually exclusive.

Note: The CMR rules are not used by the MEDIATYPE_AUDIO_LOCAL_CODER_OPTIONS_INFO eMediaTypes.

Supported RTP Payload Format

AMR supports two different formats for the RTP payload:

“Bandwidth efficient,” to minimize the amount of network bandwidth.

Dialogic® Multimedia Software for ATCA Release 1.0 Release Update, Rev 06 — January 23, 2008

33

Dialogic Corporation

 

Image 33
Contents Dialogic Multimedia Software for AdvancedTCA Release Release UpdateDialogic Corporation How to Use This Publication PurposeIntended Audience See the following for additional information Related InformationDocument Rev 06 published January 23 Document Rev 05 published June 22Document Rev 04 published June 8 Document Rev 02 published March 30 Document Rev 03 published May 1Initial version of document Document Rev 01 published JanuaryRelease Developments Updates to Ipmaudiocoderinfo Summary of FeaturesUpdates to Ipmaudiocoderoptionsinfo 2Release.Issues2 CLI Issues Sorted by Type, Dialogic Multimedia PlatformAs the clock source instead of a previously recovered Msml Dlservices cli startPARMCHRFC2833EVTRXPLT IpmlCLI, Snmp EvrcRtfConfigLinux.xml for mediasvr Existent list when the cable is unplugged from a Pstn Issue Type Defect No Product or Description 3Documentation.Updates3 Dialogic Conferencing CNF API Programming Guide Dialogic Conferencing CNF API Library ReferenceDialogic Device Management API Library Reference Dialogic Fax Software ReferenceDialogic IP Media Library API Library Reference Dialogic Global Call IP Technology GuideParmchlatencyalgaudio Updates to the ipmSetParm and ipmGetParm functionsParmchlatencyframemaxaudio ParmchlatencyframeinitaudioUpdate to , Events Codertypeevrc CodertypeamrnbnonePage „ Description IpmGetCapabilities„ Cautions „ Example Ipmaudiocoderoptionsinfo „ Example Dialogic IP Media Library API Programming Guide Using AMR Coders for Narrow Band Audio DescriptionSupported RTP Payload Format Dialogic IP Media Library API SupportExample Local Side Remote SideIpmaudiocoderoptionsinfoversion Local Side Remote Side Coderoptamrcmrlimit Coderoptamrefficient Using Enhanced Variable Rate CodecsOutbound Call Resource Reservation of Audio CodersImplicit Release by a Subsequent Successful Reserve Call Inbound CallHandling a Resource Reservation Failure Application issues call to release resource RESOURCEIPMG726 Dialogic Multimedia API Programming Guide Dialogic Multimedia API Library ReferenceDialogic Standard Runtime Library API Programming Guide Dialogic Standard Runtime Library API Library ReferenceDialogic Voice API Library Reference Dialogic Voice API Programming Guide