c651e69309a963868eea1b141ae860253eb1df7e
[asterisk/asterisk.git] / configs / motif.conf.sample
1 ; Sample configuration file for chan_motif
2
3 ; Transports
4 ;
5 ; There are three different transports and protocol derivatives supported by chan_motif. They are in order of preference:
6 ; Jingle using ICE-UDP, Google Jingle, and Google-V1.
7 ;
8 ; Jingle as defined in XEP-0166 supports the widest range of features. It is referred to as "ice-udp" in this file. This is
9 ; the specification that Jingle clients implement.
10 ;
11 ; Google Jingle follows the Jingle specification for signaling but uses a custom transport for media. It is supported
12 ; by the Google Talk Plug-in in Gmail and by some other Jingle clients. It is referred to as "google" in this file.
13 ;
14 ; Google-V1 is the original Google Talk signaling protocol which uses an initial preliminary version of Jingle.
15 ; It also uses the same custom transport as Google Jingle for media. It is supported by Google Voice, some other Jingle
16 ; clients, and the Windows Google Talk client. It is referred to as "google-v1" in this file.
17 ;
18 ; Incoming sessions will automatically switch to the correct transport once it has been determined.
19 ;
20 ; Outgoing sessions are capable of determining if the target is capable of Jingle or a Google transport if the target is
21 ; in the roster. Unfortunately it is not possible to differentiate between a Google Jingle or Google-V1 capable resource
22 ; until a session initiate attempt occurs. If a resource is determined to use a Google transport it will initially use
23 ; Google Jingle but will fall back to Google-V1 if required.
24 ;
25 ; If an outgoing session attempt fails due to failure to support the given transport chan_motif will fall back in preference
26 ; order listed at the beginning of this document until all transports have been exhausted.
27 ;
28
29 ; Dialing and Resource Selection Strategy
30 ;
31 ; Placing a call through an endpoint can be accomplished using the following dial string:
32 ;
33 ; Motif/<endpoint name>/<target>
34 ;
35 ; When placing an outgoing call through an endpoint the requested target is searched for in the roster list. If present
36 ; the first Jingle or Google Jingle capable resource is specifically targetted. Since the capabilities of the resource are
37 ; known the outgoing session initation will disregard the configured transport and use the determined one.
38 ;
39 ; If the target is not found in the roster the target will be used as-is and a session will be initiated using the
40 ; transport specified in this configuration file. If no transport has been specified the endpoint defaults to ice-udp.
41 ;
42
43 ; Video Support
44 ;
45 ; Support for video does not need to be explicitly enabled. Configuring any video codec on your endpoint will
46 ; automatically enable it.
47
48 ; DTMF
49 ;
50 ; The only supported method for DTMF is RFC2833. This is always enabled on audio streams and negotiated if possible.
51
52 ; CallerID
53 ;
54 ; The incoming caller id number is populated with the username of the caller and the name is populated with the full
55 ; identity of the caller. If you would like to perform authentication or filtering of incoming calls it is recommended
56 ; that you use these fields to do so.
57 ;
58 ; Outgoing caller id can *not* be set.
59 ;
60 ; IMPORTANT: Multiple endpoints using the same connection is *NOT* supported. Doing so may result in broken calls.
61
62 ; Default template for endpoints, to be included in their definition
63 [default](!)
64 disallow=all
65 allow=ulaw
66 allow=h264
67 context=incoming-motif ; Default context that incoming sessions will land in
68
69 ;maxicecandidates = 10 ; Maximum number of ICE candidates we will offer
70 ;maxpayloads = 30      ; Maximum number of payloads we will offer
71
72 ; Sample configuration entry for Jingle
73 [jingle-endpoint](default)
74 transport=ice-udp               ; Change the default protocol of outgoing sessions to Jingle ICE-UDP
75 allow=g722                      ; Add G.722 as an allowed format since the other side may support it
76 connection=local-jabber-account ; Connection to accept traffic on and send traffic out
77 accountcode=jingle              ; Account code for CDR purposes
78
79 ; Sample configuration entry for Google Talk
80 [gtalk-endpoint](default)
81 transport=google         ; Since this is a Google Talk endpoint we want to offer Google Jingle for outgoing sessions
82 connection=gtalk-account
83
84 ; Sample configuration entry for Google Voice
85 [gvoice](default)
86 transport=google-v1       ; Google Voice uses the original Google Talk protocol
87 connection=gvoice-account