CounterPath Bria Professional 2.5 Configuration Guide - Manual (Page 8)

CounterPath Corporation
4
2.3 Audio Quality
These settings provide controls for audio quality.
2.4 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 Professional 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. When a codec is enabled, it appears in
the enabled panel in the Preferences > Audio Codecs or Preferences > Video Codecs tab.
License
Count
Each codec may have a limit to the number of simultaneous calls that can be made using that codec – in other
words a limit to simultaneous use of a codec.
The built-in limit for royalty-bearing codecs is 2. There is no limit for non-royalty-bearing codecs.
You can restrict the codecs available by assigning a value to the codecs:<codec name>:license_count setting. To
disable a codec entirely, assign a value of 0. If you assign a value that is higher than the built-in value, the value
you assign is ignored.
For a limited-use codec, once the usage limit has been reached, that codec will not be offered in negotiation
until the “in-use” count drops, for example, when one phone call ends.
Note that whether a codec is enabled and within its license count are only two of the factors in whether it will be
used for a call. The other factors are:
• Whether the codec is also enabled by the other party
• Whether it is in under the bandwidth limit of the local Bria Professional 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 Professional 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 Professional 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 Professional computer. True means the
list is made up of all codecs that are enabled in the local Bria Professional computer (not just those in the
invite) and that are in the bandwidth limit of the local Bria Professional 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.