git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@3631 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2009-11-17 19:22:44 +00:00
parent 57c095ba02
commit 7bd6a6e499
1 changed files with 11 additions and 2 deletions

View File

@ -11,6 +11,7 @@
&LEGALNOTICE;
<number>0166</number>
<status>Draft</status>
<interim/>
<type>Standards Track</type>
<sig>Standards</sig>
<approver>Council</approver>
@ -36,6 +37,12 @@
&robmcqueen;
&seanegan;
&hildjj;
<revision>
<version>1.1rc1</version>
<date>in progress, last updated 2009-11-08</date>
<initials>psa/jjh</initials>
<remark><p>Specified handling of duplicate name attributes on content element; clarified recommended usage of Jingle when exchanging multiple content-types; declared the principle that application types ought not to be mixed beyond necessity within a single session; clarified use of the reason element in cases other than termination.</p></remark>
</revision>
<revision>
<version>1.0</version>
<date>2009-06-10</date>
@ -770,6 +777,7 @@ PENDING o-----------------------+ |
</jingle>
</iq>
]]></example>
<p>Application types ought not to be mixed beyond necessity within a single session. Therefore the session initiation request (along with subsequent additions) will include only content-types that can be grouped together into a coherent session within a given Jingle application. For example, two parties might start an audio call but then add a video aspect to that call. If one of the parties decides to send a file to the other party as a result of discussion over the audio/video session or a text chat conversation, conceptually that is probably a separate session (unless file exchange or screen sharing or some other application type is an integral part of a broader collaboration experience and needs to be calibrated with the audio/video session).</p>
<p>Note: The syntax and semantics of the &DESCRIPTION;, &TRANSPORT;, and &lt;security/&gt; elements are out of scope for this document, since they are defined in related specifications. The syntax and semantics of the &JINGLE; and &CONTENT; elements are specified in this document under <link url='#def'>Formal Definition</link>.</p>
</section2>
<section2 topic='Responder Response' anchor='protocol-response'>
@ -1256,13 +1264,13 @@ PENDING o-----------------------+ |
</tr>
<tr>
<td>name</td>
<td>A unique name or identifier for the content type according to the creator, which MAY have meaning to a human user in order to differentiate this content type from other content types (e.g., two content types containing video media could differentiate between "room-pan" and "slides").</td>
<td>A unique name or identifier for the content type according to the creator, which MAY have meaning to a human user in order to differentiate this content type from other content types (e.g., two content types containing video media could differentiate between "room-pan" and "slides"). If there are two content types with the same value for the 'name' attribute, they shall understood as alternative definitions for the same purpose (e.g., a legacy method and a standards-based method for establishing a voice call), typically to smooth the transition from an older technology to Jingle.</td>
<td>REQUIRED</td>
</tr>
<tr>
<td>senders</td>
<td>Which parties in the session will be generating content; the allowable values are "initiator", "none", "responder", and "both" (where the default is "both").</td>
<td>REQUIRED when sending content-modify; otherwise OPTIONAL</td>
<td>OPTIONAL except when sending content-modify, in which case it is REQUIRED.</td>
</tr>
</table>
</section2>
@ -1273,6 +1281,7 @@ PENDING o-----------------------+ |
<li>The &lt;reason/&gt; element MAY contain a &lt;text/&gt; element that provides human-readable information about the reason for the action.</li>
<li>The &lt;reason/&gt; element MAY contain an element qualified by some other namespace that provides more detailed machine-readable information about the reason for the action.</li>
</ul>
<p>A &lt;reason/&gt; element can be included with any Jingle action, and is not limited to session termination events.</p>
<p>The defined conditions are described in the following table.</p>
<table caption='Defined Conditions'>
<tr>