Player API

Each embed code can be fully customized, so that you get the player that fits your needs.

There are two elements to an embed code that can be customized:

  • Feed parameters (what content to display)
  • Player parameters (how should the player itself look like)

The most basic embed code will load a number of default values. Here an example for a basic embed code:

<!-- START: PREVIEWNETWORKS.COM FLASH PLAYER version 4.0 -->
<object width="400" height="225" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" id="pnplayer"> 
<param name="movie" value="http://www.player.previewnetworks.com/v4.0/PNPlayer.swf?"/>
<param name="FlashVars" value="file=http://[region_code].player-feed.previewnetworks.com/v3.1/[product]/[feed_name or Movie_id]/[channel_user_id]/" />
<param name="allowfullscreen" value="true"/>
<param name="allowscriptaccess" value="always"/>
<embed type="application/x-shockwave-flash" src="http://www.player.previewnetworks.com/v4.0/PNPlayer.swf?" FlashVars="file=http://[region_code].player-feed.previewnetworks.com/v3.1/[product]/[feed_name or Movie_id]/[channel_user_id]/" allowfullscreen="true" allowscriptaccess="always" width="400" height="225" />
</object> 
<br/><a style="font-family: verdana; color:cccccc; font-size: 8pt; text-decoration:none" alt="previewnetworks.com" target="_blank" href="http://www.previewnetworks.com/">Powered by Preview Networks</a>
<!-- END: PREVIEWNETWORKS.COM FLASH PLAYER version 4.0 -->

This part describes the basic player feed: 

http://[region_code].player-feed.previewnetworks.com/v3.1/[product]/[feed_name or Movie_id]/[channel_user_id]/?[clip_type]

 

Feed parameters

Parameter name

Example Description

Channel User ID

44119999-1 Your unique identifyier.
Contact us if you need one. 
Movie ID 1234 The Movie ID of the desired movie. You can find our Movie IDs HERE.
Product cinema

We offer videos for multiple products. In some countries, only "cinema" is available. 

Possible values: cinema, dvd, bluray 

Clip Type clip_type=1-4

For many movies there is more than just one video available. With this parameter you can determine, which videos should be included.

Trailers are clip_type 1-4
Teasers are clip_type 5-6
Extras are clip_type 7-18 

Possible values: N (any number), ARRAY (f.ex. 1-4)

Feed Name now-10

We provide dynamically updating playlists that can be played in the player instead of one or more specific Movie IDs. These are sorted by date.

Possible values (N is any number between 1-50): 
now-N (movies that have been released)
coming-N (upcoming movies)
newest-N (lates movies)
search-N (search through keywords)

 

Player parameters

Parameter name Example Description
Width &width=400 Width of the player.
Height &height=225 Height of the player.
Volume &volume=80

Volume level when opening the player.

Possible values: 0-100

Default quality &default_quality=large

Videoquality when opening the player.

Possible values: auto, ask, small, medium, large, xlarge, xxlarge

Screencolor &screencolor=2b31a6

Color or the player window.

Possible values: HEX

Backcolor &backcolor=2dbd2d

Color of the controlbar.

Possible values: HEX

Frontcolor &frontcolor=ff00ff

Color of the buttons in the controlbar.

Possible values: HEX

Lightcolor &lightcolor=ff5900

Color of the buttons in the controlbar when mouse-over.

Possible values: HEX

Controlbar &controlbar=over

Behavior of the controlbar.

Possible values: over, roll , always, none

Transparency &alphaPC=0.9

Transparency of the controlbar from invisible to solid color.

Possible values: 0 - 1

Share button

&share=0

Display share button.

Possible values: 0, 1

Stop button &stopButton=0

Display stop button.

Possible values: 0, 1

Skin &skin=http://...

Load custom skin.

Possible value: URL

Link &link=http://...

Link in controlbar.

Possible values: auto, none, URL

Displayclick &displayclick=link

Action when clicking on the player window.

Possible values: playpause, link, fullscreen

Autostart &autostart=true

Start video automatically.

Possible values: false, true

Display title &display_title=over

Display clip title in player window.

Possible values: none, always, over

Logo &logo=http://...

Display logo in top-right corner of the player window.

Possible value: URL

Loading screen logo &loading_screen=http://...

Display logo while the player loads a video.

Possible value: URL

Show playlist &startShowPP=1

Display playlist on player start-up.

Possible values: 0, 1

Auto-hide playlist &autoHidePP=0

Hide playlist automatically when video plays.

Possible values: 0, 1

Shuffle &shuffle=true

Shuffle playlists in the player.

Possible values: true, false

Thumbnail width &itemW=120

Width of the playlist thumbnails.

Possible values: 20 - 200

Thumbnail height &itemH=72

Height of the playlist thumbnails.

Possible values: 15 - 150

On play complete &onPlayComplete=next

After displaying one video, what to do next.

Possible values: next, stop, loop

BLOG: The BRAVES: Best in Brand Video Awards

Join Preview Networks at The BRAVES Awards. Nominate your brand, agency, or technical video service today...

More

STATS: Consumer Video Consumption Increasing

According to the Cisco Visual Index Study, video will account for nearly 90 percent of all consumer Internet traffic by 2013. (Source: Cisco Whitepaper)

More