mirror of
https://github.com/moparisthebest/xeps
synced 2024-12-25 09:08:52 -05:00
1.2pre1
git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@1596 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
parent
b31e3475c4
commit
1260fbf5be
27
xep-0118.xml
27
xep-0118.xml
@ -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 <length/> element SHOULD NOT be included.</p>
|
||||
<p>A typical interface for user ratings is to show one to five star icons such as ☆☆☆☆☆. 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'/>
|
||||
|
Loading…
Reference in New Issue
Block a user