[sr-dev] git:master:e8c294f3: rtpengine: doc add codec-accept with an example

Module: kamailio Branch: master Commit: e8c294f33f8b867b0f67d78c14b7327dc22dd726 URL: https://github.com/kamailio/kamailio/commit/e8c294f33f8b867b0f67d78c14b7327… Author: Julien Chavanton &lt;jchavanton(a)gmail.com&gt; Committer: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Date: 2023-02-27T20:07:00+01:00 rtpengine: doc add codec-accept with an example --- Modified: src/modules/rtpengine/doc/rtpengine_admin.xml --- Diff: https://github.com/kamailio/kamailio/commit/e8c294f33f8b867b0f67d78c14b7327… Patch: https://github.com/kamailio/kamailio/commit/e8c294f33f8b867b0f67d78c14b7327… --- diff --git a/src/modules/rtpengine/doc/rtpengine_admin.xml b/src/modules/rtpengine/doc/rtpengine_admin.xml index 85b1a0fbe8c..99f97305c2b 100644 --- a/src/modules/rtpengine/doc/rtpengine_admin.xml +++ b/src/modules/rtpengine/doc/rtpengine_admin.xml @@ -2630,6 +2630,15 @@ rtpengine_offer(); and used for transcoding on the offering side. Useful only in combination with codec-transcode. <emphasis>all</emphasis> keyword can be used to mask all offered codecs </para></listitem> + + <listitem><para> + <emphasis>codec-accept=...</emphasis> - Similar to `mask` and `consume` but doesn't remove the codec from the list of + offered codecs. This means that a codec listed under `accept` will still be offered + to the remote peer, but if the remote peer rejects it, it will still be accepted + towards the original offerer and then used for transcoding. It is a more selective + version of what the `always transcode` flag does. + </para></listitem> + <listitem><para> <emphasis>T.38=decode</emphasis> - If the offered &sdp; contains a media section advertising T.38 over UDPTL, translate it to a regular audio media section @@ -2696,6 +2705,30 @@ if (has_body("application/sdp")) { t_on_reply("1"); } +... +</programlisting> + </example> + <example> + <title><function>rtpengine_offer</function> usage to force transcoding from opus to PCMU</title> + <programlisting format="linespecific"> +route { +... + if (is_method("INVITE")) { + if (has_body("application/sdp")) { + if (rtpengine_offer("codec-mask=opus codec-accept-opus codec-strip=PCMU codec-transcode=PCMU")) + t_on_reply("1"); + } + } +... +} + +onreply_route[1] +{ +... + if (has_body("application/sdp")) + rtpengine_answer("codec-strip=PCMU codec-strip=PCMA"); +... +} ... </programlisting> </example>