CounterPath Bria 3.1 Configuration Guide - OEM Deployments - Manual (Page 9)

Bria 3 Configuration Guide – OEM Deployments
Confidential – Do not Distribute 5
2.5 Codec Usage
Your brand includes a specific set of built-in codecs. A codec may be royalty-bearing or non-royalty-bearing:
see the Bria Settings reference documentation for details. You can restrict codec usage by enabling or disabling
a codec and by setting the license count (even on non-royalty-bearing codecs).
Enabling Codecs
To enable a codec, set its codecs:<codec name>:enabled setting to true. If you have branded out the Preferences
> Audio Codecs and Preferences > Video Codecs tabs, then users will only be able to use the codecs you have
enabled.
Note that whether a codec is enabled is only one of the factors in whether it will be used for a call. The other
factors are:
• The license count for codecs. If you included royalty-bearing codecs in your brand, you would have
specified the license count, which establishes the number of simultaneous calls or number of legs (in the
case of a conference call) that can use the codec. Once the limit is reached, that codec will not be used for
new calls.
• Whether the codec is also enabled by the other party
• Whether it is in under the bandwidth limit of the local Bria computer.
• Its ranking in the SDP list (see below).
• How the codec is chosen (see below).
Presenting Local Media Capabilities in SDP
For the incoming audio or video (the audio or video the other party sends), Bria advertises a list of codecs in the
INVITE or 200 OK SDP.
• For the invite (the offer), this list is made up of the codecs that are enabled and that are under the bandwidth
limit of the local Bria computer.
• For the 200 OK (the counter-offer), this list is controlled by the
media:sdp:specify_all_codecs_in_offer_answer setting. False (the default) means the list is made up of the
codecs in the invite that are in the bandwidth limit of the local Bria computer. True means the list is made
up of all codecs that are enabled in the local Bria computer (not just those in the invite) and that are in the
bandwidth limit of the local Bria computer.
The codecs are prioritized within that list, with preferred codecs appearing first, based on the number each
codec is assigned in codecs:<codec name>:priority.
Handling the Media Capabilities of the Other Party
For outgoing audio or video (the audio or video you send the other party), there are two ways to configure Bria:
• Let Bria determine the codecs to use for each call. This is the default.
From the list of codecs that advertised by the other party in their SDP, that are enabled on the local Bria
computer and that are under the bandwidth limit of the local Bria, Bria chooses the codec with the best
sound, based on the network conditions.
To set up for this scenario, set system:network:honor_first_codec to false.
• Use the other party’s preferred codec.