Jaxel
Well-known member
Guide on how to set up a Local Soundtrack (premium expansion required). Soundtrack playlists are stored in an mRSS formatted XML file; this file should be located in your "/data/local/" folder. When you submit your soundtrack to your media library, you will use the following format: "local:soundtrack.xml", where "soundtrack.xml" is the name of your playlist file found in "/data/local/". This XML file follows a specific format...
As you can see, there are various elements in this XML file. All elements are contained within <rss><channel>. Anything outside of these enclosures will be ignored. The example above shows all information that is readable by the media library. There are additional tags that you can input which will be read by the JW Player, which are outlined here; I will not be going into any of these tags (except jwplayer: provider) as they are separate from the library.
These are all text fields, if you want to put in non-latin characters, you must wrap your text in a "<![CDATA[ ]]>" enclosure.
<rss><channel><title> REQUIRED
<rss><channel><image> REQUIRED
<rss><channel><item> REQUIRED
Thats it! Simple?
Code:
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
xmlns:jwplayer="http://developer.longtailvideo.com/trac/">
<channel>
<title>Soundtrack Example</title>
<image>music/album.jpg</image>
<item>
<title>01 Track 1</title>
<media:content url="music/track1.mp3" duration="60" />
<media:thumbnail url="music/track1.jpg" />
</item>
<item>
<title>02 Track 2</title>
<media:content url="music/track2.mp3" duration="90" />
<media:thumbnail url="music/track2.jpg" />
</item>
<item>
<title>03 Track 3</title>
<media:content url="music/track3.mp3" duration="75" />
<media:thumbnail url="music/track3.jpg" />
</item>
</channel>
</rss>As you can see, there are various elements in this XML file. All elements are contained within <rss><channel>. Anything outside of these enclosures will be ignored. The example above shows all information that is readable by the media library. There are additional tags that you can input which will be read by the JW Player, which are outlined here; I will not be going into any of these tags (except jwplayer: provider) as they are separate from the library.
These are all text fields, if you want to put in non-latin characters, you must wrap your text in a "<![CDATA[ ]]>" enclosure.
<rss><channel><title> REQUIRED
This is the title of your playlist. The media library will read this entry and set it as your title and description. This is an absolutely required field; without it, your submission will break.
<rss><channel><image> REQUIRED
This is the art for your playlist. This item will be used to create thumbnail in the media library. A thumbnail is always required; if this tag is missing the system will try to retrieve the thumbnail from the first item in your playlist. At least one image is required.
<rss><channel><item> REQUIRED
This is an actual playlist entry. You can have as many items in your playlist as you want. Each item has additional required details so that the system knows how to handle it.
<item><title> REQUIRED
The title of your track. This name will be displayed on the actual flash object.
<item><media:content> REQUIRED
Content information about your media track...
url REQUIRED
This is the URL to your actual media file. It doesn't even necessarily have to be an MP3, it can be any compatible flash based video file.
duration OPTIONAL
The duration of your track. This is not required, but if you want the system to calculate the total length of your playlist, as well as display content lengths in the actual flash object, you should include this.
<item><media:thumbnail> OPTIONAL
Thumbnail information about your media track...
url REQUIRED
This is the URL to the thumbnail for your media file. The thumbnail will appear on the track list in the flash object. As well, if the media you are playing does not have a video feed (such as an MP3), this thumbnail will be displayed in the viewer.
<item><jwplayer:provider> OPTIONAL
By design JW Player only supports locally hosted files. However, if you have your media on a different server (such as a CDN), you must enable HTTP Pseudo-Streaming. Just add the following to an item if it's hosted on a different server:
<jwplayer:provider>http</jwplayer:provider>
Thats it! Simple?
