1
0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-21 16:55:07 -05:00

XEP-0329: Add a wrapper iq around the Jingle session initiation example

This commit is contained in:
Emmanuel Gil Peyrot 2016-08-07 21:49:32 +01:00
parent 88660266b0
commit d767706ab2

View File

@ -166,7 +166,11 @@
<section2 topic='File identification' anchor='file_id'> <section2 topic='File identification' anchor='file_id'>
<p> As it was previously discussed, when requesting detailed information about a file, only the "name" attribute is required, but it is strongly RECOMMENDED that the hash attribute be included, in order to reduce the chances of sending the wrong file. When requesting the file to be transferred using &xep0234;, the information that must be provided has to identify the file uniquely. It is then RECOMMENDED that when requesting a file, the full path of the file in the shared folder be included in the "name" attribute.</p> <p> As it was previously discussed, when requesting detailed information about a file, only the "name" attribute is required, but it is strongly RECOMMENDED that the hash attribute be included, in order to reduce the chances of sending the wrong file. When requesting the file to be transferred using &xep0234;, the information that must be provided has to identify the file uniquely. It is then RECOMMENDED that when requesting a file, the full path of the file in the shared folder be included in the "name" attribute.</p>
<example><![CDATA[ <example><![CDATA[
<jingle xmlns='urn:xmpp:jingle:1' <iq type='get'
from='juliet@capulet.com/chamber'
to='romeo@montague.net/home'
id='1237'>
<jingle xmlns='urn:xmpp:jingle:1'
action='session-initiate' action='session-initiate'
initiator='juliet@capulet.com/chamber' initiator='juliet@capulet.com/chamber'
sid='uj3b2'> sid='uj3b2'>
@ -178,7 +182,8 @@
</file> </file>
</description> </description>
</content> </content>
</jingle>]]></example> </jingle>
</iq>]]></example>
</section2> </section2>
<section2 topic='File Sharing in MUCs' anchor='fis_muc'> <section2 topic='File Sharing in MUCs' anchor='fis_muc'>
<p>For the most part, discovering files in a MUC is exactly the same as what has been described in this document. However, it is RECOMMENDED that a participant in a MUC should have a single shared folder associated with the entire room, as opposed to advertise different files to different participants of the room. This is to reduce the complexity of the client software. Also, due to volatile nature of the participants in a room, keeping track of permissions is more trouble than what it is worth.</p> <p>For the most part, discovering files in a MUC is exactly the same as what has been described in this document. However, it is RECOMMENDED that a participant in a MUC should have a single shared folder associated with the entire room, as opposed to advertise different files to different participants of the room. This is to reduce the complexity of the client software. Also, due to volatile nature of the participants in a room, keeping track of permissions is more trouble than what it is worth.</p>