CounterPath Bria 3.0 Configuration Guide – Retail Deployments - 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 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 whether it is 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 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.