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

Revision 2187, 10.0 KB checked in by pablo, 13 months ago (diff)

Doc tweaks
Line 
1<!doctype html>
2<html>
3<head>
4<title>Supported Media Formats</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; box-shadow: 0 0 5px #999; margin: 0 10px; }
12    pre { font-size: 12px; background: #E5F3C8; padding:5px 10px; border: 1px solid #D3EAA4; }
13    dd { color: #333; font-style: italic; }
14    table { width: 100%; border-collapse: collapse; margin: 20px 0; }
15    tr { border-bottom: 1px solid #CCC; } 
16    tr:nth-child(even) { background: #EEE; }
17    td,th { padding: 5px; font-size: 12px; text-align: left; }
18
19</style>
20</head><body>
21
22<h1>Supported Media Formats</h1>
23
24<p>This guide lists all media formats JW Player officially supports.</p>
25
26<h2>Introduction</h2>
27
28<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>), 2 streaming protocols (<em>HLS</em>, <em>RTMP</em>) and <em>YouTube</em> (through their Chromeless Player API). 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>
29
30<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>
31
32<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 <em>type</em> 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>
33
34<h2>Video Files</h2>
35
36<p>JW Player supports three types of video files:</p>
37
38<ul>
39<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 is can be played in all browsers and devices. It is today's video format of choice.</li>
40<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>
41<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>
42</ul>
43
44<p>Here is an overview of the recognized file extensions for these formats, plus their browser playback support:</p>
45
46<table><tr>
47    <th></th><th>mp4</th><th>flv</th><th>webm</th>
48</tr><tr>
49    <th>Extension(s)</th><td>.mp4, .m4v, .f4v</td><td>.flv</td><td>.webm</td>
50</tr><tr>
51    <th></th><td></td><td></td><td></td>
52</tr><tr>
53    <th>Internet Explorer</th><td>html5, flash <sup>1</sup></td><td>flash</td><td>-</td>
54</tr><tr>
55    <th>Chrome</th><td>html5, flash</td><td>flash</td><td>html5</td>
56</tr><tr>
57    <th>Firefox</th><td>flash</td><td>flash</td><td>html5</td>
58</tr><tr>
59    <th>Safari</th><td>html5, flash</td><td>flash</td><td>-</td>
60</tr><tr>
61    <th>iOS</th><td>html5</td><td>-</td><td>-</td>
62</tr><tr>
63    <th>Android</th><td>html5, flash <sup>2</sup></td><td>flash <sup>2</sup></td><td>html5 <sup>3</sup></td>
64</tr><tr>
65    <th>Opera</th><td>flash</td><td>flash</td><td>html5</td>
66</tr></table>
67
68<ol>
69    <li>HTML5 playback as of Internet Explorer 9.</li>
70    <li>Not all Android devices have Flash installed.</li>
71    <li>WebM support as of Android 4.</li>
72</ol>
73
74<p>Note the H.264 video codec supports different <em>profiles</em>; different levels of encoding sophistication. The <strong>Baseline</strong> profile is supported by all devices (older Androids and iPhone 2G/3G), while the <strong>Main</strong> profile is only supported by recent devices. The <strong>High</strong> profile has even less support and only adds efficiency for 1080p quality or higher.</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, either as raw data or inside an MP4 container. 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, as raw data. 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 inside an Ogg container. 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 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></th><td></td><td></td><td></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, flash <sup>2</sup></td><td>html5, flash <sup>2</sup></td><td>html5 <sup>3</sup></td>
107</tr><tr>
108    <th>Opera</th><td>flash</td><td>flash</td><td>html5</td>
109</tr></table>
110
111<ol>
112    <li>HTML5 playback as of Internet Explorer 9.</li>
113    <li>Not all Android devices have Flash installed.</li>
114    <li>Ogg Vorbis support as of Android 4.</li>
115</ol>
116
117
118<h2>Streaming Protocols</h2>
119
120<p>JW Player supports two types of streaming protocols:</p>
121
122<ul>
123<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. See <a href="#">Using HLS Streaming</a> for more info.</li>
124<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 requires dedicated server software and is sometimes blocked by firewalls. It is mature and has broad CDN and encoder support. See <a href="#">Using RTMP Streaming</a> for more info.</li>
125</ul>
126
127<p>Here is an overview of the recognized file extensions for these protocols, plus their browser playback support:</p>
128
129<table><tr>
130    <th></th><th>hls</th><th>rtmp</th>
131</tr><tr>
132    <th>Extension(s)</th><td>.m3u8</td><td>.smil</td>
133</tr><tr>
134    <th></th><td></td><td></td>
135</tr><tr>
136    <th>Internet Explorer</th><td>flash <sup>1</sup></td><td>flash</td>
137</tr><tr>
138    <th>Chrome</th><td>flash <sup>1</sup></td><td>flash</td>
139</tr><tr>
140    <th>Firefox</th><td>flash <sup>1</sup></td><td>flash</td>
141</tr><tr>
142    <th>Safari</th><td>html5, flash <sup>1</sup></td><td>flash</td>
143</tr><tr>
144    <th>iOS</th><td>html5</td><td>-</td>
145</tr><tr>
146    <th>Android</th><td>html5 <sup>2</sup></td><td>flash <sup>3</sup></td>
147</tr><tr>
148    <th>Opera</th><td>flash <sup>1</sup></td><td>flash</td>
149</tr></table>
150
151<ol>
152    <li>HLS playback requires Flash Player 10.1, which <a href="http://riastats.com/">is not yet ubiquitous</a>.</li>
153    <li>HLS support as of Android 4.</li>
154    <li>Not all Android devices have Flash installed.</li>
155</ol>
156
157
158<h2>YouTube API</h2>
159
160<p>In addition to self-hosted audio, video and streaming formats, JW Player includes native support for playing
161YouTube 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>
162
163<ul>
164    <li><a href="http://www.youtube.com/watch?v=ylLzyHk54Z0">http://www.youtube.com/watch?v=ylLzyHk54Z0</a></li>
165    <li><a href="http://www.youtube.com/watch#!v=ylLzyHk54Z0">http://www.youtube.com/watch#!v=ylLzyHk54Z0</a></li>
166    <li><a href="http://www.youtube.com/v/ylLzyHk54Z0">http://www.youtube.com/v/ylLzyHk54Z0</a></li>
167    <li><a href="http://youtu.be/ylLzyHk54Z0">http://youtu.be/ylLzyHk54Z0</a></li>
168</ul>
169
170<p>The YouTube API requires the Flash plugin at present. Therefore, it is supported only on desktop browsers and Android devices running Flash. On iOS, 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 iOS support in the future.</p>
171
172<p>Some additional notes on YouTube support:</p>
173
174<ul>
175<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>
176<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>
177<li>YouTube videos are always available in multiple qualities, which means the JW Player's quality selector is automatically displayed in the controlbar.</li>
178</ul>
179
180
181</body>
182</html>
Note: See TracBrowser for help on using the repository browser.