mirror of https://github.com/moparisthebest/xeps
a bit more disco
This commit is contained in:
Peter Saint-Andre
Kevin Smith
parent
21793cd1d3
commit
53359622db
|
|
@ -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>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue