moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-12-22 07:38:52 -05:00
Code Issues Releases Wiki Activity

a bit more disco

Browse Source
This commit is contained in:
Peter Saint-Andre 2015-10-12 21:33:20 -06:00 committed by Kevin Smith
parent 21793cd1d3
commit 53359622db
1 changed files with 60 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
inbox/mix.xml
View File

@ -132,37 +132,75 @@
</field>
<field var='urn:xmpp:mix:nodes:muc_mirror'
label='Location of MUC mirror service'>
<value>mix.shakespeare.example</value>
<value>chat.shakespeare.example</value>
</field>
</x>
</query>
</iq>
]]></example>
<p>If the MIX service is mirrorred to a MUC service for backwards-compatibility, this SHOULD be signaled by the inclusion of a 'urn:xmpp:mix:nodes:muc_mirror' field, the value of which should be the mirrored MUC domain, in the extended disco results in a form whose type value is 'urn:xmpp:mix:0#serviceinfo'. Note that the MIX service itself doesn't advertise support for &xep0313;, nor is support for generic &xep0060; advertised. For a list of the other standard data form variables, see ### TODO (If there are any).</p>
<p>If the MIX service is mirrored to a MUC service for backwards-compatibility, this SHOULD be signaled by the inclusion of a 'urn:xmpp:mix:nodes:muc_mirror' field, the value of which is the mirrored MUC domain, in the extended disco results in a form whose type value is 'urn:xmpp:mix:0#serviceinfo'. Note that the MIX service itself doesn't advertise support for &xep0313;, nor is support for generic &xep0060; advertised.</p>
</section2>
<section2 topic='Listing conversations on a service' anchor='disco-conversation-list'>
<p>disco#items</p>
<example caption="" ><![CDATA[
]]></example>
<section2 topic='Discovering the Conversations on a Service' anchor='disco-conversation-list'>
<p>There is no need for using Service Discovery here, since the MIX service provides a node "urn:xmpp:mix:nodes:conversations" that pushes out one event for each conversation that has been created at the service.</p>
</section2>
<section2 topic='Discovering conversation information' anchor='disco-conversation-info'>
<p>disco#info</p>
<example caption="" ><![CDATA[
]]></example>
<section2 topic='Discovering Conversation Information' anchor='disco-conversation-info'>
<p>In order to find out more information about a given conversation, a user can send a disco#info query to the conversation.</p>
<example caption='Entity Queries for Information about a Specific Conversation'><![CDATA[
<iq from='hag66@shakespeare.lit/pda'
id='ik3vs715'
to='coven@mix.shakespeare.lit'
type='get'>
<query xmlns='http://jabber.org/protocol/disco#info'/>
</iq>
]]></example>
<p>The conversation MUST return its identity and the features it supports:</p>
<example caption='Conversation Returns Disco Info Result'><![CDATA[
<iq from='coven@mix.shakespeare.lit'
id='ik3vs715'
to='hag66@shakespeare.lit/pda'
type='result'>
<query xmlns='http://jabber.org/protocol/disco#info'>
<identity
category='conference'
name='A Dark Cave'
type='mix'/>
<feature var='urn:xmpp:mix:0'/>
</query>
</iq>
]]></example>
</section2>
<section2 topic='Discovering conversation nodes' anchor='disco-conversation-nodes'>
<p>disco#items. Lets you see which nodes a conversation has ###TODO: Discussion</p>
<example caption="" ><![CDATA[
]]></example>
<section2 topic='Discovering Nodes at a Conversation' anchor='disco-conversation-nodes'>
<p>Use disco#items to find the nodes associated with a conversation.</p>
<example caption='Entity Queries for Nodes at a Conversation'><![CDATA[
<iq from='hag66@shakespeare.lit/pda'
id='kl2fax27'
to='coven@mix.shakespeare.lit'
type='get'>
<query xmlns='http://jabber.org/protocol/disco#items'/>
</iq>
]]></example>
<example caption='Room Returns Disco Items Result'><![CDATA[
<iq from='coven@mix.shakespeare.lit'
id='kl2fax27'
to='hag66@shakespeare.lit/pda'
type='result'>
<query xmlns='http://jabber.org/protocol/disco#items'>
<item jid='coven@mix.shakespeare.example'
node='urn:xmpp:mix:nodes:presence'/>
<item jid='coven@mix.shakespeare.example'
node='urn:xmpp:mix:nodes:participants'/>
<item jid='coven@mix.shakespeare.example'
node='urn:xmpp:mix:nodes:messages'/>
<item jid='coven@mix.shakespeare.example'
node='urn:xmpp:mix:nodes:subject'/>
<item jid='coven@mix.shakespeare.example'
node='urn:xmpp:mix:nodes:config'/>
</query>
</iq>
]]></example>
</section2>
<section2 topic='Discovering conversation participants' anchor='disco-conversation-participants'>
<p>*Not* done with disco#items (which returns nodes), instead query items on the urn:xmpp:mix:nodes:participants node (if you're allowed).</p>
<example caption="" ><![CDATA[
]]></example>
<section2 topic='Discovering Participants in a Conversation' anchor='disco-conversation-participants'>
<p>*Not* done with disco#items (which returns nodes), instead query items on the "urn:xmpp:mix:nodes:participants" node (if you're allowed).</p>
</section2>
</section1>