| | | | |
| Offset 1, 115 lines modified | Offset 1, 689 lines modified |
| 1 | <?xml·version="1.0"·encoding="utf-8"?> | 1 | <?xml·version="1.0"·encoding="utf-8"?> |
| 2 | <!DOCTYPE·docs | 2 | <!DOCTYPE·docs |
| 3 | ··SYSTEM·'appdocsxml.dtd'> | 3 | ··SYSTEM·'appdocsxml.dtd'> |
| 4 | <?xml-stylesheet·type="text/xsl"·href="appdocsxml.xslt"?> | 4 | <?xml-stylesheet·type="text/xsl"·href="appdocsxml.xslt"?> |
| 5 | <docs·xmlns:xi="http://www.w3.org/2001/XInclude"> | 5 | <docs·xmlns:xi="http://www.w3.org/2001/XInclude"> |
| 6 | ··<module·language="en_US"·name="chan_rtp"> | 6 | ··<module·language="en_US"·name="chan_motif"> |
| | 7 | ····<depend>iksemel</depend> |
| 7 | ····<depend>res_rtp_multicast</depend> | 8 | ····<depend>res_xmpp</depend> |
| | 9 | ····<use·type="external">openssl</use> |
| 8 | ····<support_level>core</support_level> | 10 | ····<support_level>core</support_level> |
| 9 | ··</module> | 11 | ··</module> |
| | 12 | ··<configInfo·name="chan_motif"·language="en_US"> |
| | 13 | ····<synopsis>Jingle·Channel·Driver</synopsis> |
| | 14 | ····<description> |
| | 15 | ······<para> |
| | 16 | ········<emphasis>Transports</emphasis> |
| | 17 | ······</para> |
| | 18 | ······<para> |
| | 19 | ········There·are·three·different·transports·and·protocol·derivatives |
| | 20 | » » » supported·by |
| | 21 | ········<literal>chan_motif</literal> |
| | 22 | ········.·They·are·in·order·of |
| | 23 | » » » preference:·Jingle·using·ICE-UDP,·Google·Jingle,·and·Google-V1. |
| | 24 | ······</para> |
| | 25 | ······<para> |
| | 26 | ········Jingle·as·defined·in·XEP-0166·supports·the·widest·range·of |
| | 27 | » » » features.·It·is·referred·to·as |
| | 28 | ········<literal>ice-udp</literal> |
| | 29 | ········.·This·is |
| | 30 | » » » the·specification·that·Jingle·clients·implement. |
| | 31 | ······</para> |
| | 32 | ······<para> |
| | 33 | ········Google·Jingle·follows·the·Jingle·specification·for·signaling |
| | 34 | » » » but·uses·a·custom·transport·for·media.·It·is·supported·by·the |
| | 35 | » » » Google·Talk·Plug-in·in·Gmail·and·by·some·other·Jingle·clients.·It |
| | 36 | » » » is·referred·to·as |
| | 37 | ········<literal>google</literal> |
| | 38 | ········in·this·file. |
| | 39 | ······</para> |
| | 40 | ······<para> |
| | 41 | ········Google-V1·is·the·original·Google·Talk·signaling·protocol |
| | 42 | » » » which·uses·an·initial·preliminary·version·of·Jingle.·It·also·uses |
| | 43 | » » » the·same·custom·transport·as·Google·Jingle·for·media.·It·is |
| | 44 | » » » supported·by·Google·Voice,·some·other·Jingle·clients,·and·the |
| | 45 | » » » Windows·Google·Talk·client.·It·is·referred·to·as |
| | 46 | ········<literal>google-v1</literal> |
| | 47 | ········in·this·file. |
| | 48 | ······</para> |
| | 49 | ······<para>Incoming·sessions·will·automatically·switch·to·the·correct |
| | 50 | » » » transport·once·it·has·been·determined.</para> |
| | 51 | ······<para>Outgoing·sessions·are·capable·of·determining·if·the·target |
| | 52 | » » » is·capable·of·Jingle·or·a·Google·transport·if·the·target·is·in·the |
| | 53 | » » » roster.·Unfortunately·it·is·not·possible·to·differentiate·between |
| | 54 | » » » a·Google·Jingle·or·Google-V1·capable·resource·until·a·session |
| | 55 | » » » initiate·attempt·occurs.·If·a·resource·is·determined·to·use·a |
| | 56 | » » » Google·transport·it·will·initially·use·Google·Jingle·but·will·fall |
| | 57 | » » » back·to·Google-V1·if·required.</para> |
| | 58 | ······<para> |
| | 59 | ········If·an·outgoing·session·attempt·fails·due·to·failure·to |
| | 60 | » » » support·the·given·transport |
| | 61 | ········<literal>chan_motif</literal> |
| | 62 | ········will |
| | 63 | » » » fall·back·in·preference·order·listed·previously·until·all |
| | 64 | » » » transports·have·been·exhausted. |
| | 65 | ······</para> |
| | 66 | ······<para> |
| | 67 | ········<emphasis>Dialing·and·Resource·Selection·Strategy</emphasis> |
| | 68 | ······</para> |
| | 69 | ······<para>Placing·a·call·through·an·endpoint·can·be·accomplished·using·the |
| | 70 | » » » following·dial·string:</para> |
| | 71 | ······<para> |
| | 72 | ········<literal>Motif/[endpoint·name]/[target]</literal> |
| | 73 | ······</para> |
| | 74 | ······<para>When·placing·an·outgoing·call·through·an·endpoint·the·requested |
| | 75 | » » » target·is·searched·for·in·the·roster·list.·If·present·the·first·Jingle |
| | 76 | » » » or·Google·Jingle·capable·resource·is·specifically·targeted.·Since·the |
| | 77 | » » » capabilities·of·the·resource·are·known·the·outgoing·session·initiation |
| | 78 | » » » will·disregard·the·configured·transport·and·use·the·determined·one.</para> |
| | 79 | ······<para> |
| | 80 | ········If·the·target·is·not·found·in·the·roster·the·target·will·be·used |
| | 81 | » » » as-is·and·a·session·will·be·initiated·using·the·transport·specified |
| | 82 | » » » in·this·configuration·file.·If·no·transport·has·been·specified·the |
| | 83 | » » » endpoint·defaults·to |
| | 84 | ········<literal>ice-udp</literal> |
| | 85 | ········. |
| | 86 | ······</para> |
| | 87 | ······<para> |
| | 88 | ········<emphasis>Video·Support</emphasis> |
| | 89 | ······</para> |
| | 90 | ······<para>Support·for·video·does·not·need·to·be·explicitly·enabled. |
| | 91 | » » » Configuring·any·video·codec·on·your·endpoint·will·automatically·enable |
| | 92 | » » » it.</para> |
| | 93 | ······<para> |
| | 94 | ········<emphasis>DTMF</emphasis> |
| | 95 | ······</para> |
| | 96 | ······<para>The·only·supported·method·for·DTMF·is·RFC2833.·This·is·always |
| | 97 | » » » enabled·on·audio·streams·and·negotiated·if·possible.</para> |
| | 98 | ······<para> |
| | 99 | ········<emphasis>Incoming·Calls</emphasis> |
| | 100 | ······</para> |
| | 101 | ······<para> |
| | 102 | ········Incoming·calls·will·first·look·for·the·extension·matching·the |
| | 103 | » » » name·of·the·endpoint·in·the·configured·context.·If·no·such·extension |
| | 104 | » » » exists·the·call·will·automatically·fall·back·to·the |
| | 105 | ········<literal>s</literal> |
| | 106 | ········extension. |
| | 107 | ······</para> |
| | 108 | ······<para> |
| | 109 | ········<emphasis>CallerID</emphasis> |
| | 110 | ······</para> |
| | 111 | ······<para>The·incoming·caller·id·number·is·populated·with·the·username·of |
| | 112 | » » » the·caller·and·the·name·is·populated·with·the·full·identity·of·the |
| | 113 | » » » caller.·If·you·would·like·to·perform·authentication·or·filtering |
| | 114 | » » » of·incoming·calls·it·is·recommended·that·you·use·these·fields·to·do·so.</para> |
| | 115 | ······<para> |
| | 116 | ········Outgoing·caller·id·can |
| | 117 | ········<emphasis>not</emphasis> |
| | 118 | ········be·set. |
| | 119 | ······</para> |
| | 120 | ······<warning> |
| | 121 | ········<para> |
| | 122 | ··········Multiple·endpoints·using·the |
| | 123 | » » » » same·connection·is |
| | 124 | ··········<emphasis>NOT</emphasis> |
| | 125 | ··········supported.·Doing·so |
| | 126 | » » » » may·result·in·broken·calls. |
| | 127 | ········</para> |
|
Max diff block lines reached; 1825722/1834707 bytes (99.51%) of diff not shown.
|