XEP-0327 v0.6 -- Changes to address Last Call feedback (bl).

This commit is contained in:
Matthew A. Miller 2015-04-29 13:09:33 -06:00
parent b24ed1e93d
commit 9d370fbaf6
1 changed files with 15 additions and 12 deletions

View File

@ -31,10 +31,16 @@
<author> <author>
<firstname>Jose</firstname> <firstname>Jose</firstname>
<surname>de Castro</surname> <surname>de Castro</surname>
<email>jdecastro@voxeo.com</email> <email>jdecastro@tropo.com</email>
<jid>jdecastro@voxeo.com</jid> <jid>jdecastro@tropo.com</jid>
<uri>http://voxeolabs.com</uri> <uri>http://tropo.com</uri>
</author> </author>
<revision>
<version>0.6</version>
<date>2015-04-29</date>
<initials>bl</initials>
<remark><p>Changes to address Last Call feedback.</p></remark>
</revision>
<revision> <revision>
<version>0.5</version> <version>0.5</version>
<date>2014-09-23</date> <date>2014-09-23</date>
@ -410,7 +416,7 @@
<p>Sessions may be established either at the request of the Rayo client (an outbound call) or as a result of a 3rd party request (an inbound call). Each scenario differs in the Rayo protocol only up to the point at which the session is established and media begins to flow. First we shall examine the sequence of stanzas passed between server and client in each of these scenarios.</p> <p>Sessions may be established either at the request of the Rayo client (an outbound call) or as a result of a 3rd party request (an inbound call). Each scenario differs in the Rayo protocol only up to the point at which the session is established and media begins to flow. First we shall examine the sequence of stanzas passed between server and client in each of these scenarios.</p>
<section3 topic='Outbound Call' anchor='session-establishment-outbound'> <section3 topic='Outbound Call' anchor='session-establishment-outbound'>
<p>In order for a client to establish a new outbound call, it MUST first send a <link url="def-dial">dial command</link> to the server, indicating the proposed target for the call, its apparent source, and any meta-data to send to the target as headers.</p> <p>In order for a client to establish a new outbound call, it MUST first send a <link url="#def-dial">dial command</link> to the server, indicating the proposed target for the call, its apparent source, and any meta-data to send to the target as headers.</p>
<example caption="Client requests establishment of a new outbound session"><![CDATA[ <example caption="Client requests establishment of a new outbound session"><![CDATA[
<iq from='juliet@capulet.lit/balcony' <iq from='juliet@capulet.lit/balcony'
@ -2916,11 +2922,8 @@ Art thou not Romeo, and a Montague?
</section3> </section3>
</section2> </section2>
</section1> </section1>
<section1 topic='Use Cases' anchor='usecases'>
<p>STRONGLY RECOMMENDED.</p>
</section1>
<section1 topic='Determining Support' anchor='support'> <section1 topic='Determining Support' anchor='support'>
<p>If an entity supports Rayo, it MUST advertise that fact by returning a feature of "urn:xmpp:rayo:0" &VNOTE; in response to a &xep0030; information request. The response MUST also include features for the application formats and transport methods supported by the responding entity, as described in the relevant specifications.</p> <p>If an entity supports Rayo, it MUST advertise that fact by returning a feature of "urn:xmpp:rayo:1" &VNOTE; in response to a &xep0030; information request. The response MUST also include features for the application formats and transport methods supported by the responding entity, as described in the relevant specifications.</p>
<example caption="Service Discovery Information Request - Client to Server"><![CDATA[ <example caption="Service Discovery Information Request - Client to Server"><![CDATA[
<iq from='kingclaudius@shakespeare.lit/castle' <iq from='kingclaudius@shakespeare.lit/castle'
id='disco1' id='disco1'
@ -2935,7 +2938,7 @@ Art thou not Romeo, and a Montague?
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:rayo:0'/> <feature var='urn:xmpp:rayo:1'/>
</query> </query>
</iq> </iq>
]]></example> ]]></example>
@ -2953,7 +2956,7 @@ Art thou not Romeo, and a Montague?
to='call.rayo.org' to='call.rayo.org'
type='result'> type='result'>
<query xmlns='http://jabber.org/protocol/disco#info'> <query xmlns='http://jabber.org/protocol/disco#info'>
<feature var='urn:xmpp:rayo:client:0'/> <feature var='urn:xmpp:rayo:client:1'/>
</query> </query>
</iq> </iq>
]]></example> ]]></example>
@ -4382,10 +4385,10 @@ Art thou not Romeo, and a Montague?
<li>To enable authenticated, federated, web-scale 3PCC on platforms with APIs only suitable for trusted internal use (Asterisk, FreeSWITCH, etc).</li> <li>To enable authenticated, federated, web-scale 3PCC on platforms with APIs only suitable for trusted internal use (Asterisk, FreeSWITCH, etc).</li>
</ul> </ul>
Initial development of the Rayo specification and its reference implementation was sponsored by Voxeo Labs and Telefónica, with Punchblock being the first client library implementation, as part of the Adhearsion project. Since the beginning of the development process, further implementation efforts have begun on top of Asterisk's AGI/AMI protocols and FreeSWITCH EventSocket, native to FreeSWITCH (mod_rayo), as well as client library implementations in Node/CoffeeScript and Python. Initial development of the Rayo specification and its reference implementation was sponsored by Tropo (formerly Voxeo Labs) and Telefónica, with Punchblock being the first client library implementation, as part of the Adhearsion project. Since the beginning of the development process, further implementation efforts have begun on top of Asterisk's AGI/AMI protocols and FreeSWITCH EventSocket, native to FreeSWITCH (mod_rayo), as well as client library implementations in Node/CoffeeScript and Python.
</section1> </section1>
<section1 topic='Acknowledgements' anchor='acknowledgements'> <section1 topic='Acknowledgements' anchor='acknowledgements'>
<p>The authors would like to acknowledge the input of teams at Voxeo Labs, Mojo Lingo and Telefónica in the development of the initial specification, and Grasshopper in expanding the implementation landscape.</p> <p>The authors would like to acknowledge the input of teams at Tropo (formerly Voxeo Labs), Mojo Lingo and Telefónica in the development of the initial specification, and Grasshopper in expanding the implementation landscape.</p>
<p>Specific individuals who have contributed to the specification or to software significant to its completion include:</p> <p>Specific individuals who have contributed to the specification or to software significant to its completion include:</p>
<ul> <ul>