Manual jwplayer

JW Player Module
The Best free solution to implement JW Player in Joomla

Version 2.8.0
Detailed Guide

Version 2.8.0 – doc. version 1.2.0
Revision date 12 May 2011
Author Fabien M. webmaster@joomlarulez.com
Copyright No portion of this document may be reproduced or
re-distributed without the consent of the author.

Joomlarulez E-mail: webmaster@joomlarulez.com Web site: http://www.joomlarulez.com

Page 1 / 44 – JW Player Module 2.8.0

JW Player Module

Table of Contents
1. Introduction ....................................................................................................................... 3
2. Project Team .................................................................................................................... 3
3. Document Distribution..................................................................................................... 3
4. Credits ............................................................................................................................... 3
5. License .............................................................................................................................. 4
5.1. Main License ................................................................................................................ 4
5.2. Commercial License................................................................................................... 4
5.2.1. JW Player™ License............................................................................................... 4
5.2.2. JW Player™ Licensing............................................................................................ 4
6. Refund Policy ................................................................................................................... 6
7. Version .............................................................................................................................. 7
8. Changelog......................................................................................................................... 7
9. Package .......................................................................................................................... 11
10. Installation and Upgrade........................................................................................... 12
10.1. Joomla Requirements ........................................................................................... 12
10.2. Technical Requirements....................................................................................... 12
10.3. First Installation...................................................................................................... 13
10.4. Upgrade................................................................................................................... 15
10.5. Cross domain Security.......................................................................................... 17
10.6. Directory CHMOD.................................................................................................. 18
10.7. Installing the license player.................................................................................. 19
10.8. Language ................................................................................................................ 23
11. Files Support .............................................................................................................. 24
11.1. Single Files ............................................................................................................. 24
11.2. Youtube Videos...................................................................................................... 25
11.3. HTTP Streaming .................................................................................................... 26
11.5. DVR Support .......................................................................................................... 28
11.6. XML Playlists .......................................................................................................... 29
11.7. JWPlayer Namespace .......................................................................................... 30
12. Configuration .............................................................................................................. 31
12.1. Playlist ..................................................................................................................... 32
12.2. RTMP....................................................................................................................... 33
12.3. Thumbnail ............................................................................................................... 33
12.4. Layout...................................................................................................................... 34
12.5. Color ........................................................................................................................ 35
12.6. Behaviour................................................................................................................ 36
12.7. Plugins..................................................................................................................... 37
12.7.1. LongTail's AdSolution ....................................................................................... 37
12.8. Global ...................................................................................................................... 38
12.9. Joomlarulez Link.................................................................................................... 38
13. How-To........................................................................................................................ 39
13.1. How to use a LastFM Playlist in External RSS Link ........................................ 39
13.2. How to use a Youtube Playlist/Channel/Tag in External RSS Link............... 41
14. Online Help ................................................................................................................. 44
14.1. Tip Note................................................................................................................... 44
14.2. FAQ.......................................................................................................................... 44
14.3. Forum ...................................................................................................................... 44
14.4. LongTail Documentation....................................................................................... 44


JW Player Module

1. Introduction
This document describes the basic functionality and key features of the JW Player
Module.

2. Project Team

The JW Player Module project is an Open Source project supported by the following
Team members:

Joomlarulez Team Membership
Name Username Role
Fabien M. Admin CEO, Webmaster,
Programmer
Delphine P. dhp Web designer

• The official home of JW Player Module project is located at
http://www.joomlarulez.com
• If you like this module, please post a rating and a review at the JED page of
JW Player Module :
http://extensions.joomla.org/extensions/multimedia/multimedia-players/video-
players-a-gallery/8156

3. Document Distribution

The Joomlarulez Team has decided to offer this documentation on a registration
basis.

4. Credits

The JW Player Module project is based on our code but also use another script and
flash resources.

Others Code Contributors
Name of script/Flash code Credits
JW Player http://www.LongTailvideo.com/
SWF Object http://code.google.com/p/swfobject/



JW Player Module

5. License

The JW Player Module project is based on several licenses according to the code
contributors, the main licenses are GPL and CC.

5.1. Main License

Licences
Name of script/Flash code Licences
JW Player Module GPL
JW Player http://creativecommons.org/licenses/by-nc-sa/3.0/
SWF Object MIT License

5.2. Commercial License

JW Player have specific licenses for commercial websites, CC is always valid but
according to the terms of the license, commercial use is restricted. Here are the
conditions of use in these cases.

5.2.1. JW Player™ License

The license is only required for commercial websites.

All LongTail Video products require licenses when used commercially. Examples of
commercial use include:
(i) websites with any advertisements
(ii) websites owned or operated by corporations
(iii) websites designed to promote other products, such as a band or artist
(iv) products (e.g. a CMS) that bundle LongTail products into its offering.

5.2.2. JW Player™ Licensing

How can I order a license?
Please Register. Thanks in advance.

Do I need to buy a license?
The player is open-source and free for non-commercial use. For corporate use or if
you're planning to generate revenue from your site (e.g., by running any
advertisements on the page, selling anything, etc.), you'll need to buy a license. If
you're still not certain, contact us and we'll determine whether you require a license.
As a general rule, if you need to ask, then you probably need to buy a license.

Are there any other reasons to buy a license?
If you buy a license, you're no longer obliged to credit us and you may alter or
remove the link back to us that appears with a right-click within the player. You're
also no longer required to share any modifications you might make to the player.



JW Player Module

How much are licenses?
A single site license is €59. A premium license (for use on up to 50 sites) is available
for €149.

What payment methods do you accept for licenses?
You can pay for your license via PayPal.

I'm interested in a custom enterprise license with fewer restrictions. Whom do I
contact?
Please contact us with your requirements and we will discuss a price. Please be sure
to include (i) how many sites you have; (ii) how many monthly videos you stream and
(iii) your budget.

I purchased a license, but I didn't receive anything.
It's possible your order didn't fully process. Please contact us and we'll email your
license within two business days.

I accidentally submitted my license order twice. What do I do?
Just contact us and we'll be happy to cancel the duplicate order for you and make a
refund.

I changed my mind about my order. How do I cancel?
We do not refund except in special cases. See our refund policy.

I have a license for a 4.5 (or below) version of the JW Player. Does it apply to
the 5.0+ players?
No. The 5.0+ players were released with a new license agreement, so any license
(4.5 or below) you purchased for an older player doesn't apply (ex. If you want to use
the 5.0+ player, you'll need to purchase a new license.

I have a license for a 4.6 (or above) version of the JW Player. Does it apply to
the 5.0+ players?
Yes. The 5.0+ players were released with a new license agreement, but the LongTail
upgrade policy allow a free upgrade for 4.6 (or above) license holders.

I want to use both the JW FLV Player and the JW WMV Player on the same site.
Do I need to buy a license for each?
No. One site license entitles you to use both players on that site.

Can I transfer my license to someone else?
No. Licenses are non-transferrable.

I have another question about licenses. Where can I find an answer?
Contact us and we’ll help you out.



JW Player Module

6. Refund Policy

We want to make public our policy on refunds so that there is no confusion.

All our sales are final and no refunds will be given. All our products are digital
software, delivered instantly. Once payment is received it is impossible for you to
return a product for a refund.

If you find a bug in our software, you can report it in the forum and we will fix it in the
next version. Finding a bug is not a reason to request a refund.

We do not issue refunds if:

• You just change your mind
• You choose not to use our product
• You find that our product doesn't suit your needs (We have basic plugin and
module available for you before purchasing)

However, we understand that it is impossible for us to test our software on every
platform and every configuration it may encounter on other servers. Therefore if you
are unable to get our software up and running on your server in the first 30 days after
purchasing the software then please contact us and we will do everything within our
knowledge and experience to get our software to work on your server.

If we fail to achieve this we will happily give you a refund or exchange the product for
a new product. You will need to provide us with full access to your FTP, MySQL and
Joomla Admin consoles in order for us to debug and install the software; if you can’t
give us this access then we will not be able to give you a refund.



JW Player Module

7. Version

Here are the latest number versions for all code and documentation used.
Version
Name of script/Flash code Version
JW Player Module 2.8.0
Doc JW Player Module 1.2.0
JW Player 5.6.1768
SWF Object 2.2

8. Changelog

This is a non-exhaustive (but still near complete) changelog for JW Player Module
2.8.0, including beta and release candidate versions.
Our thanks to all those people who've contributed bug reports and code fixes.

Legend:

* -> Security Fix
# -> Bug Fix
$ -> Language fix or change
+ -> Addition
^ -> Change
- -> Removed
! -> Note

Changelog
Version Date Changelog
2.8.0 12 May. 11 ^ Upgrade to JW Player 5.6.1768.
^ Upgrade jwplayer.js.

^ Coding style and standards for all php files.

+ Integrate support for ActionScript 3 YouTube API.

- delete yt.swf.
2.7.0 03 Apr. 11 ^ Upgrade to JW Player 5.5.1641.

^ Optimize mod_playerjr.php script, reducing code size
around 50%.
^ change xml name flashvars this to optimize script, this
means dev have to check those flasvars after upgrade
volume, stretching, smoothing, shuffle, repeat, icons,
bufferlength, autostart, wmode, start, streamer, image,
screencolor, lightcolor, frontcolor, backcolor, width, height,


JW Player Module

playlistsize, controlbar, playlist
2.6.1 30 Jan. 11 # fix language error under J1.6.
2.6.0 13 Jan. 11 + Add Joomla! 1.6 Support.
^ Modify xml config file for J1.6 support.
^ Modify ini language file for J1.6 support.
+ Add sys.ini language file for J1.6 support.

^ Set flashvars only if need.
^ Upgrade to JW Player 5.4.1530.
2.5.0 19 Dec. 10 ^ Upgrade to JW Player 5.4.1492
^ Upgrade jwplayer.js

^ Allow playlist flashvar left.
^ Change backend Layout.
^ Set joomlarulez link label and description in language ini
file.
2.4.1 29 Oct. 10 ^ Upgrade to JW Player 5.3.1397
^ Upgrade jwplayer.js
2.4.0 24 Oct. 10 ^ Upgrade to JW Player 5.3.1356.
^ replace video.flv by video.mp4.

+ Add jwplayer.js.
+ Add thumbnail automatically for Youtube video.

# Set image flashvar only if need.
2.3.0 17 Jul. 10 ^ Upgrade to JW Player 5.2.1151.
2.2.0 14 Jun. 10 ^ Upgrade to JW Player 5.2.1065.

+ Add top Playlist position flashvars
2.1.2 04 Apr. 10 ^ Change xml installer by an upgrade installer
2.1.1 20 Mar. 10 ^ Upgrade to JW Player 5.1.897.
2.1.0 08 Mar. 10 ^ Upgrade to JW Player 5.1.854.
2.0.2 17 Jan. 10 # Fix HTML error under IE8 in backend administration
2.0.1 31 Dec. 09 # Flashwars file to playlistfile according to rss link or single
file
2.0.0 20 Dec. 09 ^ Upgrade to JW Player 5.0.753.

^ Upgrade to swfobject 2.2.

- Layout : Remove logo for JW 5.x Version.
- Remove Fix Mootools and Jquery Conflict, not longer
needed since then upgrade to swfobject 2.2.
+ Add en-GB.ini Language Backend.
^ Clean up Code.
^ Reduce variables set when unused, RAM server



JW Player Module

optimization.
^ Change XML Layout.
1.5.2 15 Nov. 09 ^ Upgrade to the new Adsolution Channel Code
1.5.1 12 Nov. 09 ^ Upgrade to JW Player 4.6.485

# Fix error notice Undefined variable, when fixmootools and
fixjquery is force to no
1.5.0 28 Oct. 09 ^ Upgrade to JW Player 4.6

- Removed expressInstall.swf in the package (no longer
needed)
+ Add Top Position for Control Bar
1.4.0 30 Sep. 09 + Add some Link helper in xml package
^ Change layout in xml package
+ Behaviour : Buffer Length
+ Add Thumbnail, location of a preview image
+ Add Auto detect mootools/jquery use (Always have choice
to force prevent conflict to Yes or No)
+ Add choice to display or not Joomlarulez.com Link, if not
please make a donation
# Fix conflict with jquery
- Remove ID example for adsolution plugin (this to prevent
some misunderstanding, ID example are only in description)
1.3.0 17 Aug. 09 + Automatic Module Setting Suffix (Multiple Player with
different Playlist on same page)
+ Behaviour: Icons (Hide or not the play button)
+ Behaviour: Logo (Location of an external jpg, png or gif
image to show in a corner of the display.)
+ Behaviour : Smoothing (Setting to get performance
improvements with old computers / big files)
+ Behaviour : Stretching (Defines how to resize images in
the display)
+ Add RTMP/HTTP Streamer support (Single File)
+ Add Start RTMP/HTTP (Single File)
1.2.1 27 Jul. 09 + Add CDATA information during install
+ Add Module class SFX
1.2.0 19 Jul. 09 ^ Update JW Player to 4.5
# Fix midroll error in Adsolution Plugin
+ Add expressInstall.swf in package
+ Add LICENSES.php
+ Add CREDITS.php
1.1.2 27 May. ^ Change Player Unbranded by a Branded player, License
09 Holders have to upload by FTP the player Unbranded, See
How-To here :
http://www.joomlarulez.com/faq/44-faq/56-how-to-install-
your-personal-license-player.html
1.1.1 19 May. 09 # Fix Mootools conflict under IE7
^ Put JS in HTML Head


JW Player Module

+ Add Choose Link display to Adobe Flash Player if not
installed
1.1.0 06 May. 09 + Ad Solution Plugin Full Support : No Hack
+ Youtube Link support for External RSS Link
^ License-holders can download an unbranded player
with their Licence number and replace themselves
the player in the directory of JW Module Player.
+ Layout : Playlist position
+ Layout : PlaylistControlbar
+ Layout : Transparency of the Playlist
+ Behaviour : Auto Start
+ Behaviour : Repeat
+ Behaviour : Shuffle
+ Behaviour : Volume
+ Changelog : Package include changelog.php
1.0.1 01 May. 09 # Fix XML Error
1.0.0 20 Mar. 09 Public Release



JW Player Module

9. Package

The package you download is called:

mod_playerjr_2.8.0_UNZIP_FIRST.zip

You must unzip it first.

The package is composed of 4 files. Here is the list:

• mod_playerjr_2.8.0.zip: This is the package for the module itself. This is the
one you will install through the Joomla installer.
• crossdomain.xml: This is a file that you have to put in the webroot of your
website. This is to allow or not allow streaming from a specific website
address that you specify inside. See further forward for more information.
• README_CROSSDOMAIN_SECURITY.txt : This is a quick FAQ about the
settings for the crossdomain.xml file.
• README_INSTALL_UPGRADE_TO_JW_PLAYER_MODULE_2.8.0.txt: This
is a quick FAQ about how to install or upgrade the module See further forward
for more information.



JW Player Module

10. Installation and Upgrade

Here are the different cases for installation and upgrade process.

10.1. Joomla Requirements

Our module is compatible with Joomla 1.5.x in native mode

Our module is compatible with Joomla 1.6.x in native mode

You can find the last version here:

http://www.joomla.org/download.html

10.2. Technical Requirements

Our modules have the same requirements as Joomla:

http://www.joomla.org/technical-requirements.html

Technical Requirements
Software Recommended Minimum
PHP(Curl can be needed, 5.2+ 4.3.10
indicated by Curl*)
MySQL 4.1.x+ 3.23
Apache 2.x+ 1.3
(with mod_mysql, mod_xml,
and mod_zlib)



JW Player Module

10.3. First Installation

Follow these steps to install our module.
(Note that the screen captures are made under Joomla 1.5).

• Download the Latest Version of our module :

http://www.joomlarulez.com/download/doc_download/14-jw-player-
module.html

• Unzip The Package: mod_playerjr_2.8.0_UNZIP_FIRST.zip.

• Go to the administration panel of Joomla.

• Install the package mod_playerjr_2.8.0.zip through the Joomla Installer



JW Player Module

• The Joomla installer will notify you of the success of the install. If not follow
the indication given by the installer.

• Go to the Joomla module management Panel, select, edit and save the JW
Player Module with your own settings (see configuration chapter for more
details).



JW Player Module

10.4. Upgrade

Follow these steps to upgrade our module.

• Download the Latest Version of our module :

http://www.joomlarulez.com/download/doc_download/14-jw-player-
module.html

• Go to the administration panel of Joomla.

• Install the package mod_playerjr_2.8.0.zip trough the Joomla Installer.

The package allows upgrade without uninstall.



JW Player Module

• The Joomla installer will notify you of the success of the install.

• If you have a notice error and/or see only “JWPMA_MOD_DESCRIPTION”
under the “Install Module Success”, please ignore it as it’s a minor Joomla
issue that will be corrected with 1.5.16.

http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemEdit&tra
cker_item_id=17878

• Go to the Joomla module management Panel, select, edit and save the JW
Player Module with your own settings (see configuration chapter for more
details).



JW Player Module

10.5. Cross domain Security

The Adobe Flash Player contains a cross domain security mechanism that denies
certain operations on files that are loaded from a different domain than the player.

The easiest and best way to access 3rd party data is for the provider of that data
to host a crossdomain.xml configuration file in its web root. Before the Flash
Player attempts to load data from any site other than the one hosting the SWF, it
first checks the remote site for the existence of a crossdomain.xml. If the player
finds it, and if the configuration permits external access of its data, then the data
is loaded. Otherwise, a runtime security error is thrown. Here’s an example of a
crossdomain.xml that allows access to the domain's data from SWF files on any
site:

<?xml version="1.0"?>
<!DOCTYPE cross-domain-policy SYSTEM
"http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">

<cross-domain-policy>
<allow-access-from domain="*" />
</cross-domain-policy>

Our plugins.LongTailvideo.com domain includes such a cross domain file, so
players from any domain can load the plugins hosted there.

Although plugins will reside on plugins.LongTailvideo.com (or another plugin root
you set), the crossdomain.xml file needs to allow data access from the site
hosting the player itself, not the plugin. For example, if the player is hosted at
www.site.com/player.swf and tries to access data from www.data.com, even if
data.coms' crossdomain.xml file allows access to plugins.LongTailvideo.com, the
Flash player will throw a security exception.

http://developer.LongTailvideo.com/trac/wiki/FlashSecurity

http://www.adobe.com/devnet/articles/crossdomain_policy_file_spec.html

All you have to do is to upload a crossdomain.xml file to your web root server and
save it where you put your (xml and flv) files



JW Player Module

10.6. Directory CHMOD

Our module has some features that use some specific scripts. Those scripts need
a CHMOD directory (there are a lot of extensions).

Those permissions are by default correctly set on most servers. You can check
this with your FTP client.

Directory CHMOD: 755.

File CHMOD: 644.

More info here:

http://en.wikipedia.org/wiki/Chmod



JW Player Module

10.7. Installing the license player

As you know Joomlarulez is an official reseller of LongTailvideo.com. Once you
buy your license through us you will receive a PDF with the details of your license
and most importantly the license number.

Important: Following our last negotiations with LongTailvideo we now propose a
solution for Commercial websites (License and unbranded Player) and Non-
commercial websites (No License and Branded Player). As a direct consequence
of that our module has by default a branded player. If you have signed up with us
on a commercial plan, you will have to use the following “How-to for install your
unbranded player” in your module.

Go to this address:

http://www.LongTailvideo.com/players/jw-flv-player/commercial-license/

Type your email and your license number.

Click on "View Order" button.



JW Player Module

If you have a license for the JW Player 5.x click on "JW Player for Flash
v5.6 - [ Download ] "

(Don't click on the download link "include viral plugin", you don't need it even if
you have the JW Player Module because our scripts by-pass this).

Once you receive your zip file "mediaplayer-5.6-licensed.zip":

• Unzip it.
• Rename the file "player.swf" to "player-licensed5.swf"

To update the Flash player for your module:

• Upload by FTP the "player-licensed5.swf" file to the directory of your
module
• Upload by FTP the "jwplayer.js" file to the directory/script/ of your
module

Don't upload all other 5 files; our xml packages include them already.

JW Player Module Pathway:

/modules/mod_playerjr/player-licensed5.swf
/modules/mod_playerjr/script/jwplayer.js



JW Player Module

If you have a license for the JW Player 4.x click on "JW Player for Flash
v4.7 - [ Download ] "

(Don't click on the download link "include viral plugin". You do not need it even
if you have the JW Player Module because our scripts by-pass this).

• Once you receive your zip file "mediaplayer-4.7-licensed.zip":
• Unzip it.

To update the Flash player for your plugin:

• Upload by FTP the "player-licensed.swf" file to the directory of your
module. Don't upload all other 5 files, our xml packages include them
already.

JW Player Module Pathway:

/modules/mod_playerjr/player-licensed.swf

Now you have you own Unbranded Player Update.

Ps: We define an unbranded player as the player with the JWPlayer Logo
removed (you can change and add your own logo) and with the backlink in
right click configurable.

Note that right click flashvars are only available with the advanced module



JW Player Module

Example of a branded player: Example of an unbranded player:

Example of a branded player: Example of an unbranded player:



JW Player Module

10.8. Language

The default language of JW Player Module is English, en-GB for Joomla.

All backend fields and helps are stored in an ini file call:

en-GB.mod_playerjr.ini

Once installed you can find this file in the language directory of Joomla:

[path-to-Joomla]/language/en-GB/

If you want to use another language you have to copy and rename this file to
the directory language needed.

[path-to-Joomla]/language/[ln-LN]/ ln-LN.mod_playerjr_ad.ini

Then translate it in to you own language.

NOTE: We are interested in receiving other language translations. We can
offer a coupon code in exchange.

• Webpage on Joomla documentation

http://docs.joomla.org/Creating_a_language_definition_file



JW Player Module

11. Files Support

This page lists all media files, streaming and playlist types that the JW Player
supports.

11.1. Single Files

Flash Playback

Note that the player always tries to recognize a file format by its extension. If
no suitable extension is found, the player will presume you want to load a
playlist! Get around this issue by setting the provider flashvar, e.g.
provider=video.

• Video Formats: H.264 (.mp4, .mov, .f4v), FLV (.flv), 3GPP (.3gp, .3g2),
(provider=video).
• Sound Formats: AAC (.aac, .m4a), MP3 (.mp3) (provider=sound).
• Image Formats: JPEG (.jpg), PNG (.png), GIF (.gif) (provider=image).

Here's a list with commonly encountered issues:

• Though SWF files will also load in the player, it is discouraged to use
them. The player cannot read the duration and dimensions of SWF files
and cannot control their volume or playback.
• You cannot seek within an MP4 file before it is completely downloaded.
The cause of this problem is that the so-called MOOV atom (which
contains the seeking information) is located at the end of your video.
Check out this little application to parse your videos and fix it.
• You encounter too fast or too slow playback of MP3 files. It contains
variable bitrate encoding or unsupported sample frequencies (e.g. 48
KHz). Please stick to a constant bitrate encoding and 44 kHz. The free
iTunes software has a decent MP3 encoder. Note that the 4.x player
actually supports fewer formats than the 3.x player (due to bugs in the
AVM2).
• The progress bar isn't running with your FLV file, or your video
dimensions are wrong. This is because your FLV file doesn't have
metadata. Fix this by using this small tool from
www.buraks.com/flvmdi/.

More technical info on the file formats supported by Flash can be found in this
blogpost from Tinic Uro, one of the developers of the Flash plugin.

• Webpage on LongTail

http://developer.LongTailvideo.com/trac/wiki/Player5Formats#SingleFiles



JW Player Module

11.2. Youtube Videos

The player includes native support for playing back YouTube videos
(provider=youtube). YouTube playback is automatically enabled when the file
option is assigned to the URL of a YouTube video. This value can take one of the
following forms:

• http://www.youtube.com/watch?v=ylLzyHk54Z0
• http://www.youtube.com/watch#!v=ylLzyHk54Z0
• http://www.youtube.com/v/ylLzyHk54Z0
• http://youtu.be/ylLzyHk54Z0

Note: Version 5.6 of the JW Player uses YouTube's ActionScript 3 Chromeless
API to render YouTube content, meaning that YouTube may place ads over the
video during playback. These videos are unplayable in YouTube's previous API,
meaning that older versions of the JW Player (5.5 and below) will not be allowed
to play those videos.

Note: since 5.3 version of JW Player for YouTube playlist items where no image
is specified, it pulls the image automatically.

• How-To Specific

How to use a Youtube Playlist/Channel/Tag in External RSS Link ?


http://developer.LongTailvideo.com/trac/wiki/Player5Formats#YoutubeVideos



JW Player Module

11.3. HTTP Streaming

Both FLV and MP4 video can be played back with so-called HTTP pseudo-
streaming servers. These servers allow video viewers to skip to non-downloaded
parts of a video. HTTP streaming can be enabled by setting the flashvar
provider=http in the player. Here are a few examples of such streaming servers:

• The H264 streaming module for Apache, Lighttpd, IIS and NginX.
• The mod_flv_streaming module for Lighttpd.
• PHP/ASP scripts such as XmooV PHP.
• Content delivery networks such as Bitgravity, Edgecast or Limelight.

Next to the provider=http flashvar, two flashvars are available to configure HTTP
streaming:

• By default, the querystring parameter to provide the start position to the
server is called start. (e.g. http://server.com/video.flv?start=3489512). As
of version 4.6, 4.7, this parameter can be configured with the flashvar
http.startparam. For example, the Edgecast CDN uses ec_seek,
Bitgravity uses starttime and Limelight uses fs as pseudostreaming start
parameter.
• If you use a PHP/ASP/* script for pseudo-streaming, you must provide the
location of that script with the streamer flashvar. Instead of directly calling
the file with start parameter, the player will then call the script, with both file
and start as parameters (e.g. (e.g.
http://server.com/streamscript.php?file=video.flv&start=3489512).


http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12534/video-
delivery-http-pseudo-streaming



JW Player Module

11.4. RTMP Streaming

FLV and MP4 video and MP3 and AAC audio can also be streamed with RTMP
Servers, using the provider=rtmp flashvar. In addition to this, RTMP live streams
can be played in the player. The following RTMP servers are supported:

• Wowza Media Server
• Flash Media Server
• Red5 server

In addition to the file and the provider=rtmp flashvar, RTMP streams usually need
a third flashvar streamer, which gives the player the location of the RTMP server
(e.g. streamer=rtmp://edge.sercer.com/application).

The player will figure out by itself if it needs to strip the .flv extension off the file, or
if it needs to prepend a mp4: or mp3: string to load the file. In 5.0, this behaviour
can be skipped by setting the rtmp.prepend=false flashvar.

Most frequently used RTMP functionality (such as 302 redirects, the
getstreamlength call and Wowza's secureToken) is built into the player. In
addition to this, the player supports load balancing with XML files. This is used by
e.g. the Highwinds and VDO-X CDNs. Instead of loading the video, the RTMP
model presumes that the file flashvar is actually an intermediate SMIL file, which
is then loaded and parsed to retrieve the actual RTMP streamer and file. In
version 5.0 of the player, turn this on by adding the flashvar
rtmp.loadbalance=true. Here's an example of such a SMIL file, in case you're
interested in building this into your own CDN:

<smil>
<head>
<meta base="rtmp://68.16.184.155/n9f8m2x7/_definst_"/>
</head>
<body>
<video
src="fms/video?doppl=164314e15f9563d3&dopsig=9bfcdaefc371a52fe049bf87c03b77
76"/>
</body>
</smil>

A special RTMP case is the live broadcast through the Akamai or Limelight
networks. These CDNs use a stream subscription mechanism for load balancing.
This is supported by the player by setting the provider flashvar to fcsubscribe.
The regular file and streamer flashvars are still needed. In player 5.0 you can also
set the flashvar provider to rtmp and rtmp.subscribe to true.


http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12535/video-
delivery-rtmp-streaming


JW Player Module

11.5. DVR Support

The JW Player 5.3+ supports RTMP DVR streaming, a feature introduced by
Adobe's Flash Media Interactive Server 3.5. DVR streaming allows users to
pause/resume a live stream or seek back for a replay. In short, DVR allows a live
stream to behave exactly like an on-demand stream; the only difference being
that the duration might increase.

Note: JW Player versions 5.1 and 5.2 use a no longer supported mechanism for
DVR streaming.


http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-
v5/12398/enabling-dvr-streaming



JW Player Module

11.6. XML Playlists

First, note that playlist XML files are subject to the Crossdomain security
restrictions of Flash. This means that a video player on one domain cannot load a
playlist from another domain. It can be fixed by placing a crossdomain.xml file at
the server the captions are loaded from. That said the following playlist formats
are supported:

• ASX feeds (example)
• ATOM feeds with Media extensions (example)
• RSS feeds with iTunes (example) extensions and Media extensions
(example)
• XSPF feeds (example)

Here is an overview of all the tags of each format the player processes, and the
flashvars they correspond to:

Flashvars XSPF RSS itunes: media: ASX ATOM
author creator - author credit author -
date - pubDate - - - published
description annotation description summary description abstract summary
duration duration - duration content duration -
file location enclosure - content ref -
link info link - - moreinfo link
image image - - thumbnail - -
start - - - - starttime -
streamer - - - - - -
tags - category keywords keywords - -
title title title - title title title
provider - - - - - -

All media: tags can be embedded in a media:group element. A media:content
element can also act as a container. Additionally, iTunes and MediaRSS tags can
be mixed in one RSS feed. The player will pick the last matching element for each
property.


http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12537/xml-
playlist-support



JW Player Module

11.7. JWPlayer Namespace

In order to enable all JW Player file properties for all feed formats, the 4.4 player
introduced a jwplayer namespace. By inserting this into your feed, file properties
that are not supported by the feed format itself (such as the provider or duration
in an RSS feed) can be amended without breaking validation. Any of the flashvars
listed in the above table can be inserted. Here's an example:

<rss version="2.0"
xmlns:jwplayer="http://developer.LongTailvideo.com/trac/wiki/FlashFormats">
<channel>
<title>Example RSS feed with jwplayer extensions</title>
<item>
<title>FLV Video</title>
<link>http://www.bigbuckbunny.org/</link>
<description>Big Buck Bunny is a short animated film by the Blender
Institute, part of the Blender Foundation.</description>
<enclosure url="../../testing/files/bunny.flv" type="video/x-flv"
length="1192846" />
<jwplayer:author>the Peach Open Movie Project</jwplayer:author>
<jwplayer:provider>http</jwplayer:provider>
<jwplayer:duration>34</jwplayer:duration>
</item>
</channel>
</rss>

Pay attention to the top level tag, which describes the JW Player namespace with
the xmlns attribute. This must be available in order to not break validity.

You can mix jwplayer elements with both the regular elements of a feed and
elements from other extensions (mrss/itunes). If multiple elements match the
same property, the elements will be prioritized:

• Elements that are defined by the feed format (e.g. the enclosure in RSS)
get the lowest priority.
• Elements defined by the itunes namespace rank third.
• Element defined by the media namespace (e.g. media:content) rank
second.
• Elements defined by the jwplayer extension always gets the highest
priority.

This feature allows you to set, for example, a specific video version or streaming
provider for the JW Player, while other feed aggregators will pick the default
content.


http://www.longtailvideo.com/support/jw-player/jw-player-for-flash-v5/12537/xml-
playlist-support


JW Player Module

12. Configuration

Here are listed all the backend setup processes for configuration.

Go to the Joomla module management Panel, select JW Player Module, select
and edit.


Select Module Parameters.



JW Player Module

12.1. Playlist

• Field “Select origin of the Playlist”

Here you have to choose where the playlist comes from:
o A RSS Link (ASX, ATOM, RSS - iTunes, RSS - Media, SMIL, XSPF)
o Single file

• Field “Link of you RSS File/Single File”

o External Playlist Case:

Put your RSS address (ASX, ATOM, RSS - iTunes, RSS - Media, SMIL,
XSPF and Youtube) here.

An External playlist is a text-based XML file that contains information
about each file you would like to present in the player.

Note: If you use an xml file locally put in the field the full pathway to the
file:

http://www.website.com/pathway_to_the_file/the_file.xml

o Single File Case:

Put the address of File here; note that the address can be a remote or
local file. The full pathway is needed.

Note: If you use a file locally, put the full pathway to the file in the field:

http://www.website.com/pathway_to_the_file/the_file.flv



JW Player Module

12.2. RTMP

These flashvars control the settings for RTMP streaming.

• Field “Start”

Optional only for streaming (HTTP / RTMP): position in seconds where
playback has to start.

Won't work for regular (progressive) videos.

• Field “Streamer”

Optional only for streaming (HTTP / RTMP): Location of an rtmp/http server
instance to use for streaming.

Can be an RTMP application or external PHP/ASP file.

12.3. Thumbnail

These flashvars control settings for RTMP streaming.

• Field “Thumbnail”

Optional: Put an image preview here for the single file.

Note: If you use a file locally put the full pathway to the file in the field:

http://www.website.com/pathway_to_the_file/the_file.png



JW Player Module

12.4. Layout

These flashvars control the looks and layout of the player.

• Field “Playlist position”

Position of the playlist.
Can be set to bottom, top, over, right or none.

• Field “Control Bar position”

Position of the controlbar.
Can be set to bottom, top, over and none.

• Field “Size of the Playlist”

When below this refers to the height, when right this refers to the width of
the playlist.

• Field “Height of the Player”

Height of the display in pixels.
When resizing is set to false, this is the overall player height.

• Field “Width of the Player”

Width of the display in pixels.
When resizing is set to false, this is the overall player width.

• Field “Icons”

Set this to No to hide the play button and buffering icon in the middle of the
video.



JW Player Module

12.5. Color

All colors are in so-called hexadecimal values as is common for web colors,
note that if you use a skin those parameters are not priority, it depends on
the skin used.

• Field “Backcolor of the Playlist”

Background color of the controlbar and playlist.
This is white FFFFFF with the default skin.

• Field “Frontcolor of the Playlist”

Color of all icons and texts in the controlbar and playlist.
This is white 000000 with the default skin.

• Field “Lightcolor of the Playlist”

Color of an icon or text when you rollover it with the mouse.

• Field “Screencolor of the Playlist”

Background color of the display.

• Field “Transparence of the Playlist”

Transparency of the Playlist, set Opaque to have the Screen color of the
Playlist that you choose. Set transparent if you want to have transparency
effect which is useful for some specific DHTML/CSS templates or if you
use the Adsolution Plugin.



JW Player Module

12.6. Behaviour

These flashvars control the playback behaviour of the player.

• Field “Auto Start”

Automatically start the player on load.

• Field “Bandwidth”

Available bandwidth for streaming the file. Used predominantly for bitrate
switching.
Set this flashvar if you want to hint the player on the initial bandwidth.
Overwritten every 2 seconds whenever a video or http stream is loading or
an rtmp stream is playing.

• Field “Buffer Length”

Number of seconds of the file that has to be loaded before starting.
Set this to a low value to enable instant-start and to a high value to get less
mid-stream buffering.

• Field “Repeat”

Set to none to unchain the playlist, set to list to play the entire playlist once,
to always to continuously play the song-video-playlist and to single to
continue repeating the selected file in a playlist.

• Field “Shuffle”

Shuffle playback of playlist items.

• Field “Smoothing”

This sets the smoothing of videos, so you won't see blocks when a video is
upscaled.
Set this to No to get performance improvements with old computers / big
files.

• Field “Stretching”

Defines how to resize images in the display.
Can be none (no stretching), exactfit (disproportionate), uniform (stretch
with black borders) or fill (uniform, but completely fill the display).

• Field “Volume”

Startup volume of the player.
Can be 0 to 100. Value is saved in a cookie.


JW Player Module

12.7. Plugins

Here you can select the plugins that can enhance your player. They can work
together.

12.7.1. LongTail's AdSolution

LongTail's AdSolution

Allows you to run pre-roll, overlay mid-roll, and post-roll
advertisements in your media player.

LongTail's have proprietary relationships with many top ad
networks and we support video, display and text ads.
Needs special registration here :
AdSolution.LongTailvideo.com

JW Player™ Compatibility : 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, 5.0, 5.1,
5.2, 5.3, 5.4, 5.5
Last Updated: 3/9/09
Version: 1.0
Non-Commercial Use: Free
Commercial Use: Free

• Field “Adsolution Plugin Enabled”

Specify Yes to enable Adsolution Plugin.
NOTE you must also set the player to transparent in the Colour settings.

• Field “Adsolution Channel Code”

Type here your Adsolution Channel Code. This is the code given to you
after registration.
Example, Channel Code: cxtmwcocurafcex.


http://www.LongTailvideo.com/addons/plugins/2/LongTail-AdSolution



JW Player Module

12.8. Global

• Field “Module Class Suffix”

A suffix to be applied to the css class of the module (table.moduletable).
This allows individual module styling.

• Field “Flash Install”

Specify Yes if you want that a link to Adobe to appear when the user
doesn't have Flash install.

12.9. Joomlarulez Link

• Field “Joomlarulez Link”

Specify Yes if you want a link to Joomlarulez.com to appear. If set to No
please make a donation.



JW Player Module

13. How-To

Here are some specific How-To’s for various different cases.

13.1. How to use a LastFM Playlist in External RSS Link

There are three possible ways:

1. If you have a LastFM account go to this page:

http://www.last.fm/home/freemp3s

Then copy the RSS Link give by this Icon RSS:

The RSS Link has this form:

http://ws.audioscrobbler.com/2.0/user/Artskorps/podcast.rss

(Artskorps here is the username account on LastFM)

http://ws.audioscrobbler.com/2.0/user/YOUR_LASTFM_ID/podcast.rss

This RSS Link generates a playlist audio of free music according to your
scrobling profil.

2 (Available for all) select RSS Link of an artist (note that only free
music can be streamed).

(Further information here: http://www.last.fm/api/show?service=118 )

For an artist the RSS Link is:

http://ws.audioscrobbler.com/2.0/artist/jere/podcast.rss

(Jere is the name artist that we choose for our example on LastFM)

http://ws.audioscrobbler.com/2.0/artist/ARTIST_NAME/podcast.rss


JW Player Module

This RSS Link generates a playlist audio of free music of this artist.

3. (Available for all) select RSS Link for a specificTAG (note that only free
music can be stream)

(Further information here: http://www.last.fm/api/feeds )

For a TAG the RSS Link is:

http://ws.audioscrobbler.com/2.0/tag/dubstep/podcast.rss

(Dubstep is the TAG that we chose for our example on LastFM)

http://ws.audioscrobbler.com/2.0/tag/TAG/podcast.rss

This RSS Link generates a playlist audio of Free music of this kind of
Music.

If you use JW Player Module copy this code (according to your RSS Link)
in the field "Link of your RSS File"

The result (we also added an image in the Logo Field):



JW Player Module

13.2. How to use a Youtube Playlist/Channel/Tag in External RSS Link.

1. You need a Youtube account.

2. Create a playlist:

http://www.Youtube.com/my_playlists

In our example we created a playlist called "Joomlarulez". You can choose
any name.

3. Choose and select videos for your playlist. To select those videos
browse your upload file or search for a video on Youtube.

You can choose as many videos as you want. In our example we chose 3
videos.

When your selection is completed, return to you playlist directory and
select your playlist and edit it:



JW Player Module

Select the code in the field Link:

http://www.Youtube.com/view_play_list?p=121D6A1AA7ADE758

The code of the playlist we need is this:

121D6A1AA7ADE758

Then copy this code in this form:

http://gdata.Youtube.com/feeds/api/playlists/YOUR_YOUTUBE_PLAYLIST_N
UMBER

http://gdata.Youtube.com/feeds/api/playlists/121D6A1AA7ADE758

• Second Solution: Embed your channel.

If you don't want to set a lot of playlists and only want to stream your own
video upload (Channel)…


http://gdata.Youtube.com/feeds/api/users/YOUR_YOUTUBE_ACCOUNT_NA
ME/uploads

http://gdata.Youtube.com/feeds/api/users/bab2on/uploads



JW Player Module

• Third Solution: Embed Specific Tag.

If you don't want to set a lot of playlists and only want to stream dynamic video
according to a specific tag…


http://www.Youtube.com/rss/tag/YOUR_TAG.rss

http://www.Youtube.com/rss/tag/obama.rss

• Set the Module/Plugin

Now if you use JW Player Module copy this code (according to your playlist
number/User account/Tag) in the field "Link of your RSS File"

The result:



JW Player Module

14. Online Help

In addition to this documentation there is also online help accessible.

14.1. Tip Note

Tip note is accessible by pointing with the mouse any field in the backend
administration of the module

14.2. FAQ

FAQ is accessible at this web address:

http://www.joomlarulez.com/faq.html

Specific How-tos comes from this section.

14.3. Forum

Forum is accessible at this web address:

http://www.joomlarulez.com/forum.html

A lot of problems have already been solved. Do a search first on the forum.

14.4. LongTail Documentation

LongTail Documentation is accessible at this web address:

http://developer.LongTailvideo.com/trac

Our documentation is in most part based on the LongTail documentation.



Manual jwplayer

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Was ist angesagt?

Was ist angesagt? (8)

Ähnlich wie Manual jwplayer

Ähnlich wie Manual jwplayer (20)

Mehr von VISUAL MART - HERBERT PATZAN CARRILLO

Mehr von VISUAL MART - HERBERT PATZAN CARRILLO (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Manual jwplayer