moparisthebest
/
xeps
mirror of https://github.com/moparisthebest/xeps
1
0
Fork 0
Code Issues Releases Wiki Activity

1.2pre1 

git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@1596 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2008-01-23 19:24:53 +00:00
parent b31e3475c4
commit 1260fbf5be
1 changed files with 25 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
xep-0118.xml
View File

@ -7,7 +7,7 @@
<xep>
<header>
<title>User Tune</title>
<abstract>This specification defines a payload format for communicating information about music to which a user is listening, including the title, track number, collection, performer, composer, and length. The payload format is typically transported using the personal eventing profile of XMPP publish-subscribe as specified in XEP-0163.</abstract>
<abstract>This specification defines a payload format for communicating information about music to which a user is listening, including the title, track number, collection, performer, composer, length, and user rating. The payload format is typically transported using the personal eventing profile of XMPP publish-subscribe as specified in XEP-0163.</abstract>
&LEGALNOTICE;
<number>0118</number>
<status>Draft</status>
@ -24,6 +24,12 @@
<url>http://www.xmpp.org/schemas/tune.xsd</url>
</schemaloc>
&stpeter;
<revision>
<version>1.2pre1</version>
<date>2008-01-23</date>
<initials>psa</initials>
<remark><p>Added rating element.</p></remark>
</revision>
<revision>
<version>1.1</version>
<date>2007-06-04</date>
@ -122,6 +128,12 @@
<td>686</td>
<td>xs:unsignedShort</td>
</tr>
<tr>
<td>rating</td>
<td>The user's rating of the song or piece, from 1 (lowest) to 10 (highest).</td>
<td>9</td>
<td>xs:positiveInteger</td>
</tr>
<tr>
<td>source</td>
<td>The collection (e.g., album) or other source (e.g., a band website that hosts streams or audio files)</td>
@ -161,6 +173,7 @@
<tune xmlns='http://jabber.org/protocol/tune'>
<artist>Yes</artist>
<length>686</length>
<rating>9</rating>
<source>Yessongs</source>
<title>Heart of the Sunrise</title>
<track>3</track>
@ -182,6 +195,7 @@
<tune xmlns='http://jabber.org/protocol/tune'>
<artist>Yes</artist>
<length>686</length>
<rating>9</rating>
<source>Yessongs</source>
<title>Heart of the Sunrise</title>
<track>3</track>
@ -232,9 +246,10 @@
<section1 topic='Implementation Notes' anchor='impl'>
<p>To prevent a large number of updates when a user is skipping through tracks, an implementation SHOULD wait several seconds before publishing new tune information.</p>
<p>If the length is unknown (e.g., the user is listening to a stream), the &lt;length/&gt; element SHOULD NOT be included.</p>
<p>A typical interface for user ratings is to show one to five star icons such as &#9734;&#9734;&#9734;&#9734;&#9734;. If this interface is used, the numbers 2, 4, 6, 8, and 10 should be mapped to one, two, three, four, and five stars respectively, and odd numbers should be mapped to half stars (e.g., the number 9 would be mapped to four-and-a-half stars).</p>
</section1>
<section1 topic='Security Considerations' anchor='security'>
<p>This protocol introduces no security considerations above and beyond those defined in <cite>Publish-Subscribe</cite> (XEP-0060).</p>
<p>The publication of user tune information is not known to introduce any new security considerations above and beyond those defined in <cite>XEP-0060: Publish-Subscribe</cite>.</p>
</section1>
<section1 topic='IANA Considerations' anchor='iana'>
<p>This document requires no interaction with &IANA;.</p>
@ -266,6 +281,14 @@
<xs:sequence minOccurs='0'>
<xs:element name='artist' type='xs:string' minOccurs='0'/>
<xs:element name='length' type='xs:unsignedShort' minOccurs='0'/>
<xs:element name='rating' type='xs:positiveInteger' minOccurs='0'/>
<xs:element name="rating">
<xs:simpleType>
<xs:restriction base='xs:positiveInteger'>
<xs:maxInclusive value='10'/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name='source' type='xs:string' minOccurs='0'/>
<xs:element name='title' type='xs:string' minOccurs='0'/>
<xs:element name='track' type='xs:string' minOccurs='0'/>