codecs.conf.sample: Add sample and option descriptions for codec_opus

codecs.conf.sample was missing codec opus's configuration options, descriptions,
and examples. This patch adds the configuration options and examples to
codecs.conf.sample that can be used with codec_opus.

ASTERISK-26538 #close

Change-Id: I1d89bb5e01d3e3b5bd78951b8dd0ff077a83dc8b

1 files changed, 54 insertions, 0 deletions

diff --git a/configs/samples/codecs.conf.sample b/configs/samples/codecs.conf.sample
index 9b5738577..63d0352a8 100644
--- a/configs/samples/codecs.conf.sample
+++ b/configs/samples/codecs.conf.sample
@@ -151,3 +151,57 @@ packetloss_percentage=10;
 ;[celt32]
 ;type=celt
 ;samprate=32000
+
+;============================ OPUS Section Options ============================
+;
+;[opus]
+;type= ; Must be of type "opus" (default: "")
+;packet_loss= ; Encoder's packet loss percentage. Can be any number between 0
+              ; and 100, inclusive. A higher value results in more loss
+              ; resistance. (default: 0)
+;complexity= ; Encoder's computational complexity. Can be any number between 0
+             ; and 10, inclusive. Note, 10 equals the highest complexity.
+             ; (default: 10)
+;max_bandwitdth= ; Encoder's maximum bandwidth allowed. Sets an upper bandwidth
+                 ; bound on the encoder. Can be any of the following: narrow,
+                 ; medium, wide, super_wide, full. (default: full)
+;signal= ; Encoder's signal type. Aids in mode selection on the encoder: Can
+         ; be any of the following: auto, voice, music. (default: auto)
+;application= ; Encoder's application type. Can be any of the following: voip,
+              ; audio, low_delay. (default: voip)
+;max_playback_rate= ; Override the maximum playback rate in the offer's SDP.
+                    ; Any value between 8000 and 48000 (inclusive) is valid,
+                    ; however typically it should match one of the usual opus
+                    ; bandwidths. A value of "sdp" is also allowed. When set
+                    ; to "sdp" then the value from the offer's SDP is used.
+                    ; (default: "sdp")
+;bitrate= ; Override the maximum average bitrate in the offer's SDP. Any value
+          ; between 500 and 512000 is valid. The following values are also
+          ; allowed: auto, max, sdp. When set to "sdp" then the value from
+          ; the offer's sdp is used. (default: "sdp")
+;cbr= ; Override the constant bit rate parameter in the offer's SDP. A value of
+      ; 0/false/no represents a variable bit rate whereas 1/true/yes represents
+      ; a constant bit rate. A value of "sdp" is also allowed. When set to "sdp"
+      ; then the value from the offer's sdp is used. (default: "sdp")
+;fec= ; Override the use inband fec parameter in the offer's SDP. A value of
+      ; 0/false/no represents disabled whereas 1/true/yes represents enabled.
+      ; A value of "sdp" is also allowed. When set to "sdp" then the value from
+      ; the offer's sdp is used. (default: "sdp")
+;dtx= ; Override the use dtx parameter in the offer's SDP. A value of 0/false/no
+      ; represents disabled whereas 1/true/yes represents enabled. A value of
+      ; "sdp" is also allowed. When set to "sdp" then the value from the offer's
+      ; sdp is used. (default: "sdp")
+
+;=============================== OPUS Examples ================================
+;
+;[opus]
+;type=opus
+;max_playback_rate=8000 ; Limit the maximum playback rate on the encoder
+;fec=no ; Force no inband fec on the encoder (i.e don't use what's on the SDP)
+
+;[myopus]
+;type=opus
+;max_bandwidth=wide ; Maximum encoded bandwidth set to wide band (0-8000 Hz
+;                   ; audio bandwidth at 16Khz sample rate)
+;cbr=yes ; Force a constant bit rate (i.e don't use what's on the SDP)
+