source: branches/jw6/doc/media.html @ 2315

Revision 2315, 9.3 KB checked in by jeroen, 11 months ago (diff)

updated docs to talk about download and remove HLS support
Line 
1<!doctype html>
2<html>
3<head>
4<title>Media Format Support</title>
5<style>
6    body { padding: 50px 100px; width: 700px; font: 13px/20px Arial; background: #FFF; }
7    a, h1, h2 { color: #369; }
8    h1 { font-size: 32px; }
9    h2 { margin-top: 50px; }
10    h3 { margin-top: 25px; }
11    img { display: block; margin: 0 10px; }
12    pre { font-size: 12px; background: #E5F3C8; padding:5px 10px; border: 1px solid #D3EAA4; }
13    dt { padding-left: 20px; font-weight: bold; }
14    dd { color: #333; font-style: italic; }
15    table { width: 100%; border-collapse: collapse; margin: 20px 0; }
16    tr { border-bottom: 1px solid #CCC; } 
17    tr:nth-child(even) { background: #EEE; }
18    td,th { padding: 5px; font-size: 12px; text-align: left; }
19
20</style>
21</head><body>
22
23<h1>Media Format Support</h1>
24
25<p>This guide lists all media formats JW Player officially supports.</p>
26
27<h2>Introduction</h2>
28
29<p>JW Player supports 9 distinct media formats: 3 video file types (<em>MP4</em>, <em>WebM</em>, <em>FLV</em>), 3 audio file types (<em>AAC</em>, <em>MP3</em>, <em>Vorbis</em>), <em>YouTube</em> videos (through their Chromeless Player API) and 2 streaming protocols (<em>HLS</em>, <em>RTMP</em>). Under certain circumstances, JW Player may play additional formats (like <em>Ogg</em> videos or <em>ShoutCast</em> streams), but only these 9 are cross-browser tested and officially supported.</p>
30
31<p>JW Player does not decode audio or video itself, but instead relies upon two underlying browser technologies: the HTML5 &lt;video&gt; element and the Adobe Flash plugin. Whether a format can play in HTML5 and/or Flash varies by browser. Therefore, we list below in which browsers each format is supported. See <a href="browsers.html">Supported Browsers &amp; Devices</a> for more details.</p>
32
33<p>JW Player tries to recognize a file format by its extension (e.g. <em>.mp4</em> for MP4 videos). If the extension of your files is not recognized, the player will display an error. However, if you know your file is in a supported format, you can use the <strong>type</strong> playlist option to force the player to recognize the file as being of that format. See <a href="playlists.html">Working with Playlists</a> for more info.</p>
34
35<p>When using RSS feeds to load media, the <em>type</em> option must always be set to the <strong>mimetype</strong> of the format. These mimetypes are listed below. See <a href="feeds.html">Loading RSS Feeds</a> for more info.</p>
36
37<h2>Video Files</h2>
38
39<p>JW Player supports three types of video files:</p>
40
41<ul>
42<li><a href="http://en.wikipedia.org/wiki/MP4">MP4</a> videos using the <a href="http://en.wikipedia.org/wiki/H.264">H.264</a> video codec and the <a href="http://en.wikipedia.org/wiki/Advanced_Audio_Coding">AAC</a> audio codec. MP4 is of high quality and can be played in all browsers and devices. It is today's video format of choice.</li>
43<li><a href="http://en.wikipedia.org/wiki/FLV">FLV</a> videos using the <a href="http://en.wikipedia.org/wiki/H.263">H.263</a> video codec and the <a href="http://en.wikipedia.org/wiki/MP3">MP3</a> audio codec. FLV is of lower quality than MP4 and only supported in browsers that run Flash. Many existing video libraries are encoded in FLV.</li>
44<li><a href="http://en.wikipedia.org/wiki/WebM">WebM</a> videos using the <a href="http://en.wikipedia.org/wiki/VP8">VP8</a> video codec and the <a href="http://en.wikipedia.org/wiki/Vorbis">Vorbis</a> audio codec. WebM is royalty free and of comparable quality to MP4. It has limited browser and device support.</li>
45</ul>
46
47<p>Here is an overview of the recognized file extensions and mimetype for these formats, plus their browser playback support:</p>
48
49<table><tr>
50    <th></th><th>mp4</th><th>flv</th><th>webm</th>
51</tr><tr>
52    <th>Extension(s)</th><td>.mp4, .m4v, .f4v</td><td>.flv</td><td>.webm</td>
53</tr><tr>
54    <th>Mimetype</th><td>video/mp4</td><td>video/flv</td><td>video/webm</td>
55</tr><tr>
56    <th>Internet Explorer</th><td>html5, flash <sup>1</sup></td><td>flash</td><td>-</td>
57</tr><tr>
58    <th>Chrome</th><td>html5, flash</td><td>flash</td><td>html5</td>
59</tr><tr>
60    <th>Firefox</th><td>flash</td><td>flash</td><td>html5</td>
61</tr><tr>
62    <th>Safari</th><td>html5, flash</td><td>flash</td><td>-</td>
63</tr><tr>
64    <th>iOS</th><td>html5</td><td>-</td><td>-</td>
65</tr><tr>
66    <th>Android</th><td>html5</td><td>-</td><td>html5 <sup>2</sup></td>
67</tr></table>
68
69<ol>
70    <li>HTML5 playback as of Internet Explorer 9.</li>
71    <li>WebM support as of Android 4.</li>
72</ol>
73
74<p>See <a href="encoding.html">Encoding Web Videos</a> for hints and tools on converting your video library to MP4.</p>
75
76
77<h2>Audio Files</h2>
78
79<p>JW Player supports three types of audio files:</p>
80
81<ul>
82<li><a href="http://en.wikipedia.org/wiki/Advanced_Audio_Coding">AAC</a> audio files. AAC is of high quality and supported by all browsers and devices.</li>
83<li><a href="http://en.wikipedia.org/wiki/MP3">MP3</a> audio files. Though not as good in quality as AAC, MP3 is very widely used. Many existing audio libraries are encoded in MP3.</li>
84<li><a href="http://en.wikipedia.org/wiki/Vorbis">Vorbis</a> audio files. Vorbis is royalty-free, but has limited browser and device support.</li>
85</ul>
86
87<p>Here is an overview of the recognized file extensions and mimetypes for these formats, plus their browser playback support:</p>
88
89<table><tr>
90    <th></th><th>aac</th><th>mp3</th><th>vorbis</th>
91</tr><tr>
92    <th>Extension(s)</th><td>.aac, .m4a, .f4a</td><td>.mp3</td><td>.ogg, .oga</td>
93</tr><tr>
94    <th>Mimetype</th><td>audio/mp4</td><td>audio/mpeg</td><td>audio/ogg</td>
95</tr><tr>
96    <th>Internet Explorer</th><td>html5, flash <sup>1</sup></td><td>html5, flash <sup>1</sup></td><td>-</td>
97</tr><tr>
98    <th>Chrome</th><td>html5, flash</td><td>html5, flash</td><td>html5</td>
99</tr><tr>
100    <th>Firefox</th><td>flash</td><td>flash</td><td>html5</td>
101</tr><tr>
102    <th>Safari</th><td>html5, flash</td><td>html5, flash</td><td>-</td>
103</tr><tr>
104    <th>iOS</th><td>html5</td><td>html5</td><td>-</td>
105</tr><tr>
106    <th>Android</th><td>html5</td><td>html5</td><td>html5 <sup>2</sup></td>
107</tr></table>
108
109<ol>
110    <li>HTML5 playback as of Internet Explorer 9.</li>
111    <li>Ogg Vorbis support as of Android 4.</li>
112</ol>
113
114
115<h2>YouTube API</h2>
116
117<p>In addition to self-hosted audio and video files, JW Player includes native support for playing
118YouTube videos. This possible through built-in support for the <a href="https://developers.google.com/youtube/flash_api_reference">Chromeless Player API</a>. YouTube videos are embedded by linking to their page, using one of the following schemes:</p>
119
120<ul>
121    <li><a href="http://www.youtube.com/watch?v=ylLzyHk54Z0">http://www.youtube.com/watch?v=ylLzyHk54Z0</a></li>
122    <li><a href="http://www.youtube.com/watch#!v=ylLzyHk54Z0">http://www.youtube.com/watch#!v=ylLzyHk54Z0</a></li>
123    <li><a href="http://www.youtube.com/v/ylLzyHk54Z0">http://www.youtube.com/v/ylLzyHk54Z0</a></li>
124    <li><a href="http://youtu.be/ylLzyHk54Z0">http://youtu.be/ylLzyHk54Z0</a></li>
125</ul>
126
127<p>The YouTube API requires the Flash plugin at present. Therefore, it is supported only on desktop browsers. On iOS and Android, limited playback support is available as part of the <a href="browsers.html">Download Fallback</a>. YouTube's experimental <a href="https://developers.google.com/youtube/iframe_api_reference">iFrame API</a> will likely introduce full HTML5 support in the future.</p>
128
129<p>Some additional notes on YouTube support:</p>
130
131<ul>
132<li>YouTube may place ads over the video during playback. These ads can not be disabled. Neither can the YouTube logo in the bottom right corner be removed.</li>
133<li>If the owner of a YouTube video has disabled it for embedding on 3rd party sites, JW Player cannot play the video. An error message is then displayed.</li>
134<li>YouTube videos are mostly available in multiple qualities, which means the JW Player's quality selector is automatically displayed in the controlbar.</li>
135</ul>
136
137
138<h2>Streaming Protocols</h2>
139
140<p>JW Player supports two types of streaming protocols:</p>
141
142<ul>
143<li>Adobe's <a href="http://en.wikipedia.org/wiki/Real_Time_Messaging_Protocol">RTMP</a> protocol, using SMIL manifest files and MP4, FLV, AAC or MP3 media files. RTMP is mature and has broad CDN and encoder support. It requires dedicated server software though, and is sometimes blocked by firewalls. See <a href="rtmp.html">Using RTMP Streaming</a> for more info.</li>
144<li>Apple's <a href="http://en.wikipedia.org/wiki/HTTP_Live_Streaming">HLS</a> protocol, using M3U8 manifest files and TS media files. HLS builds upon standard HTTP, making it easy to deploy and firewall resilient. It is still under development, plus CDN and encoder support is still limited.</li>
145</ul>
146
147<p>Here is an overview of the recognized file extensions and mimetypes for these protocols, plus their browser playback support:</p>
148
149<table><tr>
150    <th></th><th>rtmp</th><th>hls</th>
151</tr><tr>
152    <th>Extension(s)</th><td>.smil</td><td>.m3u8</td>
153</tr><tr>
154    <th>Mimetype</th><td>application/smil</td><td>application/vnd.apple.mpegurl</td>
155</tr><tr>
156    <th>Internet Explorer</th><td>flash</td><td>-</td>
157</tr><tr>
158    <th>Chrome</th><td>flash</td><td>-</td>
159</tr><tr>
160    <th>Firefox</th><td>flash</td><td>-</td>
161</tr><tr>
162    <th>Safari</th><td>flash</td><td>html5</td>
163</tr><tr>
164    <th>iOS</th><td>-</td><td>html5</td>
165</tr><tr>
166    <th>Android</th><td>-</td><td>html5 <sup>1</sup></td>
167</tr></table>
168
169<ol>
170    <li>HLS support as of Android 4.</li>
171</ol>
172
173
174
175</body>
176</html>
Note: See TracBrowser for help on using the repository browser.