Viddler’s flash video player currently comes in three flavors. The Full, or default, Player the Simple, or light, Player, and the Episodic Player.

The Full Player

The Full Player features a rich, interactive video viewing experience allowing the viewer to leave timed comments and tags directly on the video timeline. Comments can be in both text and video.

To embed the Full Player with default options, use the following code:

<object width="437" height="370" data="http://www.viddler.com/player/key" type="application/x-shockwave-flash"><param name="id" value="publisher" /><param name="align" value="middle" /><param name="flashvars" value="key=key" /><param name="allowscriptaccess" value="always" /><param name="allownetworking" value="all" /><param name="allowfullscreen" value="true" /><param name="scale" value="noscale" /><param name="quality" value="high" /><param name="wmode" value="transparent" /><param name="src" value="http://www.viddler.com/player/key" /><param name="name" value="publisher" /></object>

The Simple Player

The Simple Player features a light-weight player with minimal load time, nearly no rich features, and no comments or tags on the timeline.

To embed the Simple Player with default options, use the following code:

<object width="437" height="370" data="http://www.viddler.com/simple/key" type="application/x-shockwave-flash"><param name="id" value="publisher" /><param name="align" value="middle" /><param name="flashvars" value="key=key" /><param name="allowscriptaccess" value="always" /><param name="allownetworking" value="all" /><param name="allowfullscreen" value="true" /><param name="scale" value="noscale" /><param name="quality" value="high" /><param name="wmode" value="transparent" /><param name="src" value="http://www.viddler.com/simple/key" /><param name="name" value="publisher" /></object>

Flashvars; required and optional

The only required Flashvar is the video key. There are several optional flashvars, here they are:

autoplay=t – to have player autoplay video
useJavaScript=t – to use JavaScript callbacks (See also; VPJS documentation)
enablecallbacks=t – Enables Javascript callbacks (useJavaScript also)
playAll=true – to show the playall player
hidestats=t – Hides Title and Statistics
optNoTopMenu=1 – Hides Top Menu

Using JavaScript

Both the Full and Simple player can make use of JavaScript call backs in addition to the VPJS JavaScript library. There are two JavaScript functions that the player will call with the optional useJavaScript=t flashvar included.

The playStarted() function:

var playStarted = function() {
	alert('playStarted');
}

This function will alert JavaScript that the video has begun playing. No arguments are sent to this function.

The playEnded() function:

var playEnded = function() {
		alert('playEnded');
}

This function will alert JavaScript that the video has stopped playing. This means the video playhead has made it all the way to the end of the video. It does not mean that the player has been paused by the viewer.

Customizing the players

Both the Full and Simple players can be customized for colors, logos, and linkbacks. To do this through the Viddler.com Web site, simply log in, click Settings > Player Branding to customize the player for that account. These settings will then be used each time the player is embedded.

To customize the player through flashvars, you may use these optional flashvars:

activecolor = (any hex value: #135aef)
inactivecolor = (any hex value: #135aef)
hovercolor = (any hex value: #135aef)
barcolor = (any hex value: #135aef)
whichbar = (1 for loading bar, 0 for played bar)

Additional Parameters

The player also allows for many other customizations, such as decentralized and anonymous comments, and quality control.

Quality Control

You can tweak the quality of the video by using just a couple of parameters. These features allow the video to look smoother and less pixelated but may result in higher CPU usage. These are controlled as flash vars and are listed below.

smooth=(y/n) // Smoothing will allow pixelated edges of text and graphics within. defaults to “n”
deblock=(0-5) // Deblocking will allow low resolution or low bitrate video to play with out blockiness when scaling.

Anonymous Comments

Users who have the the option to allow anonymous comments can automatically set the display name of the commenting user. In order to obtain the anonymous commenting option please contact viddler. Setting the display name is controlled via a flash var.

displayUser=(string)