(Deprecated) How to customize your embed code

(Deprecated) How to customize your embed code

 The following article contains legacy Player's method. If you are starting a new implementation we recommend you to visit the new portal dedicated to THRON Player

 

 THRON player is typically configured within "Settings" of THRON Dashboard , in the "Player templates" section. Here you can customize the skin of the player to align it to coordinated corporate image; by setting the style so created as "default ", all shares (unless you specify a different style for the specific share) and THRON Dashboard will exploit this template.

Through the embed code of the player you can still customize a specific publication by simply adding the parameters that are documented here:

 

Coloration

bgcolor (HTML color string), defines the background color of the player for video and image content type (the default is black)  
backgroundColor (HTML color string), defines which color to use for the controls’ bar background. This parameter is available only for the default skin.
backgroundAlpha (integer, 0-100), defines the transparency of the controls’ bar background, 100 being completely opaque and 0 completely transparent. This parameter is available only for the default skin.  
buttonsColor (HTML color string), defines which color to use for the buttons on the controls bar (“play” / “pause”, “go to fullscreen”, …) and for the frontmost elements of the buttons displayed over the content (“pause”, “play”, “watch again”). This parameter is available only for the default skin.  
buttonsBackgroundColor (HTML color string), defines which color to use for the background of the buttons displayed over the content (“pause”, “play”, “watch again”). This parameter is available only for the default skin.  
slidersBackgroundColor (HTML color string), defines which color to use for the slide bars’ background (volume bar, seek bar). This parameter is available only for the default skin.  
textColor (HTML color string), defines which color to use for the “time elapsed” / “time remaining” text on the controls. This parameter is available only for the default skin.  
styleTextColor (HTML color string), defines which color to use for linked content title  
highlightColor (HTML color string), defines which color to use for the highlight clips, the buttons’ rollover and the scroll bars frontmost element (volume bar, seek bar, audio spectrum; see the above image). This parameter is available only for the default skin.  

 

Template

overrideSkinHTML5 (string), absolute path to a css file, it allows to edit the skin by overriding css rules. It is useful for applying small changes without rewriting the whole skin.   
urlSkinHTML5 (string, default empty), if set the player will try to load the skin file from this URL; if empty the player will load the generic skin file.     
urlSkin (string, default empty), if set the player will try to load the skin file from this URL; if empty or not found, the player will load the generic skin file.                
noSkin  (true/false, default false), if true the player will be loaded without a visible skin and it will have to be controlled by the javascript api.   
skinCustomItems (Array), permits to render custom buttons on the skin. For example, you can create a button, define the callback function when button will be clicked and some jpeg to shape it. Icon is the path to the jpeg used to render the button, iconOver is the path to the jpeg used to render the button when mouse is over. This parameter is available only for the default skin. Available for Video content type only.
userLanguage (default "EN"), This parameter will allow you to force the locale of the content basic information to be displayed. If provided locale is not available, player will fallback to the first available locale.
displayLinked (default "open"), if "open" the player will show the “Recommended” section; set to "none" if you want to hide it.  
displayDownload (default "open"), if "open" the player will show the “Attachments” section; set to "none" if you want to hide it.  

hideFSButton

(true or false, default false), if true, the player will hide the fullscreen button on the skin (if present). This parameter is available only for the default skin.  
disableInputControls (true or false, default false), if true, any kind of interaction between the user and the player will be prevented.  
onErrorPoster (string, default empty); provides a link to an image (JPG, GIF or PNG) to be loaded and shown on the player if an error occurs.  

 

Playback

autoPlay (true or false, default false), if true the player will load and play the content automatically upon startup. Some devices, often mobile devices, do not support autoplay.   
muted (true or false, default false), valid only for audio and video content); if true the player will start the content muting its audio   
loop (true or false, default false), valid only for on-demand audio and video content); if true the player will repeat the content in a loop upon completion.   
volume (integer, from 0 to 100), provides the starting volume for the content (available only for audio and video content; 0 = muted, 100 = max volume)  
isLive (true or false, default false), set this parameter to true if the content is a live streaming: this will change tracking mode and visual details on the skin  
poster (string, default empty), provides a link to an image (JPG, GIF or PNG) to be loaded and shown on the player while it is initializing (before the video starts). It is currently available only for video and audio  
hls (true or false, default false), if true, the player will try to reproduce the content using hls technology. Due to browsers limitations, hls is only available on the following browsers: Chrome for Android 34+, Chrome for Desktop 34+, Firefox for Desktop 42+, IE11+ for Windows 8.1. Automatic fallback on the available technology.  

 

Advertising

advertising

(string or object), This parameter can be a simple string, the tag url to reproduce, or a more complex object.

 

Complex objects have these parameters: tag, companions, domId, allowAdBlocker

 
advertising.tag (string), the advertising url to be reproduced.  
advertising.companions (array of string), array of domIds where companions have to be displayed (companion is commonly text, banners, rich media, or skins that wrap around the video experience.)  
advertising.domId (string), advertising can be also displayed in an external div, out of the player container.  This is very useful for audio streaming where usually the player element is hidden.  
advertising.allowAdBlocker  (boolean, default false), if "false" and if any adblocker blocks the advertising, the player will send an "adv_blocked" error and it won't reproduce the content.

advertising.onlyOnce (boolean, default true) if "false", advertising will be reproduced before each playlist's content or linked content.  

 

Technology

forceHTML5

(true or false, default false), if true the player will use the HTML5 version of the player, instead of trying to use Flash Player.

 
experienceFirst  (true or false, default false), if true the player will try to use the HTTP streaming technology to reproduce the content instead of progressive download; if HTTP streaming is available the player will try to use the HTML5 version first, otherwise the Flash version; if HTTP streaming is not available, the player will use the progressive download with the HTML5 player.  
preferHTML5 (true or false, default false), if true the player will try to use HTML5 version of the player, if no compatible channel is found, it will fall-back to flash version.  

 

Tracking

iframed (true or false, default false), if true, tracking made on the content will be related to the domain hosting your embed code.
useContextId (string, default empty), if provided, all the accesses to the content performed through the embed code will refer to a specific context.

disableUserProfiling

(true or false, default false), if true, all tracking coming from this specific embed code will be considered as anonymous.

 
 

ignoreUserBehavior

(true or false, default false) if true, all tracking events on the specific embed will be ignored.

 

 

 

Was this article helpful?
2 out of 2 found this helpful

Have more questions?

SUBMIT A REQUEST

Hai altre domande?

INOLTRA UNA RICHIESTA

Comments