moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-23 09:42:20 -05:00
Code Issues Releases Wiki Activity

Update XEP-0298

Browse Source 
Ported original changes from https://github.com/emcho/coin
This commit is contained in:
Saúl Ibarra Corretgé 2015-07-01 00:10:40 +02:00 committed by Matthew A. Miller
parent 44b8c2cd1f
commit 4b3918acac
1 changed files with 36 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
xep-0298.xml
View File

@ -16,7 +16,7 @@
</abstract> </abstract>
&LEGALNOTICE; &LEGALNOTICE;
<number>0298</number> <number>0298</number>
<status>Deferred</status> <status>Experimental</status>
<type>Standards Track</type> <type>Standards Track</type>
<sig>Standards</sig> <sig>Standards</sig>
<approver>Council</approver> <approver>Council</approver>
@ -30,15 +30,27 @@
<firstname>Emil</firstname> <firstname>Emil</firstname>
<surname>Ivov</surname> <surname>Ivov</surname>
<email>emcho@jitsi.org</email> <email>emcho@jitsi.org</email>
<jid>emcho@sip-communicator.org</jid> <jid>emcho@jit.si</jid>
</author> </author>
<author> <author>
<firstname>Enrico</firstname> <firstname>Enrico</firstname>
<surname>Marocco</surname> <surname>Marocco</surname>
<email>enrico.marocco@telecomitalia.it</email> <email>enrico.marocco@telecomitalia.it</email>
<jid>enrico@tilab.com </jid> <jid>enrico@tilab.com</jid>
</author>
<author>
<firstname>Saúl Ibarra</firstname>
<surname>Corretgé</surname>
<email>saul@ag-projects.com</email>
<jid>saul@ag-projects.com</jid>
</author> </author>
<discuss>jingle</discuss> <discuss>jingle</discuss>
<revision>
<version>0.2</version>
<date>2015-07-02</date>
<initials>sic</initials>
<remark><p>Correcting errors in grammar and examples; aligning closer to dependent specifications.</p></remark>
</revision>
<revision> <revision>
<version>0.1</version> <version>0.1</version>
<date>2011-06-09</date> <date>2011-06-09</date>
@ -74,8 +86,8 @@
<p>A conference participant exchanges Coin IQs only with the agent they <p>A conference participant exchanges Coin IQs only with the agent they
have established a session with. This means that it can also be used in have established a session with. This means that it can also be used in
cases where only a subset of the users on a call are using XMPP while others cases where only a subset of the users on a call are using XMPP while others
are connected via alternative mechanisms such as SIP's conference are connected via alternative mechanisms such as SIP conferencing as defined
package &rfc4575;</p> in &rfc4579;</p>
</section1> </section1>
<section1 topic='Terminology' anchor='terms'> <section1 topic='Terminology' anchor='terms'>
<dl> <dl>
@ -86,7 +98,9 @@
signalling and media. Other specifications refer to mixers and focus signalling and media. Other specifications refer to mixers and focus
agents as two distinct entities but we find this separation to be agents as two distinct entities but we find this separation to be
unnecessary in the current specification and view both as a single logical unnecessary in the current specification and view both as a single logical
entity</dd> entity. This entity may be a person hosting the conference and doing the mixing
or a dedicated entity to which participants connect in order to establish a conference.
For the purposes of this specification, both scenarios are equivalent.</dd>
</di> </di>
</dl> </dl>
</section1> </section1>
@ -97,12 +111,12 @@
<li>Provide a means for mixer agents in tightly coupled <li>Provide a means for mixer agents in tightly coupled
conferences to advertise call and member state information to the call conferences to advertise call and member state information to the call
participants.</li> participants.</li>
<li>Reuse as much as possible the existing format and XML schema already <li>Reuse the existing format and XML schema already
defined in <cite>RFC 4575</cite>.</li> defined in <cite>RFC 4575</cite>.</li>
<li>Impose no requirements on agents joining the call other than those <li>Impose no requirements on agents joining the call other than those
necessary to establish a regular one-to-one call.</li> necessary to establish a regular one-to-one call.</li>
<li>Allow straightforward interoperability with other conferencing <li>Allow straightforward interoperability with other conferencing
mechanisms such as <cite>RFC 4575</cite>; or &xep0272;</li> mechanisms such as &rfc4579; or &xep0272;</li>
</ol> </ol>
</section1> </section1>
<section1 topic='How It Works' anchor='howitworks'> <section1 topic='How It Works' anchor='howitworks'>
@ -114,8 +128,8 @@
accordingly.</p> accordingly.</p>
<p>Once in a call, call members and mixers can use Coin to exchange <p>Once in a call, participants and mixers can use Coin to exchange
<cite>RFC 4575</cite> conference information indicating what participants &rfc4575; conference information indicating what participants
are currently on the call and what their status is.</p> are currently on the call and what their status is.</p>
</section1> </section1>
<section1 topic='Creating a conference call' anchor='call-create'> <section1 topic='Creating a conference call' anchor='call-create'>
@ -138,7 +152,7 @@
<description xmlns='urn:xmpp:jingle:apps:stub:0'/> <description xmlns='urn:xmpp:jingle:apps:stub:0'/>
<transport xmlns='urn:xmpp:jingle:transports:stub:0'/> <transport xmlns='urn:xmpp:jingle:transports:stub:0'/>
</content> </content>
<conference-info isfocus='true'/> <conference-info xmlns='urn:xmpp:coin:1' isfocus='true'/>
</jingle> </jingle>
</iq> </iq>
]]></code> ]]></code>
@ -164,6 +178,7 @@
id='zid615d9' id='zid615d9'
to='juliet@capulet.lit/balcony' to='juliet@capulet.lit/balcony'
type='set'> type='set'>
<jingle xmlns='urn:xmpp:jingle:1' sid='a73sjjvkla37jfea'/>
<conference-info xmlns="urn:ietf:params:xml:ns:conference-info" <conference-info xmlns="urn:ietf:params:xml:ns:conference-info"
entity="xmpp:romeo@monague.lit/orchard" entity="xmpp:romeo@monague.lit/orchard"
state="full" state="full"
@ -203,10 +218,10 @@
</user> </user>
<user entity="xmpp:juliet@capulet.lit" state="full"> <user entity="xmpp:juliet@capulet.lit" state="full">
<display-text>Romeo</display-text> <display-text>Juliet</display-text>
<!-- ENDPOINTS --> <!-- ENDPOINTS -->
<endpoint entity="juliet@capulet.lit/balcony/orchard"> <endpoint entity="juliet@capulet.lit/balcony">
<display-text>Juliet's netbook</display-text> <display-text>Juliet's netbook</display-text>
<status>connected</status> <status>connected</status>
@ -239,13 +254,15 @@
]]></code> ]]></code>
<p>The IQ message containing the conference info document MAY also contain a jingle element with the
session id attribute indicting the session to which the conference information refers to.</p>
</section1> </section1>
<section1 topic='Determining Support' anchor='support'> <section1 topic='Determining Support' anchor='support'>
<p>If an entity supports Coin, it SHOULD advertise that fact by returning <p>If an entity supports Coin, it SHOULD advertise that fact by returning
a feature of "urn:xmpp:coin" in response to a &xep0030; a feature of "urn:xmpp:coin:1" in response to a &xep0030;
information request.</p> information request.</p>
<example caption="Service Discovery Information Request"><![CDATA[ <example caption="Service Discovery Information Request"><![CDATA[
<iq from='kingclaudius@shakespeare.lit/castle' <iq from='kingclaudius@shakespeare.lit/castle'
@ -261,7 +278,7 @@
to='kingclaudius@shakespeare.lit/castle' to='kingclaudius@shakespeare.lit/castle'
type='result'> type='result'>
<query xmlns='http://jabber.org/protocol/disco#info'> <query xmlns='http://jabber.org/protocol/disco#info'>
<feature var='urn:xmpp:coin'/> <feature var='urn:xmpp:coin:1'/>
</query> </query>
</iq> </iq>
]]></example> ]]></example>
@ -294,14 +311,14 @@
<xs:schema <xs:schema
xmlns:xs='http://www.w3.org/2001/XMLSchema' xmlns:xs='http://www.w3.org/2001/XMLSchema'
targetNamespace='urn:xmpp:jingle:apps:coin:1' targetNamespace='urn:xmpp:coin:1'
xmlns='urn:xmpp:jingle:apps:coin:1' xmlns='urn:xmpp:coin:1'
elementFormDefault='qualified'> elementFormDefault='qualified'>
<xs:annotation> <xs:annotation>
<xs:documentation> <xs:documentation>
The protocol documented by this schema is defined in The protocol documented by this schema is defined in
XEP-0XXX: http://www.xmpp.org/extensions/xep-0XXX.html XEP-0298: http://www.xmpp.org/extensions/xep-0298.html
</xs:documentation> </xs:documentation>
</xs:annotation> </xs:annotation>
@ -329,7 +346,7 @@
<xs:documentation> <xs:documentation>
The protocol documented by this schema is defined in The protocol documented by this schema is defined in
RFC 4575: http://tools.ietf.org/html/rfc4575 and reused by RFC 4575: http://tools.ietf.org/html/rfc4575 and reused by
XEP XXXX http://www.xmpp.org/extensions/xep-XXXX.html XEP-0298 http://www.xmpp.org/extensions/xep-0298.html
</xs:documentation> </xs:documentation>
</xs:annotation> </xs:annotation>