Asterisk-13-Configuration_chan_motif_29394341.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Asterisk Project : Asterisk 13 Configuration_chan_motif</title>
  5. <link rel="stylesheet" href="styles/site.css" type="text/css" />
  6. <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
  7. </head>
  8. <body class="theme-default aui-theme-default">
  9. <div id="page">
  10. <div id="main" class="aui-page-panel">
  11. <div id="main-header">
  12. <div id="breadcrumb-section">
  13. <ol id="breadcrumbs">
  14. <li class="first">
  15. <span><a href="index.html">Asterisk Project</a></span>
  16. </li>
  17. <li>
  18. <span><a href="Asterisk-13-Command-Reference_29394274.html">Asterisk 13 Command Reference</a></span>
  19. </li>
  20. <li>
  21. <span><a href="Asterisk-13-Module-Configuration_29394289.html">Asterisk 13 Module Configuration</a></span>
  22. </li>
  23. </ol>
  24. </div>
  25. <h1 id="title-heading" class="pagetitle">
  26. <span id="title-text">
  27. Asterisk Project : Asterisk 13 Configuration_chan_motif
  28. </span>
  29. </h1>
  30. </div>
  31. <div id="content" class="view">
  32. <div class="page-metadata">
  33. Created by <span class='author'> wikibot</span> on Aug 08, 2014
  34. </div>
  35. <div id="main-content" class="wiki-content group">
  36. <h1 id="Asterisk13Configuration_chan_motif-JingleChannelDriver">Jingle Channel Driver</h1>
  37. <p>This configuration documentation is for functionality provided by <code>chan_motif</code>.</p>
  38. <h2 id="Asterisk13Configuration_chan_motif-Overview">Overview</h2>
  39. <p>Transports</p>
  40. <p>There are three different transports and protocol derivatives supported by <code>chan_motif</code>. They are in order of preference: Jingle using ICE-UDP, Google Jingle, and Google-V1.</p>
  41. <p>Jingle as defined in XEP-0166 supports the widest range of features. It is referred to as <code>ice-udp</code>. This is the specification that Jingle clients implement.</p>
  42. <p>Google Jingle follows the Jingle specification for signaling but uses a custom transport for media. It is supported by the Google Talk Plug-in in Gmail and by some other Jingle clients. It is referred to as <code>google</code> in this file.</p>
  43. <p>Google-V1 is the original Google Talk signaling protocol which uses an initial preliminary version of Jingle. It also uses the same custom transport as Google Jingle for media. It is supported by Google Voice, some other Jingle clients, and the Windows Google Talk client. It is referred to as <code>google-v1</code> in this file.</p>
  44. <p>Incoming sessions will automatically switch to the correct transport once it has been determined.</p>
  45. <p>Outgoing sessions are capable of determining if the target is capable of Jingle or a Google transport if the target is in the roster. Unfortunately it is not possible to differentiate between a Google Jingle or Google-V1 capable resource until a session initiate attempt occurs. If a resource is determined to use a Google transport it will initially use Google Jingle but will fall back to Google-V1 if required.</p>
  46. <p>If an outgoing session attempt fails due to failure to support the given transport <code>chan_motif</code> will fall back in preference order listed previously until all transports have been exhausted.</p>
  47. <p>Dialing and Resource Selection Strategy</p>
  48. <p>Placing a call through an endpoint can be accomplished using the following dial string:</p>
  49. <p>Motif/<a class="createlink" href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=endpoint+name&amp;linkCreation=true&amp;fromPageId=29394341">endpoint name</a>/<a class="createlink" href="/wiki/pages/createpage.action?spaceKey=AST&amp;title=target&amp;linkCreation=true&amp;fromPageId=29394341">target</a></p>
  50. <p>When placing an outgoing call through an endpoint the requested target is searched for in the roster list. If present the first Jingle or Google Jingle capable resource is specifically targeted. Since the capabilities of the resource are known the outgoing session initiation will disregard the configured transport and use the determined one.</p>
  51. <p>If the target is not found in the roster the target will be used as-is and a session will be initiated using the transport specified in this configuration file. If no transport has been specified the endpoint defaults to <code>ice-udp</code>.</p>
  52. <p>Video Support</p>
  53. <p>Support for video does not need to be explicitly enabled. Configuring any video codec on your endpoint will automatically enable it.</p>
  54. <p>DTMF</p>
  55. <p>The only supported method for DTMF is RFC2833. This is always enabled on audio streams and negotiated if possible.</p>
  56. <p>Incoming Calls</p>
  57. <p>Incoming calls will first look for the extension matching the name of the endpoint in the configured context. If no such extension exists the call will automatically fall back to the <code>s</code> extension.</p>
  58. <p>CallerID</p>
  59. <p>The incoming caller id number is populated with the username of the caller and the name is populated with the full identity of the caller. If you would like to perform authentication or filtering of incoming calls it is recommended that you use these fields to do so.</p>
  60. <p>Outgoing caller id can <strong>not</strong> be set.</p>
  61. <div class="aui-message problem shadowed information-macro">
  62. <p class="title">Warning</p>
  63. <span class="aui-icon icon-problem">Icon</span>
  64. <div class="message-content">
  65. <p>Multiple endpoints using the same connection is <strong>NOT</strong> supported. Doing so may result in broken calls.</p>
  66. </div>
  67. </div>
  68. <h2 id="Asterisk13Configuration_chan_motif-motif.conf">motif.conf</h2>
  69. <h3 id="Asterisk13Configuration_chan_motif-endpoint">endpoint</h3>
  70. <p>The configuration for an endpoint.</p>
  71. <h4 id="Asterisk13Configuration_chan_motif-ConfigurationOptionReference">Configuration Option Reference</h4>
  72. <div class="table-wrap"><table class="confluenceTable"><tbody>
  73. <tr>
  74. <th class="confluenceTh"><p> Option Name </p></th>
  75. <th class="confluenceTh"><p> Type </p></th>
  76. <th class="confluenceTh"><p> Default Value </p></th>
  77. <th class="confluenceTh"><p> Regular Expression </p></th>
  78. <th class="confluenceTh"><p> Description </p></th>
  79. </tr>
  80. <tr>
  81. <td class="confluenceTd"><p> <code>context</code> </p></td>
  82. <td class="confluenceTd"><p> <code>String</code> </p></td>
  83. <td class="confluenceTd"><p> <code>default</code> </p></td>
  84. <td class="confluenceTd"><p> <code>false</code> </p></td>
  85. <td class="confluenceTd"><p> Default dialplan context that incoming sessions will be routed to </p></td>
  86. </tr>
  87. <tr>
  88. <td class="confluenceTd"><p> <code>callgroup</code> </p></td>
  89. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  90. <td class="confluenceTd"><p> </p></td>
  91. <td class="confluenceTd"><p> <code>false</code> </p></td>
  92. <td class="confluenceTd"><p> A callgroup to assign to this endpoint. </p></td>
  93. </tr>
  94. <tr>
  95. <td class="confluenceTd"><p> <code>pickupgroup</code> </p></td>
  96. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  97. <td class="confluenceTd"><p> </p></td>
  98. <td class="confluenceTd"><p> <code>false</code> </p></td>
  99. <td class="confluenceTd"><p> A pickup group to assign to this endpoint. </p></td>
  100. </tr>
  101. <tr>
  102. <td class="confluenceTd"><p> <code>language</code> </p></td>
  103. <td class="confluenceTd"><p> <code>String</code> </p></td>
  104. <td class="confluenceTd"><p> </p></td>
  105. <td class="confluenceTd"><p> <code>false</code> </p></td>
  106. <td class="confluenceTd"><p> The default language for this endpoint. </p></td>
  107. </tr>
  108. <tr>
  109. <td class="confluenceTd"><p> <code>musicclass</code> </p></td>
  110. <td class="confluenceTd"><p> <code>String</code> </p></td>
  111. <td class="confluenceTd"><p> </p></td>
  112. <td class="confluenceTd"><p> <code>false</code> </p></td>
  113. <td class="confluenceTd"><p> Default music on hold class for this endpoint. </p></td>
  114. </tr>
  115. <tr>
  116. <td class="confluenceTd"><p> <code>parkinglot</code> </p></td>
  117. <td class="confluenceTd"><p> <code>String</code> </p></td>
  118. <td class="confluenceTd"><p> </p></td>
  119. <td class="confluenceTd"><p> <code>false</code> </p></td>
  120. <td class="confluenceTd"><p> Default parking lot for this endpoint. </p></td>
  121. </tr>
  122. <tr>
  123. <td class="confluenceTd"><p> <code>accountcode</code> </p></td>
  124. <td class="confluenceTd"><p> <code>String</code> </p></td>
  125. <td class="confluenceTd"><p> </p></td>
  126. <td class="confluenceTd"><p> <code>false</code> </p></td>
  127. <td class="confluenceTd"><p> Accout code for CDR purposes </p></td>
  128. </tr>
  129. <tr>
  130. <td class="confluenceTd"><p> <code>allow</code> </p></td>
  131. <td class="confluenceTd"><p> <code>Codec</code> </p></td>
  132. <td class="confluenceTd"><p> <code>ulaw,alaw</code> </p></td>
  133. <td class="confluenceTd"><p> <code>false</code> </p></td>
  134. <td class="confluenceTd"><p> Codecs to allow </p></td>
  135. </tr>
  136. <tr>
  137. <td class="confluenceTd"><p> <code>disallow</code> </p></td>
  138. <td class="confluenceTd"><p> <code>Codec</code> </p></td>
  139. <td class="confluenceTd"><p> <code>all</code> </p></td>
  140. <td class="confluenceTd"><p> <code>false</code> </p></td>
  141. <td class="confluenceTd"><p> Codecs to disallow </p></td>
  142. </tr>
  143. <tr>
  144. <td class="confluenceTd"><p> <code>connection</code> </p></td>
  145. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  146. <td class="confluenceTd"><p> </p></td>
  147. <td class="confluenceTd"><p> <code>false</code> </p></td>
  148. <td class="confluenceTd"><p> Connection to accept traffic on and on which to send traffic out </p></td>
  149. </tr>
  150. <tr>
  151. <td class="confluenceTd"><p> <a href="Asterisk-13-Configuration_chan_motif_29394341.html"><code>transport</code></a> </p></td>
  152. <td class="confluenceTd"><p> <code>Custom</code> </p></td>
  153. <td class="confluenceTd"><p> </p></td>
  154. <td class="confluenceTd"><p> <code>false</code> </p></td>
  155. <td class="confluenceTd"><p> The transport to use for the endpoint. </p></td>
  156. </tr>
  157. <tr>
  158. <td class="confluenceTd"><p> <code>maxicecandidates</code> </p></td>
  159. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  160. <td class="confluenceTd"><p> <code>10</code> </p></td>
  161. <td class="confluenceTd"><p> <code>false</code> </p></td>
  162. <td class="confluenceTd"><p> Maximum number of ICE candidates to offer </p></td>
  163. </tr>
  164. <tr>
  165. <td class="confluenceTd"><p> <code>maxpayloads</code> </p></td>
  166. <td class="confluenceTd"><p> <code>Unsigned Integer</code> </p></td>
  167. <td class="confluenceTd"><p> <code>30</code> </p></td>
  168. <td class="confluenceTd"><p> <code>false</code> </p></td>
  169. <td class="confluenceTd"><p> Maximum number of pyaloads to offer </p></td>
  170. </tr>
  171. </tbody></table></div>
  172. <h4 id="Asterisk13Configuration_chan_motif-ConfigurationOptionDescriptions">Configuration Option Descriptions</h4>
  173. <p><span class="confluence-anchor-link" id="Asterisk13Configuration_chan_motif-endpoint_transport"></span></p>
  174. <h5 id="Asterisk13Configuration_chan_motif-transport">transport</h5>
  175. <p>The default outbound transport for this endpoint. Inbound messages are inferred. Allowed transports are <code>ice-udp</code>, <code>google</code>, or <code>google-v1</code>. Note that <code>chan_motif</code> will fall back to transport preference order if the transport value chosen here fails.</p>
  176. <ul>
  177. <li><code>ice-udp</code> - The Jingle protocol, as defined in XEP 0166.</li>
  178. <li><code>google</code> - The Google Jingle protocol, which follows the Jingle specification for signaling but uses a custom transport for media.</li>
  179. <li><code>google-v1</code> - Google-V1 is the original Google Talk signaling protocol which uses an initial preliminary version of Jingle. It also uses the same custom transport as <code>google</code> for media.</li>
  180. </ul>
  181. <h3 id="Asterisk13Configuration_chan_motif-ImportVersion">Import Version</h3>
  182. <p>This documentation was imported from Asterisk Version SVN-branch-13-r420538</p>
  183. </div>
  184. </div> </div>
  185. <div id="footer">
  186. <section class="footer-body">
  187. <p>Document generated by Confluence on Aug 11, 2014 13:48</p>
  188. </section>
  189. </div>
  190. </div> </body>
  191. </html>