moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-22 01:02:17 -05:00
Code Issues Releases Wiki Activity

0.14

Browse Source 
git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@1507 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2008-01-03 21:12:30 +00:00
parent adad2a4a8c
commit bad26d2a6e
1 changed files with 165 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

173
xep-0167.xml
View File

@ -25,6 +25,12 @@
&stpeter; &stpeter;
&seanegan; &seanegan;
&robmcqueen; &robmcqueen;
<revision>
<version>0.14</version>
<date>2008-01-03</date>
<initials>psa</initials>
<remark><p>Modified examples to track changes to XEP-0176.</p></remark>
</revision>
<revision> <revision>
<version>0.13</version> <version>0.13</version>
<date>2007-12-06</date> <date>2007-12-06</date>
@ -596,6 +602,12 @@ Romeo Juliet
| transport-info (X times) | | transport-info (X times) |
| (with acks) | | (with acks) |
|<--------------------------->| |<--------------------------->|
| STUN connectivity checks |
|<--------------------------->|
| content-modify |
|---------------------------->|
| ack |
|<----------------------------|
| session-accept | | session-accept |
|<----------------------------| |<----------------------------|
| ack | | ack |
@ -656,7 +668,48 @@ Romeo Juliet
to='juliet@capulet.lit/balcony' to='juliet@capulet.lit/balcony'
type='result'/> type='result'/>
]]></example> ]]></example>
<p>Because the parties have chosen the Jingle ICE-UDP Transport Method, the initiator and responder exchange an open-ended number of possible candidate transports, perform connectivity checks, and agree upon a candidate transport as explained in <cite>XEP-0176</cite>. Once one of the candidate transports is found to work, the responder accepts the session.</p> <p>Because the parties have chosen the Jingle ICE-UDP Transport Method, the initiator and responder exchange an open-ended number of possible candidate transports, perform connectivity checks, and agree upon a candidate transport as explained in <cite>XEP-0176</cite>. Once ICE negotiation is completed, the initiator sends a content-modify action to the responder.</p>
<example caption="Initiator requests content-modify"><![CDATA[
<iq from='romeo@montague.lit/orchard'
id='mod1'
to='juliet@capulet.lit/balcony'
type='set'>
<jingle xmlns='http://www.xmpp.org/extensions/xep-0166.html#ns'
action='content-modify'
initiator='romeo@montague.lit/orchard'
sid='a73sjjvkla37jfea'>
<content creator='initiator' name='this-is-the-audio-content' profile='RTP/AVP'>
<description xmlns='http://www.xmpp.org/extensions/xep-0167.html#ns'>
[ ... ]
</description>
<transport xmlns='http://www.xmpp.org/extensions/xep-0176.html#ns'>
<candidate component='1'
foundation='1'
generation='0'
ip='192.0.2.3'
network='1'
port='45664'
priority='1694498815'
protocol='udp'
pwd='asd88fgpdd777uzjYhagZg'
rel-addr='10.0.1.1'
rel-port='8998'
rem-addr='192.0.2.1'
rem-port='3478'
type='srflx'
ufrag='8hhy'/>
</transport>
</content>
</jingle>
</iq>
]]></example>
<p>The responder then acknowledges the content-modify action and sends a session-accept action.</p>
<example caption="Responder acknowledges content-modify"><![CDATA[
<iq from='juliet@capulet.lit/balcony'
id='mod1'
to='romeo@montague.lit/orchard'
type='result'/>
]]></example>
<example caption="Responder sends session-accept"><![CDATA[ <example caption="Responder sends session-accept"><![CDATA[
<iq from='juliet@capulet.lit/balcony' <iq from='juliet@capulet.lit/balcony'
id='accept1' id='accept1'
@ -684,9 +737,13 @@ Romeo Juliet
ip='192.0.2.3' ip='192.0.2.3'
network='1' network='1'
port='45664' port='45664'
priority='1678246398' priority='1694498815'
protocol='udp' protocol='udp'
pwd='asd88fgpdd777uzjYhagZg' pwd='asd88fgpdd777uzjYhagZg'
rel-addr='10.0.1.1'
rel-port='8998'
rem-addr='192.0.2.1'
rem-port='3478'
type='srflx' type='srflx'
ufrag='8hhy'/> ufrag='8hhy'/>
</transport> </transport>
@ -750,6 +807,12 @@ Romeo Juliet
| transport-info (X times) | | transport-info (X times) |
| (with acks) | | (with acks) |
|<--------------------------->| |<--------------------------->|
| STUN connectivity checks |
|<--------------------------->|
| content-modify |
|---------------------------->|
| ack |
|<----------------------------|
| session-accept | | session-accept |
|<----------------------------| |<----------------------------|
| ack | | ack |
@ -882,8 +945,48 @@ Romeo Juliet
to='romeo@montague.lit/orchard' to='romeo@montague.lit/orchard'
type='result'/> type='result'/>
]]></example> ]]></example>
<p>As in the previous scenario, the parties exchange ICE candidates (see above for examples).</p> <p>Because the parties have chosen the Jingle ICE-UDP Transport Method, the initiator and responder exchange an open-ended number of possible candidate transports, perform connectivity checks, and agree upon a candidate transport as explained in <cite>XEP-0176</cite>. Once ICE negotiation is completed, the initiator sends a content-modify action to the responder.</p>
<p>Once the parties find candidate transports that work, the responder accepts the session.</p> <example caption="Initiator requests content-modify"><![CDATA[
<iq from='romeo@montague.lit/orchard'
id='mod1'
to='juliet@capulet.lit/balcony'
type='set'>
<jingle xmlns='http://www.xmpp.org/extensions/xep-0166.html#ns'
action='content-modify'
initiator='romeo@montague.lit/orchard'
sid='a73sjjvkla37jfea'>
<content creator='initiator' name='this-is-the-audio-content' profile='RTP/AVP'>
<description xmlns='http://www.xmpp.org/extensions/xep-0167.html#ns'>
[ ... ]
</description>
<transport xmlns='http://www.xmpp.org/extensions/xep-0176.html#ns'>
<candidate component='1'
foundation='1'
generation='0'
ip='192.0.2.3'
network='1'
port='45664'
priority='1694498815'
protocol='udp'
pwd='asd88fgpdd777uzjYhagZg'
rel-addr='10.0.1.1'
rel-port='8998'
rem-addr='192.0.2.1'
rem-port='3478'
type='srflx'
ufrag='8hhy'/>
</transport>
</content>
</jingle>
</iq>
]]></example>
<p>The responder then acknowledges the content-modify action and sends a session-accept action.</p>
<example caption="Responder acknowledges content-modify"><![CDATA[
<iq from='juliet@capulet.lit/balcony'
id='mod1'
to='romeo@montague.lit/orchard'
type='result'/>
]]></example>
<example caption="Responder sends session-accept"><![CDATA[ <example caption="Responder sends session-accept"><![CDATA[
<iq from='juliet@capulet.lit/balcony' <iq from='juliet@capulet.lit/balcony'
id='accept1' id='accept1'
@ -911,9 +1014,13 @@ Romeo Juliet
ip='192.0.2.3' ip='192.0.2.3'
network='1' network='1'
port='45664' port='45664'
priority='1678246398' priority='1694498815'
protocol='udp' protocol='udp'
pwd='asd88fgpdd777uzjYhagZg' pwd='asd88fgpdd777uzjYhagZg'
rel-addr='10.0.1.1'
rel-port='8998'
rem-addr='192.0.2.1'
rem-port='3478'
type='srflx' type='srflx'
ufrag='8hhy'/> ufrag='8hhy'/>
</transport> </transport>
@ -1081,6 +1188,12 @@ Romeo Juliet
| transport-info (X times) | | transport-info (X times) |
| (with acks) | | (with acks) |
|<--------------------------->| |<--------------------------->|
| STUN connectivity checks |
|<--------------------------->|
| content-modify |
|---------------------------->|
| ack |
|<----------------------------|
| session-accept | | session-accept |
|<----------------------------| |<----------------------------|
| ack | | ack |
@ -1184,8 +1297,48 @@ Romeo Juliet
to='romeo@montague.lit/orchard' to='romeo@montague.lit/orchard'
type='result'/> type='result'/>
]]></example> ]]></example>
<p>As in the previous scenario, the parties exchange ICE candidates (see above for examples).</p> <p>Because the parties have chosen the Jingle ICE-UDP Transport Method, the initiator and responder exchange an open-ended number of possible candidate transports, perform connectivity checks, and agree upon a candidate transport as explained in <cite>XEP-0176</cite>. Once ICE negotiation is completed, the initiator sends a content-modify action to the responder.</p>
<p>If one of the candidate transports is found to work, the responder accepts the session.</p> <example caption="Initiator requests content-modify"><![CDATA[
<iq from='romeo@montague.lit/orchard'
id='mod1'
to='juliet@capulet.lit/balcony'
type='set'>
<jingle xmlns='http://www.xmpp.org/extensions/xep-0166.html#ns'
action='content-modify'
initiator='romeo@montague.lit/orchard'
sid='a73sjjvkla37jfea'>
<content creator='initiator' name='this-is-the-audio-content' profile='RTP/AVP'>
<description xmlns='http://www.xmpp.org/extensions/xep-0167.html#ns'>
[ ... ]
</description>
<transport xmlns='http://www.xmpp.org/extensions/xep-0176.html#ns'>
<candidate component='1'
foundation='1'
generation='0'
ip='192.0.2.3'
network='1'
port='45664'
priority='1694498815'
protocol='udp'
pwd='asd88fgpdd777uzjYhagZg'
rel-addr='10.0.1.1'
rel-port='8998'
rem-addr='192.0.2.1'
rem-port='3478'
type='srflx'
ufrag='8hhy'/>
</transport>
</content>
</jingle>
</iq>
]]></example>
<p>The responder then acknowledges the content-modify action and sends a session-accept action.</p>
<example caption="Responder acknowledges content-modify"><![CDATA[
<iq from='juliet@capulet.lit/balcony'
id='mod1'
to='romeo@montague.lit/orchard'
type='result'/>
]]></example>
<example caption="Responder sends session-accept"><![CDATA[ <example caption="Responder sends session-accept"><![CDATA[
<iq from='juliet@capulet.lit/balcony' <iq from='juliet@capulet.lit/balcony'
id='accept1' id='accept1'
@ -1213,9 +1366,13 @@ Romeo Juliet
ip='192.0.2.3' ip='192.0.2.3'
network='1' network='1'
port='45664' port='45664'
priority='1678246398' priority='1694498815'
protocol='udp' protocol='udp'
pwd='asd88fgpdd777uzjYhagZg' pwd='asd88fgpdd777uzjYhagZg'
rel-addr='10.0.1.1'
rel-port='8998'
rem-addr='192.0.2.1'
rem-port='3478'
type='srflx' type='srflx'
ufrag='8hhy'/> ufrag='8hhy'/>
</transport> </transport>