moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-21 08:45:04 -05:00
Code Issues Releases Wiki Activity

Bump namespace to core:1;

Browse Source
This commit is contained in:
Steve Kille 2019-03-19 16:13:30 +00:00
parent 60937a902c
commit 20124667e6
1 changed files with 43 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

85
xep-0369.xml
View File

@ -44,6 +44,7 @@
Make Message Archiving Optional; Make Message Archiving Optional;
Clarify that participant node only contains real JIDs; Clarify that participant node only contains real JIDs;
Change message retrieval from archive to reflect that MIX-PAM archive is now optional; Change message retrieval from archive to reflect that MIX-PAM archive is now optional;
Bump namespace to core:1;
</p></remark> </p></remark>
</revision> </revision>
<revision> <revision>
@ -632,7 +633,7 @@
<section3 topic="Participants Node" anchor="participants-node"> <section3 topic="Participants Node" anchor="participants-node">
<p>Each channel participant is represented as an item of the 'urn:xmpp:mix:nodes:participants' channel node. Each item is named by the Stable Participant ID of the participant. For example '123456' might name the node item associated with participant 'hag66@shakespeare.example'. Information is stored in a &lt;participant/&gt; element qualified by the 'urn:xmpp:mix:core:0' namespace. <p>Each channel participant is represented as an item of the 'urn:xmpp:mix:nodes:participants' channel node. Each item is named by the Stable Participant ID of the participant. For example '123456' might name the node item associated with participant 'hag66@shakespeare.example'. Information is stored in a &lt;participant/&gt; element qualified by the 'urn:xmpp:mix:core:1' namespace.
</p> </p>
<p> <p>
A Nick MAY be associated with a participant, which provides a user-oriented description of the participant. The nick associated with the user is stored in a &lt;nick/&gt; child element of the &lt;participant/&gt; element. The nick for each channel participant MUST be different to the nick of other participants (where nicks have been assigned). A Nick MAY be associated with a participant, which provides a user-oriented description of the participant. The nick associated with the user is stored in a &lt;nick/&gt; child element of the &lt;participant/&gt; element. The nick for each channel participant MUST be different to the nick of other participants (where nicks have been assigned).
@ -660,7 +661,7 @@
<example caption="Value of Participants Node"><![CDATA[ <example caption="Value of Participants Node"><![CDATA[
<items node='urn:xmpp:mix:nodes:participants'> <items node='urn:xmpp:mix:nodes:participants'>
<item id='123456'> <item id='123456'>
<participant xmlns='urn:xmpp:mix:core:0'> <participant xmlns='urn:xmpp:mix:core:1'>
<nick>thirdwitch</nick> <nick>thirdwitch</nick>
<jid>hag66@shakespeare.example</jid> <jid>hag66@shakespeare.example</jid>
</participant> </participant>
@ -694,7 +695,7 @@
<item id='2016-05-30T09:00:00'> <item id='2016-05-30T09:00:00'>
<x xmlns='jabber:x:data' type='result'> <x xmlns='jabber:x:data' type='result'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>urn:xmpp:mix:core:0</value> <value>urn:xmpp:mix:core:1</value>
</field> </field>
<field var='Name'> <field var='Name'>
<value>Witches Coven</value> <value>Witches Coven</value>
@ -763,7 +764,7 @@
<query xmlns='http://jabber.org/protocol/disco#info'/> <query xmlns='http://jabber.org/protocol/disco#info'/>
</iq> </iq>
]]></example> ]]></example>
<p>The MIX service then MUST return its identity and the features it supports, which MUST include the 'urn:xmpp:mix:core:0' feature, and the identity MUST have a category of 'conference' and a type of 'mix', as shown in the following example: </p> <p>The MIX service then MUST return its identity and the features it supports, which MUST include the 'urn:xmpp:mix:core:1' feature, and the identity MUST have a category of 'conference' and a type of 'mix', as shown in the following example: </p>
<example caption="Service responds with Disco Info result" ><![CDATA[ <example caption="Service responds with Disco Info result" ><![CDATA[
<iq from='mix.shakespeare.example' <iq from='mix.shakespeare.example'
id='lx09df27' id='lx09df27'
@ -774,18 +775,18 @@
category='conference' category='conference'
name='Shakespearean Chat Service' name='Shakespearean Chat Service'
type='mix'/> type='mix'/>
<feature var='urn:xmpp:mix:core:0'/> <feature var='urn:xmpp:mix:core:1'/>
<feature var='urn:xmpp:mix:core:0#searchable'> <feature var='urn:xmpp:mix:core:1#searchable'>
</query> </query>
</iq> </iq>
]]></example> ]]></example>
<p> <p>
A MIX service MUST return the 'urn:xmpp:mix:core:0' feature and MAY return the other features listed here: A MIX service MUST return the 'urn:xmpp:mix:core:1' feature and MAY return the other features listed here:
</p> </p>
<ul> <ul>
<li>'urn:xmpp:mix:core:0': This indicates support of MIX, and is returned by all MIX services.</li> <li>'urn:xmpp:mix:core:1': This indicates support of MIX, and is returned by all MIX services.</li>
<li>'urn:xmpp:mix:core:0#searchable': This is shown in the above example and indicates that a the MIX Service MAY be searched for channels. This presence of this feature can be used by a client to guide the user to search for channels in a MIX service.</li> <li>'urn:xmpp:mix:core:1#searchable': This is shown in the above example and indicates that a the MIX Service MAY be searched for channels. This presence of this feature can be used by a client to guide the user to search for channels in a MIX service.</li>
<li>'urn:xmpp:mix:core:0#create-channel': This is described in <link url='#usecase-admin-check-create'> Checking for Permission to Create a Channel</link> in support of channel administration. When an end user client needs to create channels, perhaps for short term usage, this feature helps the client to identify an MIX service to use. It enables a configuration where permanent (searchable) channels are placed in one MIX service and clients will be able to create channels in another MIX service which is not searchable.</li> <li>'urn:xmpp:mix:core:1#create-channel': This is described in <link url='#usecase-admin-check-create'> Checking for Permission to Create a Channel</link> in support of channel administration. When an end user client needs to create channels, perhaps for short term usage, this feature helps the client to identify an MIX service to use. It enables a configuration where permanent (searchable) channels are placed in one MIX service and clients will be able to create channels in another MIX service which is not searchable.</li>
</ul> </ul>
<p>A MIX service MUST NOT advertise support for &xep0313;, as MAM is supported by the channels and not by the service. A MIX service MUST NOT advertise support for generic &xep0060;, as although MIX makes use of PubSub it is not a generic PubSub service.</p> <p>A MIX service MUST NOT advertise support for &xep0313;, as MAM is supported by the channels and not by the service. A MIX service MUST NOT advertise support for generic &xep0060;, as although MIX makes use of PubSub it is not a generic PubSub service.</p>
</section2> </section2>
@ -834,7 +835,7 @@
category='conference' category='conference'
name='A Dark Cave' name='A Dark Cave'
type='mix'/> type='mix'/>
<feature var='urn:xmpp:mix:core:0'/> <feature var='urn:xmpp:mix:core:1'/>
<feature var='urn:xmpp:mam:2'/> <feature var='urn:xmpp:mam:2'/>
</query> </query>
</iq> </iq>
@ -893,7 +894,7 @@
<item id='2016-05-30T09:00:00'> <item id='2016-05-30T09:00:00'>
<x xmlns='jabber:x:data' type='result'> <x xmlns='jabber:x:data' type='result'>
<field var='FORM_TYPE' type='hidden'> <field var='FORM_TYPE' type='hidden'>
<value>urn:xmpp:mix:core:0</value> <value>urn:xmpp:mix:core:1</value>
</field> </field>
<field var='Name'> <field var='Name'>
<value>Witches Coven</value> <value>Witches Coven</value>
@ -934,13 +935,13 @@
<pubsub xlns='http://jabber.org/protocol/pubsub'> <pubsub xlns='http://jabber.org/protocol/pubsub'>
<items node='urn:xmpp:mix:nodes:participants'> <items node='urn:xmpp:mix:nodes:participants'>
<item id='123456'> <item id='123456'>
<participant xmlns='urn:xmpp:mix:core:0'> <participant xmlns='urn:xmpp:mix:core:1'>
<nick>thirdwitch</nick> <nick>thirdwitch</nick>
<jid>hag66@shakespeare.example</jid> <jid>hag66@shakespeare.example</jid>
</participant> </participant>
</item> </item>
<item id='87123'> <item id='87123'>
<participant xmlns='urn:xmpp:mix:core:0'> <participant xmlns='urn:xmpp:mix:core:1'>
<nick>top witch</nick> <nick>top witch</nick>
<jid>hecate@shakespeare.example</jid> <jid>hecate@shakespeare.example</jid>
</participant> </participant>
@ -973,7 +974,7 @@
<feature var='http://jabber.org/protocol/disco#info'/> <feature var='http://jabber.org/protocol/disco#info'/>
<feature var='http://jabber.org/protocol/disco#items'/> <feature var='http://jabber.org/protocol/disco#items'/>
<feature var='http://jabber.org/protocol/muc'/> <feature var='http://jabber.org/protocol/muc'/>
<feature var='urn:xmpp:mix:core:0'/> <feature var='urn:xmpp:mix:core:1'/>
</query> </query>
</iq> </iq>
]]></example> ]]></example>
@ -988,7 +989,7 @@
</p> </p>
</section3> </section3>
<section3 topic='Joining a Channel' anchor='usecase-user-join'> <section3 topic='Joining a Channel' anchor='usecase-user-join'>
<p>A user joins a channel by sending a MIX "join" command from one of the user's clients, which will be relayed to the server as specified in MIX-PAM. There is no default set of nodes, so the user MUST specify the set of nodes to be subscribed to. To achieve the equivalent service to MUC, a user would subscribe to both messages and presence nodes. A user will typically subscribe to at least the message and/or presence nodes but MAY join and not subscribe to any nodes. Note that the presence node is specified in MIX-PRESENCE. The &lt;join/&gt; is a child element of &lt;iq/&gt; element. The &lt;join/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace. The requested nodes are encoded as &lt;subscribe/&gt; child elements of the &lt;join/&gt; element. A nick MAY be specified as a &lt;nick/&gt; child elements of the &lt;join/&gt; element. </p> <p>A user joins a channel by sending a MIX "join" command from one of the user's clients, which will be relayed to the server as specified in MIX-PAM. There is no default set of nodes, so the user MUST specify the set of nodes to be subscribed to. To achieve the equivalent service to MUC, a user would subscribe to both messages and presence nodes. A user will typically subscribe to at least the message and/or presence nodes but MAY join and not subscribe to any nodes. Note that the presence node is specified in MIX-PRESENCE. The &lt;join/&gt; is a child element of &lt;iq/&gt; element. The &lt;join/&gt; element is qualified by the 'urn:xmpp:mix:core:1' namespace. The requested nodes are encoded as &lt;subscribe/&gt; child elements of the &lt;join/&gt; element. A nick MAY be specified as a &lt;nick/&gt; child elements of the &lt;join/&gt; element. </p>
<p>The join leads to the server subscribing the user to each of the requested nodes associated with the channel. The MIX service will also add the user to the participant list by injecting a new item into the "urn:xmpp:mix:nodes:participants" node automatically.</p> <p>The join leads to the server subscribing the user to each of the requested nodes associated with the channel. The MIX service will also add the user to the participant list by injecting a new item into the "urn:xmpp:mix:nodes:participants" node automatically.</p>
<p>The default MIX model is that only channel participants are allowed to subscribe to nodes. A MIX channel MAY allow non-participant subscription to some nodes. This will be handled by clients directly subscribing to the desired PubSub nodes.</p> <p>The default MIX model is that only channel participants are allowed to subscribe to nodes. A MIX channel MAY allow non-participant subscription to some nodes. This will be handled by clients directly subscribing to the desired PubSub nodes.</p>
<p>The user's server needs to make roster changes as part of the join functionality, as specified in MIX-PAM. This means that the join request to the MIX service will come from the user's server from the user's bare JID.</p> <p>The user's server needs to make roster changes as part of the join functionality, as specified in MIX-PAM. This means that the join request to the MIX service will come from the user's server from the user's bare JID.</p>
@ -997,7 +998,7 @@
from='hag66@shakespeare.example' from='hag66@shakespeare.example'
to='coven@mix.shakespeare.example' to='coven@mix.shakespeare.example'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<join xmlns='urn:xmpp:mix:core:0'> <join xmlns='urn:xmpp:mix:core:1'>
<subscribe node='urn:xmpp:mix:nodes:messages'/> <subscribe node='urn:xmpp:mix:nodes:messages'/>
<subscribe node='urn:xmpp:mix:nodes:presence'/> <subscribe node='urn:xmpp:mix:nodes:presence'/>
<subscribe node='urn:xmpp:mix:nodes:participants'/> <subscribe node='urn:xmpp:mix:nodes:participants'/>
@ -1014,7 +1015,7 @@
from='coven@mix.shakespeare.example' from='coven@mix.shakespeare.example'
to='hag66@shakespeare.example' to='hag66@shakespeare.example'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<join xmlns='urn:xmpp:mix:core:0' <join xmlns='urn:xmpp:mix:core:1'
id='123456'> id='123456'>
<subscribe node='urn:xmpp:mix:nodes:messages'/> <subscribe node='urn:xmpp:mix:nodes:messages'/>
<subscribe node='urn:xmpp:mix:nodes:presence'/> <subscribe node='urn:xmpp:mix:nodes:presence'/>
@ -1036,7 +1037,7 @@
from='hag66@shakespeare.example' from='hag66@shakespeare.example'
to='coven@mix.shakespeare.example' to='coven@mix.shakespeare.example'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<join xmlns='urn:xmpp:mix:core:0' <join xmlns='urn:xmpp:mix:core:1'
id='123456'> id='123456'>
<subscribe node='urn:xmpp:mix:nodes:messages'/> <subscribe node='urn:xmpp:mix:nodes:messages'/>
<subscribe node='urn:xmpp:mix:nodes:participants'/> <subscribe node='urn:xmpp:mix:nodes:participants'/>
@ -1055,7 +1056,7 @@
<event xmlns='http://jabber.org/protocol/pubsub#event'> <event xmlns='http://jabber.org/protocol/pubsub#event'>
<items node='urn:xmpp:mix:nodes:participants'> <items node='urn:xmpp:mix:nodes:participants'>
<item id='123456'> <item id='123456'>
<participant xmlns='urn:xmpp:mix:core:0'> <participant xmlns='urn:xmpp:mix:core:1'>
<jid>hag66@shakespeare.example</jid> <jid>hag66@shakespeare.example</jid>
<nick>third witch</nick> <nick>third witch</nick>
</participant> </participant>
@ -1068,14 +1069,14 @@
</p> </p>
<p> <p>
A user MAY subsequently modify subscription to nodes in a channel by sending a subscription modification request encoded as a &lt;update-subscription/&gt; child element of &lt;iq/&gt; element. The &lt;update-subscription/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace. The requested notes are encoded as &lt;subscribe/&gt; child elements of the &lt;update-subscription/&gt; element with the node name encoded as a 'node' attribute. This modification goes directly from client to MIX channel, as this change does not impact the roster and so does not need any local action. The following example shows subscription modification. A user MAY subsequently modify subscription to nodes in a channel by sending a subscription modification request encoded as a &lt;update-subscription/&gt; child element of &lt;iq/&gt; element. The &lt;update-subscription/&gt; element is qualified by the 'urn:xmpp:mix:core:1' namespace. The requested notes are encoded as &lt;subscribe/&gt; child elements of the &lt;update-subscription/&gt; element with the node name encoded as a 'node' attribute. This modification goes directly from client to MIX channel, as this change does not impact the roster and so does not need any local action. The following example shows subscription modification.
</p> </p>
<example caption="User Modifies Subscription Request"><![CDATA[ <example caption="User Modifies Subscription Request"><![CDATA[
<iq type='set' <iq type='set'
from='hag66@shakespeare.example/UUID-a1j/7533' from='hag66@shakespeare.example/UUID-a1j/7533'
to='coven@mix.shakespeare.example' to='coven@mix.shakespeare.example'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<update-subscription xmlns='urn:xmpp:mix:core:0'> <update-subscription xmlns='urn:xmpp:mix:core:1'>
<subscribe node='urn:xmpp:mix:nodes:messages'/> <subscribe node='urn:xmpp:mix:nodes:messages'/>
</update-subscription> </update-subscription>
</iq> </iq>
@ -1084,7 +1085,7 @@
from='coven@mix.shakespeare.example' from='coven@mix.shakespeare.example'
to='hag66@shakespeare.example/UUID-a1j/7533' to='hag66@shakespeare.example/UUID-a1j/7533'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<update-subscription xmlns='urn:xmpp:mix:core:0' <update-subscription xmlns='urn:xmpp:mix:core:1'
jid='hag66@shakespeare.example'> jid='hag66@shakespeare.example'>
<subscribe node='urn:xmpp:mix:nodes:messages'/> <subscribe node='urn:xmpp:mix:nodes:messages'/>
</update-subscription> </update-subscription>
@ -1095,13 +1096,13 @@
</p> </p>
</section3> </section3>
<section3 topic='Leaving a Channel' anchor='usecase-user-leaving'> <section3 topic='Leaving a Channel' anchor='usecase-user-leaving'>
<p>Users generally remain in a channel for an extended period of time. In particular the user remains as a participant the channel when the user goes offline. Note that this is different to &xep0045;, where the client leaves a room when going offline. So, leaving a MIX channel is a permanent action for a user across all clients. In order to leave a channel, the user's server sends a MIX "leave" command to the channel, as specified in MIX-PAM. The leave command is encoded as a &lt;leave/&gt; child element of &lt;iq/&gt; element. The &lt;leave/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace. The following example shows a leave request to a MIX channel. </p> <p>Users generally remain in a channel for an extended period of time. In particular the user remains as a participant the channel when the user goes offline. Note that this is different to &xep0045;, where the client leaves a room when going offline. So, leaving a MIX channel is a permanent action for a user across all clients. In order to leave a channel, the user's server sends a MIX "leave" command to the channel, as specified in MIX-PAM. The leave command is encoded as a &lt;leave/&gt; child element of &lt;iq/&gt; element. The &lt;leave/&gt; element is qualified by the 'urn:xmpp:mix:core:1' namespace. The following example shows a leave request to a MIX channel. </p>
<example caption="User's Server sends Leave Request to a Channel"><![CDATA[ <example caption="User's Server sends Leave Request to a Channel"><![CDATA[
<iq type='set' <iq type='set'
from='hag66@shakespeare.example' from='hag66@shakespeare.example'
to='coven@mix.shakespeare.example' to='coven@mix.shakespeare.example'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<leave xmlns='urn:xmpp:mix:core:0'/> <leave xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
]]></example> ]]></example>
@ -1113,7 +1114,7 @@
from='coven@mix.shakespeare.example' from='coven@mix.shakespeare.example'
to='hag66@shakespeare.example' to='hag66@shakespeare.example'
id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'> id='E6E10350-76CF-40C6-B91B-1EA08C332FC7'>
<leave xmlns='urn:xmpp:mix:core:0'/> <leave xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
]]></example> ]]></example>
<p>When the user leaves the channel, the MIX service is responsible for unsubscribing the user from all nodes in the channel and for removing the user from the participants list. Presence removal is specified in MIX-PRESENCE. <p>When the user leaves the channel, the MIX service is responsible for unsubscribing the user from all nodes in the channel and for removing the user from the participants list. Presence removal is specified in MIX-PRESENCE.
@ -1145,14 +1146,14 @@
<li>The MIX service generates the nick. </li> <li>The MIX service generates the nick. </li>
</ol> </ol>
<p> <p>
A user will typically set a nick when joining a channel and MAY update this nick from time to time. The user does this by sending a command to the channel to set the nick. This command is a &lt;setnick/&gt; child element of &lt;iq/&gt; element. The &lt;setnick/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace. The nick is encoded as a &lt;nick/&gt; child element of the &lt;setnick/&gt; element. If the user wishes the channel to assign a nick (or knows that the channel will assign a nick) the nick field can be left blank, so that the user can see what is assigned in the result. A user will typically set a nick when joining a channel and MAY update this nick from time to time. The user does this by sending a command to the channel to set the nick. This command is a &lt;setnick/&gt; child element of &lt;iq/&gt; element. The &lt;setnick/&gt; element is qualified by the 'urn:xmpp:mix:core:1' namespace. The nick is encoded as a &lt;nick/&gt; child element of the &lt;setnick/&gt; element. If the user wishes the channel to assign a nick (or knows that the channel will assign a nick) the nick field can be left blank, so that the user can see what is assigned in the result.
</p> </p>
<example caption="User sets Nick on Channel"><![CDATA[ <example caption="User sets Nick on Channel"><![CDATA[
<iq type='set' <iq type='set'
from='hag66@shakespeare.example/UUID-a1j/7533' from='hag66@shakespeare.example/UUID-a1j/7533'
to='coven@mix.shakespeare.example' to='coven@mix.shakespeare.example'
id='7nve413p'> id='7nve413p'>
<setnick xmlns='urn:xmpp:mix:core:0'> <setnick xmlns='urn:xmpp:mix:core:1'>
<nick>thirdwitch</nick> <nick>thirdwitch</nick>
</setnick> </setnick>
</iq> </iq>
@ -1166,7 +1167,7 @@
from='coven@mix.shakespeare.example' from='coven@mix.shakespeare.example'
to'hag66@shakespeare.example/UUID-a1j/7533' to'hag66@shakespeare.example/UUID-a1j/7533'
id='7nve413p'> id='7nve413p'>
<setnick xmlns='urn:xmpp:mix:core:0'> <setnick xmlns='urn:xmpp:mix:core:1'>
<nick>thirdwitch</nick> <nick>thirdwitch</nick>
</setnick> </setnick>
</iq> </iq>
@ -1197,7 +1198,7 @@
</message> </message>
]]></example> ]]></example>
<p> <p>
The MIX channel then adds information to the message using a &lt;mix&gt; element qualified by the 'urn:xmpp:mix:core:0' namespace. This enables are receiver of the MIX message to determine the message sender. This element contains two child elements: The MIX channel then adds information to the message using a &lt;mix&gt; element qualified by the 'urn:xmpp:mix:core:1' namespace. This enables are receiver of the MIX message to determine the message sender. This element contains two child elements:
</p> </p>
<ol> <ol>
<li>A &lt;nick&gt; element that contains the Nick of the message sender, taken from the Participants Node. This MUST be present if a Nick is defined for the user.</li> <li>A &lt;nick&gt; element that contains the Nick of the message sender, taken from the Participants Node. This MUST be present if a Nick is defined for the user.</li>
@ -1215,7 +1216,7 @@
id='77E07BB0-55CF-4BD4-890E-3F7C0E686BBD' id='77E07BB0-55CF-4BD4-890E-3F7C0E686BBD'
type='groupchat'> type='groupchat'>
<body>Harpier cries: 'tis time, 'tis time.</body> <body>Harpier cries: 'tis time, 'tis time.</body>
<mix xmlns='urn:xmpp:mix:core:0'> <mix xmlns='urn:xmpp:mix:core:1'>
<nick>thirdwitch</nick> <nick>thirdwitch</nick>
<jid>hag66@shakespeare.example</jid> <jid>hag66@shakespeare.example</jid>
</mix> </mix>
@ -1228,7 +1229,7 @@
id='77E07BB0-55CF-4BD4-890E-3F7C0E686BBD' id='77E07BB0-55CF-4BD4-890E-3F7C0E686BBD'
type='groupchat'> type='groupchat'>
<body>Harpier cries: 'tis time, 'tis time.</body> <body>Harpier cries: 'tis time, 'tis time.</body>
<mix xmlns='urn:xmpp:mix:core:0'> <mix xmlns='urn:xmpp:mix:core:1'>
<nick>thirdwitch</nick> <nick>thirdwitch</nick>
<jid>hag66@shakespeare.example</jid> <jid>hag66@shakespeare.example</jid>
</mix> </mix>
@ -1274,7 +1275,7 @@
<section3 topic='Checking For Permission To Create a Channel' anchor='usecase-admin-check-create'> <section3 topic='Checking For Permission To Create a Channel' anchor='usecase-admin-check-create'>
<p> <p>
MIX does not standardize an access control model for creating and deleting MIX channels. The choice is left to the MIX implementer, and could be a very simple or complex approach. A client can determine if it has permission to create a channel on a MIX service, which MAY be used to control options presented to the user. This is achieved by a disco command on the MIX service. If the 'urn:xmpp:mix:core:0#create-channel' feature is returned, the user is able to create a channel. MIX does not standardize an access control model for creating and deleting MIX channels. The choice is left to the MIX implementer, and could be a very simple or complex approach. A client can determine if it has permission to create a channel on a MIX service, which MAY be used to control options presented to the user. This is achieved by a disco command on the MIX service. If the 'urn:xmpp:mix:core:1#create-channel' feature is returned, the user is able to create a channel.
</p> </p>
<example caption="Client determines Capability to Create a Channel" ><![CDATA[ <example caption="Client determines Capability to Create a Channel" ><![CDATA[
<iq from='hag66@shakespeare.example/UUID-c8y/1573' <iq from='hag66@shakespeare.example/UUID-c8y/1573'
@ -1293,29 +1294,29 @@
category='conference' category='conference'
name='Shakespearean Chat Service' name='Shakespearean Chat Service'
type='mix'/> type='mix'/>
<feature var='urn:xmpp:mix:core:0'/> <feature var='urn:xmpp:mix:core:1'/>
<feature var='urn:xmpp:mix:core:0#create-channel'> <feature var='urn:xmpp:mix:core:1#create-channel'>
</query> </query>
</iq> </iq>
]]></example> ]]></example>
</section3> </section3>
<section3 topic='Creating a Channel' anchor='usecase-admin-create'> <section3 topic='Creating a Channel' anchor='usecase-admin-create'>
<p> <p>
A client creates a channel by sending a simple request to the MIX service. A channel is always created with default parameters, as shown in the following example. The result MUST include the name of the channel which MUST match the channel name in the request (if present). The create is encoded as a &lt;create/&gt; child element of &lt;iq/&gt; element. The &lt;create/&gt; is qualified by the 'urn:xmpp:mix:core:0' namespace. The &lt;create/&gt; element MUST have a 'channel' attribute to specify the channel name. This attribute specifies the value that will be used in the LHS of the JID for the MIX channel. A client creates a channel by sending a simple request to the MIX service. A channel is always created with default parameters, as shown in the following example. The result MUST include the name of the channel which MUST match the channel name in the request (if present). The create is encoded as a &lt;create/&gt; child element of &lt;iq/&gt; element. The &lt;create/&gt; is qualified by the 'urn:xmpp:mix:core:1' namespace. The &lt;create/&gt; element MUST have a 'channel' attribute to specify the channel name. This attribute specifies the value that will be used in the LHS of the JID for the MIX channel.
</p> </p>
<example caption="Creating a Channel with Default Parameters" ><![CDATA[ <example caption="Creating a Channel with Default Parameters" ><![CDATA[
<iq from='hag66@shakespeare.example/UUID-a1j/7533' <iq from='hag66@shakespeare.example/UUID-a1j/7533'
id='lx09df27' id='lx09df27'
to='mix.shakespeare.example' to='mix.shakespeare.example'
type='set'> type='set'>
<create channel='coven' xmlns='urn:xmpp:mix:core:0'/> <create channel='coven' xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
<iq from='mix.shakespeare.example' <iq from='mix.shakespeare.example'
id='lx09df27' id='lx09df27'
to='hag66@shakespeare.example/UUID-a1j/7533' to='hag66@shakespeare.example/UUID-a1j/7533'
type='result'> type='result'>
<create channel='coven' xmlns='urn:xmpp:mix:core:0'/> <create channel='coven' xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
]]></example> ]]></example>
@ -1335,14 +1336,14 @@
id='lx09df27' id='lx09df27'
to='mix.shakespeare.example' to='mix.shakespeare.example'
type='set'> type='set'>
<create xmlns='urn:xmpp:mix:core:0'/> <create xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
<iq from='mix.shakespeare.example' <iq from='mix.shakespeare.example'
id='lx09df27' id='lx09df27'
to='hag66@shakespeare.example/UUID-a1j/7533' to='hag66@shakespeare.example/UUID-a1j/7533'
type='result'> type='result'>
<create channel='A1B2C345' xmlns='urn:xmpp:mix:core:0'/> <create channel='A1B2C345' xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
]]></example> ]]></example>
</section3> </section3>
@ -1353,7 +1354,7 @@
MIX channels are always explicitly destroyed by an owner of the channel or by a server operator. There is no concept of temporary channel, equivalent to &xep0045; temporary room which is automatically destroyed by the server when the users leave. However, channels MAY be configured with an explicit lifetime, after which the channel MUST be removed by the MIX service; This is specified in MIX-ADMIN. Where a channel is created for ad hoc use, it MAY be desirable to keep the channel for history reference or for re-use by the same set of users. Note that the owner of the channel does not need to have presence registered in the channel in order to destroy it. MIX channels are always explicitly destroyed by an owner of the channel or by a server operator. There is no concept of temporary channel, equivalent to &xep0045; temporary room which is automatically destroyed by the server when the users leave. However, channels MAY be configured with an explicit lifetime, after which the channel MUST be removed by the MIX service; This is specified in MIX-ADMIN. Where a channel is created for ad hoc use, it MAY be desirable to keep the channel for history reference or for re-use by the same set of users. Note that the owner of the channel does not need to have presence registered in the channel in order to destroy it.
</p> </p>
<p> <p>
The destroy operation is encoded as a &lt;destroy/&gt; child element of an &lt;iq/&gt; element. The &lt;destroy/&gt; element is qualified by the 'urn:xmpp:mix:core:0' namespace. The &lt;destroy/&gt; element MUST have a 'channel' attribute to specify the channel to be destroyed. The destroy operation is encoded as a &lt;destroy/&gt; child element of an &lt;iq/&gt; element. The &lt;destroy/&gt; element is qualified by the 'urn:xmpp:mix:core:1' namespace. The &lt;destroy/&gt; element MUST have a 'channel' attribute to specify the channel to be destroyed.
A client destroys a channel using a simple set operation, as shown in the following example. A client destroys a channel using a simple set operation, as shown in the following example.
</p> </p>
<example caption="Client Destroys a Channel" ><![CDATA[ <example caption="Client Destroys a Channel" ><![CDATA[
@ -1361,7 +1362,7 @@
id='lx09df27' id='lx09df27'
to='mix.shakespeare.example' to='mix.shakespeare.example'
type='set'> type='set'>
<destroy channel='coven' xmlns='urn:xmpp:mix:core:0'/> <destroy channel='coven' xmlns='urn:xmpp:mix:core:1'/>
</iq> </iq>
<iq from='mix.shakespeare.example' <iq from='mix.shakespeare.example'