codec-policy
The codec-policy configuration element allows you to configure codec policies, sets of rules that specify the manipulations to be performed on SDP offers.
Parameters
- name
- Enter the unique name for the codec policy. This is the value you will use to refer to this codec policy when you apply it to realms or session agents. This is a required parameter.
- allow-codecs
- Enter the list of media format types (codecs) to allow for this codec policy. In your entries, you can use the asterisk (*) as a wildcard, the force attribute, or the no attribute so that the allow list you enter directly reflect your configuration needs. The text:no value strips "m=text" occurrence in the outbound INVITE and enables T.140 to Baudot transcoding. The codecs that you enter here must have corresponding media profile configurations. This field accepts conditional codec policy syntax.
- add-codecs-on-egress
- Enter the codecs to be appended to an offer. Excluding keywords
add and delete when a list is already configured replaces the entire list. This
field accepts conditional codec policy syntax.
- [add | delete]
<name> [name>...]
Note:
Only codecs that can be transcoded may be specified. See your version's Release Notes for the list of applicable codecs.
- [add | delete]
<name> [name>...]
- order-codecs
- Enter the order in which you want codecs to appear in the outgoing SDP offer. You can use the asterisk (*) as a wildcard in different positions of the order to directly reflect your configuration needs. The codecs that you enter here must have corresponding media profile configurations. This field accepts conditional codec policy syntax.
- force-ptime
- Enable or disable a forced ptime being used.
- Default: disabled
- enabled | disabled
- packetization-time
- Enter a preferred ptime when the
force-ptime
parameter is enabled.
- Default: 20
- Min: 5 / Max: 240
- dtmf-in-audio
-
Select how the Oracle Communications Session Border Controller should support the conversion of signaling messages or RFC 2833 to DTMF Audio tones in the realm where this transcoding policy is active.
- Default: disabled
- Values:
- disabled—Does not support DTMF audio tones as transcoded in this realm.
- preferred—Supports DTMF audio tones as transcoded in this realm.
- dual—Supports both transcoded DTMF audio tones and signaling-based DTMF indications if possible.
- tone-detection
- Enables FAX tone detection.
- fax-cng—Causes the system to start its FAX transcoding based on the receipt of CNG messages.
- fax-v21—Causes the system to start its FAX transcoding based on the receipt of V21 messages.
- tone-detect-renegotiate-timer
- Specifies the time after which the system sends a re-Invite if it
does not receive a re-Invite from the endpoint. The system resets this timer
whenever it receives a re-Invite from the endpoint.
- Range—50 to 3200 seconds, with a default of 500
- reverse-fax-tone-detection-reinvite
- Allows you to force the
Oracle Communications Session Border Controller to send a ReInvite that includes T.38 in the SDP out
a realm that does not have tone detection enabled.
- disabled—Does not force the system to send ReInvites out a different realm. (Default)
- enabled—Allows the system to send ReInvites out a different realm during applicable scenarios.
- fax-single-m-line
- Set this parameter to the preferred FAX media type for Re-INVITEs
to endstations that do not support multiple m-lines. The OCSBC issues
Re-INVITEs using the configured media type only. Should the negotiation fail,
the OCSBC issues another Re-INVITE that offers the other media type.
- disabled—The single m-line function is disabled. (Default)
- image-first—Sends Re-INVITE with m=image as the only m-line in the SDP.
- audio-first—Sends Re-INVITE with m=audio as the only m-line in the SDP.
- evrc-tty-baudot-transcode
- Enables transcoding of EVRC TTY TDD to BAUDOT in EVRC-G.711
- Default: disabled
- Values: enabled | disabled
- secure-dtmf-cancellation
- Removes all Dual-Tone Multi-Frequency (DTMF) information that Oracle
Communications Session Border Controller (OCSBC) processes within the
codec-policy from ingress. It also removes the residual signal energy (i.e.
the leftover signaling from the media stream) at the beginning and ending of
each DTMF digit so that an important piece of data is not detectable within
the egress stream. But this option does not remove DTMF bleed unless
transcoding is enabled for the call.
- Default: disabled
- Values: enabled | disabled
Path
codec-policy is an element of the media-manager path. The full path from the topmost ACLI prompt is: .