|
|
|
@ -1241,9 +1241,25 @@ Optionally included keys are:
|
|
|
|
|
Contains a list of strings. Each string is the name of a codec that should be
|
|
|
|
|
included in the list of codecs offered. This is primarily useful to block all
|
|
|
|
|
codecs (`strip -> all`) except the ones given in the `offer` whitelist.
|
|
|
|
|
Currently codecs that were not present in the original list of codecs
|
|
|
|
|
Codecs that were not present in the original list of codecs
|
|
|
|
|
offered by the client will be ignored.
|
|
|
|
|
|
|
|
|
|
* `transcode`
|
|
|
|
|
|
|
|
|
|
Similar to `offer` but allows codecs to be added to the list of offered codecs
|
|
|
|
|
even if they were not present in the original list of codecs. In this case,
|
|
|
|
|
the transcoding engine will be engaged. Only codecs that are supported for both
|
|
|
|
|
decoding and encoding can be added in this manner. This also has the side effect
|
|
|
|
|
of automatically stripping all unsupported codecs from the list of offered codecs,
|
|
|
|
|
as *rtpengine* must expect to receive or even send in any codec that is present
|
|
|
|
|
in the list.
|
|
|
|
|
|
|
|
|
|
Note that using this option does not necessarily always engage the transcoding
|
|
|
|
|
engine. If all codecs given in the `transcode` list were present in the original
|
|
|
|
|
list of offered codecs, then no transcoding will be done. Also note that if
|
|
|
|
|
transcoding takes place, in-kernel forwarding is disabled for this media stream
|
|
|
|
|
and all processing happens in userspace.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
An example of a complete `offer` request dictionary could be (SDP body abbreviated):
|
|
|
|
|
|
|
|
|
|