Merged revisions 329952 via svnmerge from
[asterisk/asterisk.git] / configs / confbridge.conf.sample
1 [general]
2 ; The general section of this config
3 ; is not currently used, but reserved
4 ; for future use.
5
6 ;
7 ; --- Default Information ---
8 ; The default_user and default_bridge sections are applied
9 ; automatically to all ConfBridge instances invoked without
10 ; a user, or bridge argument.  No menu is applied by default.
11 ;
12
13 ; --- ConfBridge User Profile Options ---
14 [default_user]
15 type=user
16 ;admin=yes     ; Sets if the user is an admin or not. Off by default.
17 ;marked=yes    ; Sets if this is a marked user or not. Off by default.
18 ;startmuted=yes; Sets if all users should start out muted. Off by default
19 ;music_on_hold_when_empty=yes  ; Sets whether MOH should be played when only
20                                ; one person is in the conference or when the
21                                ; the user is waiting on a marked user to enter
22                                ; the conference. Off by default.
23 ;music_on_hold_class=default   ; The MOH class to use for this user.
24 ;quiet=yes     ; When enabled enter/leave prompts and user intros are not played.
25                ; There are some prompts, such as the prompt to enter a PIN number,
26                ; that must be played regardless of what this option is set to.
27                ; Off by default
28 ;announce_user_count=yes  ; Sets if the number of users should be announced to the
29                           ; caller.  Off by default.
30 ;announce_user_count_all=yes ; Sets if the number of users should be announced to
31                              ; all the other users in the conference when someone joins.
32                              ; This option can be either set to 'yes' or a number.
33                              ; When set to a number, the announcement will only occur
34                              ; once the user count is above the specified number.
35 ;announce_only_user=yes   ; Sets if the only user announcement should be played
36                           ; when a channel enters a empty conference.  On by default.
37 ;wait_marked=yes   ; Sets if the user must wait for a marked user to enter before
38                    ; joining the conference. Off by default.
39 ;end_marked=yes ; This option will kick every user with this option set in their
40                 ; user profile after the last Marked user exists the conference.
41
42 ;dsp_drop_silence=yes  ; This option drops what Asterisk detects as silence from
43                        ; entering into the bridge.  Enabling this option will drastically
44                        ; improve performance and help remove the buildup of background
45                        ; noise from the conference. Highly recommended for large conferences
46                        ; due to its performance enhancements.
47
48 ;dsp_talking_threshold=128  ; The time in milliseconds of sound above what the dsp has
49                             ; established as base line silence for a user before a user
50                             ; is considered to be talking.  This value affects several
51                             ; operations and should not be changed unless the impact on
52                             ; call quality is fully understood.
53                             ;
54                             ; What this value affects internally:
55                             ;
56                             ; 1. Audio is only mixed out of a user's incoming audio stream
57                             ;    if talking is detected.  If this value is set too
58                             ;    loose the user will hear themselves briefly each
59                             ;    time they begin talking until the dsp has time to
60                             ;    establish that they are in fact talking.
61                             ; 2. When talk detection AMI events are enabled, this value 
62                             ;    determines when talking has begun which results in
63                             ;    an AMI event to fire.  If this value is set too tight
64                             ;    AMI events may be falsely triggered by variants in
65                             ;    room noise.
66                             ; 3. The drop_silence option depends on this value to determine
67                             ;    when the user's audio should be mixed into the bridge
68                             ;    after periods of silence.  If this value is too loose
69                             ;    the beginning of a user's speech will get cut off as they
70                             ;    transition from silence to talking.
71                             ;
72                             ; By default this value is 160 ms. Valid values are 1 through 2^31
73
74 ;dsp_silence_threshold=2000 ; The time in milliseconds of sound falling within the what
75                             ; the dsp has established as baseline silence before a user
76                             ; is considered be silent.  This value affects several
77                             ; operations and should not be changed unless the impact
78                             ; on call quality is fully understood.
79                             ;
80                             ; What this value affects internally:
81                             ;
82                             ; 1. When talk detection AMI events are enabled, this value
83                             ;    determines when the user has stopped talking after a
84                             ;    period of talking.  If this value is set too low
85                             ;    AMI events indicating the user has stopped talking
86                             ;    may get falsely sent out when the user briefly pauses
87                             ;    during mid sentence.
88                             ; 2. The drop_silence option depends on this value to
89                             ;    determine when the user's audio should begin to be
90                             ;    dropped from the conference bridge after the user
91                             ;    stops talking.  If this value is set too low the user's
92                             ;    audio stream may sound choppy to the other participants.
93                             ;    This is caused by the user transitioning constantly from
94                             ;    silence to talking during mid sentence.
95                             ;
96                             ; The best way to approach this option is to set it slightly above
97                             ; the maximum amount of ms of silence a user may generate during
98                             ; natural speech.
99                             ;
100                             ; By default this value is 2500ms. Valid values are 1 through 2^31
101
102 ;talk_detection_events=yes ; This option sets whether or not notifications of when a user
103                            ; begins and ends talking should be sent out as events over AMI.
104                            ; By default this option is off.
105
106 ;denoise=yes ; Sets whether or not a denoise filter should be applied
107              ; to the audio before mixing or not.  Off by default. Requires
108              ; codec_speex to be built and installed.  Do not confuse this option
109              ; with drop_silence.  Denoise is useful if there is a lot of background
110              ; noise for a user as it attempts to remove the noise while preserving
111              ; the speech.  This option does NOT remove silence from being mixed into
112              ; the conference and does come at the cost of a slight performance hit.
113
114 ;jitterbuffer=yes  ; Enabling this option places a jitterbuffer on the user's audio stream
115                    ; before audio mixing is performed.  This is highly recommended but will
116                    ; add a slight delay to the audio.  This option is using the JITTERBUFFER
117                    ; dialplan function's default adaptive jitterbuffer.  For a more fine tuned
118                    ; jitterbuffer, disable this option and use the JITTERBUFFER dialplan function
119                    ; on the user before entering the ConfBridge application.
120
121 ;pin=1234  ; Sets if this user must enter a PIN number before entering
122            ; the conference.  The PIN will be prompted for.
123 ;announce_join_leave=yes ; When enabled, this option will prompt the user for a
124                          ; name when entering the conference.  After the name is
125                          ; recorded, it will be played as the user enters and exists
126                          ; the conference. This option is off by default.
127 ;dtmf_passthrough=yes  ; Sets whether or not DTMF should pass through the conference.
128                        ; This option is off by default.
129
130 ; --- ConfBridge Bridge Profile Options ---
131 [default_bridge]
132 type=bridge
133 ;max_members=50                ; This option limits the number of participants for a single
134                                ; conference to a specific number.  By default conferences
135                                ; have no participant limit. After the limit is reached, the
136                                ; conference will be locked until someone leaves.  Note however
137                                ; that an Admin user will always be alowed to join the conference
138                                ; regardless if this limit is reached or not.
139
140 ;record_conference=yes         ; Records the conference call starting when the first user
141                                ; enters the room, and ending when the last user exits the room.
142                                ; The default recorded filename is
143                                ; 'confbridge-<name of conference bridge>-<start time>.wav
144                                ; and the default format is 8khz slinear.  This file will be
145                                ; located in the configured monitoring directory in asterisk.conf.
146
147 ;record_file=</path/to/file>   ; When record_conference is set to yes, the specific name of the
148                                ; record file can be set using this option.  Note that since multiple
149                                ; conferences may use the same bridge profile, this may cause issues
150                                ; depending on the configuration.  It is recommended to only use this
151                                ; option dynamically with the CONFBRIDGE() dialplan function. This
152                                ; allows the record name to be specified and a unique name to be chosen.
153                                ; By default, the record_file is stored in Asterisk's spool/monitor directory
154                                ; with a unique filename starting with the 'confbridge' prefix.
155
156 ;internal_sample_rate=auto     ; Sets the internal native sample rate the
157                                ; conference is mixed at.  This is set to automatically
158                                ; adjust the sample rate to the best quality by default.
159                                ; Other values can be anything from 8000-192000.  If a
160                                ; sample rate is set that Asterisk does not support, the
161                                ; closest sample rate Asterisk does support to the one requested
162                                ; will be used.
163
164 ;mixing_interval=40     ; Sets the internal mixing interval in milliseconds for the bridge.  This
165                         ; number reflects how tight or loose the mixing will be for the conference.
166                         ; In order to improve performance a larger mixing interval such as 40ms may
167                         ; be chosen.  Using a larger mixing interval comes at the cost of introducing
168                         ; larger amounts of delay into the bridge.  Valid values here are 10, 20, 40,
169                         ; or 80.  By default 20ms is used.
170
171 ;video_mode = follow_talker; Sets how confbridge handles video distribution to the conference participants.
172                            ; Note that participants wanting to view and be the source of a video feed
173                            ; _MUST_ be sharing the same video codec.  Also, using video in conjunction with
174                            ; with the jitterbuffer currently results in the audio being slightly out of sync
175                            ; with the video.  This is a result of the jitterbuffer only working on the audio
176                            ; stream.  It is recommended to disable the jitterbuffer when video is used.
177                            ;
178                            ; --- MODES ---
179                            ; none: No video sources are set by default in the conference. It is still
180                            ;       possible for a user to be set as a video source via AMI or DTMF action
181                            ;       at any time.
182                            ;
183                            ; follow_talker: The video feed will follow whoever is talking and providing video.
184                            ;
185                            ; last_marked: The last marked user to join the conference with video capabilities
186                            ;              will be the single source of video distributed to all participants.
187                            ;              If multiple marked users are capable of video, the last one to join
188                            ;              is always the source, when that user leaves it goes to the one who
189                            ;              joined before them.
190                            ;
191                            ; first_marked: The first marked user to join the conference with video capabilities
192                            ;               is the single source of video distribution among all participants. If
193                            ;               that user leaves, the marked user to join after them becomes the source.
194
195 ; All sounds in the conference are customizable using the bridge profile options below.
196 ; Simply state the option followed by the filename or full path of the filename after
197 ; the option.  Example: sound_had_joined=conf-hasjoin  This will play the conf-hasjoin
198 ; sound file found in the sounds directory when announcing someone's name is joining the
199 ; conference.
200
201 ;sound_join  ; The sound played to everyone when someone enters the conference.
202 ;sound_leave ; The sound played to everyone when someone leaves the conference.
203 ;sound_has_joined ; The sound played before announcing someone's name has
204                   ; joined the conference. This is used for user intros.
205                   ; Example "_____ has joined the conference"
206 ;sound_has_left ; The sound played when announcing someone's name has
207                 ; left the conference. This is used for user intros.
208                 ; Example "_____ has left the conference"
209 ;sound_kicked ; The sound played to a user who has been kicked from the conference.
210 ;sound_muted  ; The sound played when the mute option it toggled on.
211 ;sound_unmuted  ; The sound played when the mute option it toggled off.
212 ;sound_only_person ; The sound played when the user is the only person in the conference.
213 ;sound_only_one ; The sound played to a user when there is only one other
214                 ; person is in the conference.
215 ;sound_there_are  ; The sound played when announcing how many users there
216                   ; are in a conference.
217 ;sound_other_in_party; ; This file is used in conjunction with 'sound_there_are"
218                        ; when announcing how many users there are in the conference.
219                        ; The sounds are stringed together like this.
220                        ; "sound_there_are" <number of participants> "sound_other_in_party"
221 ;sound_place_into_conference ; The sound played when someone is placed into the conference
222                              ; after waiting for a marked user.
223 ;sound_wait_for_leader  ; The sound played when a user is placed into a conference that
224                         ; can not start until a marked user enters.
225 ;sound_leader_has_left  ; The sound played when the last marked user leaves the conference.
226 ;sound_get_pin ; The sound played when prompting for a conference pin number.
227 ;sound_invalid_pin ; The sound played when an invalid pin is entered too many times.
228 ;sound_locked ; The sound played to a user trying to join a locked conference.
229 ;sound_locked_now ; The sound played to an admin after toggling the conference to locked mode.
230 ;sound_unlocked_now; The sound played to an admin after toggling the conference to unlocked mode.
231 ;sound_error_menu ; The sound played when an invalid menu option is entered.
232
233 ; --- ConfBridge Menu Options ---
234 ; The ConfBridge application also has the ability to
235 ; apply custom DTMF menus to each channel using the
236 ; application.  Like the User and Bridge profiles
237 ; a menu is passed in to ConfBridge as an argument in
238 ; the dialplan.
239 ;
240 ; Below is a list of menu actions that can be assigned
241 ; to a DTMF sequence.
242 ;
243 ; A single DTMF sequence can have multiple actions associated with it. This is
244 ; accomplished by stringing the actions together and using a ',' as the delimiter.
245 ; Example:  Both listening and talking volume is reset when '5' is pressed.
246 ; 5=reset_talking_volume, reset_listening_volume
247 ;
248 ; playback(<name of audio file>&<name of audio file>)
249                                        ; Playback will play back an audio file to a channel
250                                        ; and then immediately return to the conference.
251                                        ; This file can not be interupted by DTMF.
252                                        ; Mutliple files can be chained together using the
253                                        ; '&' character.
254 ; playback_and_continue(<name of playback prompt>&<name of playback prompt>)
255                                        ; playback_and_continue will
256                                        ; play back a prompt while continuing to
257                                        ; collect the dtmf sequence.  This is useful
258                                        ; when using a menu prompt that describes all
259                                        ; the menu options.  Note however that any DTMF
260                                        ; during this action will terminate the prompts
261                                        ; playback.  Prompt files can be chained together
262                                        ; using the '&' character as a delimiter.
263 ; toggle_mute      ; Toggle turning on and off mute.  Mute will make the user silent
264                    ; to everyone else, but the user will still be able to listen in.
265                    ; continue to collect the dtmf sequence.
266 ; no_op ; This action does nothing (No Operation). Its only real purpose exists for
267         ; being able to reserve a sequence in the config as a menu exit sequence.
268 ; decrease_listening_volume ; Decreases the channel's listening volume.
269 ; increase_listening_volume ; Increases the channel's listening volume.
270 ; reset_listening_volume    ; Reset channel's listening volume to default level.
271
272 ; decrease_talking_volume ; Decreases the channel's talking volume.
273 ; increase_talking_volume ; Icreases the channel's talking volume.
274 ; reset_talking_volume    ; Reset channel's talking volume to default level.
275 ;
276 ; dialplan_exec(context,exten,priority)  ; The dialplan_exec action allows a user
277                                          ; to escape from the conference and execute
278                                          ; commands in the dialplan.  Once the dialplan
279                                          ; exits the user will be put back into the
280                                          ; conference.  The possibilities are endless!
281 ; leave_conference ; This action allows a user to exit the conference and continue
282                    ; execution in the dialplan.
283 ;
284 ; admin_kick_last  ; This action allows an Admin to kick the last participant from the
285                    ; conference. This action will only work for admins which allows
286                    ; a single menu to be used for both users and admins.
287 ;
288 ; admin_toggle_conference_lock ; This action allows an Admin to toggle locking and
289                                ; unlocking the conference.  Non admins can not use
290                                ; this action even if it is in their menu.
291
292 ; set_as_single_video_src   ; This action allows any user to set themselves as the
293                             ; single video source distributed to all participants.
294                             ; This will make the video feed stick to them regardless
295                             ; of what the video_mode is set to.
296
297 ; release_as_single_video_src ; This action allows a user to release themselves as
298                               ; the video source.  If video_mode is not set to "none"
299                               ; this action will result in the conference returning to
300                               ; whatever video mode the bridge profile is using.
301                               ;
302                               ; Note that this action will have no effect if the user
303                               ; is not currently the video source.  Also, the user is
304                               ; not guaranteed by using this action that they will not
305                               ; become the video source again.  The bridge will return
306                               ; to whatever operation the video_mode option is set to
307                               ; upon release of the video src.
308
309 [sample_user_menu]
310 type=menu
311 *=playback_and_continue(conf-usermenu)
312 *1=toggle_mute
313 1=toggle_mute
314 *4=decrease_listening_volume
315 4=decrease_listening_volume
316 *6=increase_listening_volume
317 6=increase_listening_volume
318 *7=decrease_talking_volume
319 7=decrease_talking_volume
320 *8=leave_conference
321 8=leave_conference
322 *9=increase_talking_volume
323 9=increase_talking_volume
324
325 [sample_admin_menu]
326 type=menu
327 *=playback_and_continue(conf-adminmenu)
328 *1=toggle_mute
329 1=toggle_mute
330 *2=admin_toggle_conference_lock ; only applied to admin users
331 2=admin_toggle_conference_lock  ; only applied to admin users
332 *3=admin_kick_last       ; only applied to admin users
333 3=admin_kick_last        ; only applied to admin users
334 *4=decrease_listening_volume
335 4=decrease_listening_volume
336 *6=increase_listening_volume
337 6=increase_listening_volume
338 *7=decrease_talking_volume
339 7=decrease_talking_volume
340 *8=no_op
341 8=no_op
342 *9=increase_talking_volume
343 9=increase_talking_volume