Ignore:
Timestamp:
04/19/11 09:53:07 (2 years ago)
Author:
jeroen
Message:

updated QM plugin docs for easy copy/paste into Drupal

File:
1 copied

Legend:

Unmodified
Added
Removed

  • plugins/qualitymonitor/v5/doc/reference.html

    r1715 r1756  
    1 Introduction 
    2 ============ 
     1<h2>Purpose</h2> 
    32 
    4 The Qualitymonitor plugin for the JW Player is used to monitor the status of the bitrate switching / dynamic streaming functionalty of the player. This functionality is triggered by loading multiple quality levels of one video into the player. It will then monitor certain quality metrics and play the  optimal stream is served for every viewer. 
    5  
    6 For more info about this functionality, please refer to the dedicated sections in the HTTP resp. RTMP streaming guides: 
    7  
    8 *  `HTTP bitrate switching <http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12534/video-delivery-http-pseudo-streaming#bitrateswitching>`_  
    9 * `RTMP dynamic streaming <http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12535/video-delivery-rtmp-streaming#dynamicstreaming>`_ functionality of the player. 
    10  
    11 Screenshot 
    12 ========== 
    13  
    14 Here's a screenshot of a JW Player with the qualitymonitor plugin: 
    15  
    16  .. image:: ../assets/qualitymonitor.png 
    17     :alt: Skinning examples. 
    18      
    19  
    20 The plugin consists of two sections. The biggest one is the overlay at the top of the video that lists and charts the current quality metrics. Additionally, the plugin contains a small messaging area in the middle of the screen, for printing player messages that relate to the video quality. 
    21  
    22  
    23 Metrics 
    24 ======= 
    25  
    26 The Qualitymonitor plugin monitors the following metrics: 
    27  
    28 * The **bandwidth** of the current connection, in kilobits per second (green). 
    29 * The number of **frames dropped** per second (red). 
    30 * The **width** of the video screen (blue). 
    31 * The currently playing **quality level** (white). The required width and bandwidth of this level is shown between parentheses. 
    32  
    33 Messages 
    34 -------- 
    35  
    36 In addition to these four metrics, the plugin displays two quality level related messages in the middle of the screen: 
    37  
    38 * The completion of a smooth transition for `RTMP dynamic streaming <http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12535/video-delivery-rtmp-streaming#dynamicstreaming>`_ (in green text). 
    39 * The blacklisting and un-blacklisting of a quality level as a result of too many framedrops (in red text). 
    40  
    41 .. note:: 
    42  
    43   The framedrop detection and resulting (un)blacklisting of levels is only supported in JW Player 5.3+. For JW Player 5.0, 5.1 and 5.2, the framedrop chart will simply remain at 0. 
    44  
    45  
    46 Configuration Options 
    47 ===================== 
    48  
    49 Embedding the qualitymonitor plugin is a matter of setting amending its name to the **plugins** player option. The  plugin contains no configuration options itself. 
    50  
    51 Here is a basic embed code example of a player using the qualitymonitor plugin. This example uses the `JW Embedder <http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/15995/jw-embedder-reference-guide>`_: 
    52  
    53 .. code-block:: html 
    54  
    55    <p id="container">The player will be placed here</p> 
    56     
    57    <script type="text/javascript"> 
    58      jwplayer("container").setup({ 
    59        file: "/static/dynamic_stream.xml", 
    60        flashplayer: "/static/player.swf", 
    61        height: 270, 
    62        plugins: { 
    63          "qualitymonitor": {} 
    64        }, 
    65        width: 480 
    66      }); 
    67    </script> 
     3<p>The purpose of this guide is to be a reference for you as you get started with the latest version of the <a href="http://www.longtailvideo.com/addons/plugins/123/QualityMonitor">Quality Monitor Plugin</a> for the JW Player.</p> 
    684 
    695 
    706 
    71 Skinning 
    72 ======== 
    737 
    74 This plugin cannot be skinned. 
     8<h2>Introduction</h2> 
     9 
     10<p>The Qualitymonitor plugin for the JW Player is used to monitor the status of the bitrate switching / dynamic streaming functionalty of the player. This functionality is triggered by loading multiple quality levels of one video into the player. It will then monitor certain quality metrics and play the  optimal stream is served for every viewer.</p> 
     11 
     12<p>For more info about this functionality, please refer to the dedicated sections in the HTTP resp. RTMP streaming guides: 
     13 
     14<ul> 
     15<li><a href="http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12534/video-delivery-http-pseudo-streaming#bitrateswitching">HTTP bitrate switching </a></li> 
     16<li><a href="http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12535/video-delivery-rtmp-streaming#dynamicstreaming">RTMP dynamic streaming </a></li> 
     17</ul> 
    7518 
    7619 
    7720 
    78 Changelog 
    79 ========= 
    8021 
    81 Version 2.0 
    82 ----------- 
     22<h2>Screenshot</h2> 
    8323 
    84 * Switched from the 4.x to the 5.x plugin API. As of now, the plugin cannot be loaded in the JW Player v4. 
    85 * Added support for monitoring framedrops in the chart, and level (un)blacklisting events in the center message. 
    86 * Colored the various quality metrics in the chart, to easily distinct between them. 
    87 * Made the chart stop drawing when the video is paused or stopped. 
     24<p>Here's a screenshot of a JW Player with the qualitymonitor plugin:</p> 
    8825 
    89 Version 2.1 
    90 ----------- 
     26<p><img src="http://www.longtailvideo.com/support/sites/default/files/qualitymonitor.png" alt="quality monitor plugin example"/></p> 
    9127 
    92 * Added fix to support playlists loaded through the JavaScript API. 
    93 * Some updates around formatting of the chart labels. 
     28<p>The plugin consists of two sections. The biggest one is the overlay at the top of the video that lists and charts the current quality metrics. Additionally, the plugin contains a small messaging area in the middle of the screen, for printing player messages that relate to the video quality.</p> 
     29 
     30 
     31 
     32 
     33<h2>Metrics</h2> 
     34 
     35 
     36<p>The Qualitymonitor plugin monitors the following metrics:</p> 
     37 
     38<ul> 
     39<li>The <b>bandwidth</b> of the current connection, in kilobits per second (green).</li> 
     40<li>The number of <b>frames dropped</b> per second (red).</li> 
     41<li>The <b>width</b> of the video screen (blue).</li> 
     42<li>The currently playing <b>quality level</b> (white). The required width and bandwidth of this level is shown between parentheses.</li> 
     43</ul> 
     44 
     45<h4>Messages</h4> 
     46 
     47<p>In addition to these four metrics, the plugin displays two quality related messages in the middle of the screen:</p> 
     48 
     49<ul> 
     50<li>The moment an actual quality transition occurs (in green text).</li> 
     51<li>The moment a quality level gets blacklisted or un-blacklisted, as a result of too many framedrops (in red text).</li> 
     52</ul> 
     53 
     54<p><em>Note the framedrop detection and resulting (un)blacklisting of levels is only supported in JW Player 5.3+. For JW Player 5.0, 5.1 and 5.2, the framedrop chart will simply remain at 0.</em></p> 
     55 
     56 
     57 
     58 
     59<h2>Configuration Options</h2> 
     60 
     61<p>Embedding the qualitymonitor plugin is a matter of setting amending its name to the player's <b>plugins</b> option. The  plugin contains no configuration options itself.</p> 
     62 
     63<p>Here is a basic embed code example of a player using the qualitymonitor plugin, using the <a href="http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/15995/jw-embedder-reference-guide">JW Embedder </a>.</p> 
     64 
     65<pre> 
     66&lt;p id="container"&gt;The player will be placed here&lt;/p&gt; 
     67 
     68&lt;script type="text/javascript"&gt; 
     69 jwplayer("container").setup({ 
     70   file: "/static/dynamic_stream.xml", 
     71   flashplayer: "/static/player.swf", 
     72   height: 270, 
     73   plugins: { 
     74     "qualitymonitor": {} 
     75   }, 
     76   width: 480 
     77 }); 
     78&lt;/script&gt; 
     79</pre> 
     80 
     81 
     82 
     83 
     84<h2>Skinning</h2> 
     85 
     86<p>This plugin offers no skinning functionalities.</p> 
     87 
     88 
     89 
     90 
     91<h2>Changelog</h2> 
     92 
     93<h4>Version 2.0</h4> 
     94 
     95<ul> 
     96<li>Switched from the 4.x to the 5.x plugin API. As of now, the plugin cannot be loaded in the JW Player v4.</li> 
     97<li>Added support for monitoring framedrops in the chart, and level (un)blacklisting events in the center message.</li> 
     98<li>Colored the various quality metrics in the chart, to easily distinct between them.</li> 
     99<li>Made the chart stop drawing when the video is paused or stopped.</li> 
     100</ul> 
     101 
     102<h4>Version 2.1</h4> 
     103 
     104<ul> 
     105<li>Added fix to support playlists loaded through the JavaScript API.</li> 
     106<li>Some updates around formatting of the chart labels.</li> 
     107</ul> 
Note: See TracChangeset for help on using the changeset viewer.