Kaltura TV Platform Studio Information Guide

Audience / Tech Expertise: 

 

Note: The TV Platform Studio is available only by contacting your CSM.

 

This article describes the following topics:

Overview of the Kaltura TV Platform Studio

The Kaltura TV Platform Studio is a robust HTML-based player editor that creates and edits the Kaltura TV Platform Players' JSON based configuration natively. Kaltura players can be embedded into responsive HTML web pages and native iOS and Android applications. For more information see the Kaltura TV Platform Player Information Guide.

Architecturally, the Kaltura TV Platform Studio Player works with non-destructive JSON editing that enables both manual edits of the JSON file as well as editing the JSON file with the player studio GUI. This guide is exclusively focused on the user interface. If you want to edit a player’s JSON source directly, you can do so in the Kaltura Player Version Utility Page.

Desgining and Configuring a Player

Use the TV Platform Studio tab in the KMC to create configurations and design players and playlists. You can add, remove and adjust multiple buttons and features. 

Updating the Player List in the TV Platform Studio

The TV Platform Studio tab displays the complete list of the TV Platform Players defined in your account. Players created using the previous version of the Studio cannot be upgraded to the new version. 

 

 

Creating a Player in the TV Platform Studio

Each player contains a collection of features of a specific Kaltura Player configuration. In addition to the Kaltura defined features, a player can include a custom plugin configuration.

  1. In the TV Platform Studio tab, click Add New Player.
  2. If you have a hybrid system that supports both OVP players and Cloud TV (OTT) players, clicking the Add New Player button will display a dropdown of with both options: OVP and OTT:

    The Basic Settings window is displayed.

     

  3. Select the required player type.
  4. Next, configure the Basic settings.
  5. Configure the Playback Options.
  6. Configure the Analytics and Monetization (optional).
  7. Configure the Offline Capabilities (optional).
  8. Click Save Player Settings to create the new player.

 

Preview Options

The Kaltura TV Platform Player Studio enables you to preview the changes you make to the player using the following options, which appear in the upper right pane of the Studio:

  • Auto Preview: If selected, automatically previews the player with the changes you've made
  • Simulate Mobile Device: If selected, simulates the way the player appears in a mobile device
  • Preview Changes: Refreshes the current view to show changes

Basic Settings

Use Basic Settings window to set the player name, entry and aspect ratio.

 

 

Enter the following information:

Field

Description

Values

Player ID

This is the ID assigned to the new player automatically.

N/A

Player’s Name

Enter an informative Player Name (required).

 

Player Version

Select a TV Platform Player version – latest or beta. Beta allows you to experiment with new functionalities that will be released in the next version..  Latest will always update to the latest version unless you select “Keep Player on Current Version”.

Latest or Beta

Keep Player on Current Version

Prevents the player from automatically updating when a new version becomes available.

 

Select a Preview Video

Choose an entry/playlist to preview using the player. Some features may be dependent for specific entries.

A list of entries/playlists for your account. 

Last updated: 

Indicates the last time the player was updated

 

 

Back to top.

Playback Options

Next, select the Playback tab.

 

Set the following options:

 

Field

Description

Values

Apply User Preferences

Applies the settings previously set by the user

 

Captions Default Display

This is the default captions language. 

  • Off will not show captions at all.

  • Auto will use the user set preferences from local storage, browser language, or the default language.

  • Explicit requires entering a language code.

Preload

Load the video asset automatically when the page loads.

 

Autoplay

Play back the video automatically when the page loads.

 

Start Playback Muted

When playback begins, start video in muted mode.

 

Fallback to Muted Autoplay

Fall back to muted autoplay on browsers that block autoplay with sound.

 

 

Configuring the Player’s Analytics

Kaltura supports robust analytics via the Kaltura platform as well as via 3rd party analytics providers. The following analytics options are supported:

Kaltura Analytics - Statistics

Use Kaltura analytics to track Kaltura player events. Statistics are enabled by default. Configuration consists of adding additional tracking info.

Field Attribute Value Description
Track Event Monitor trackEventMonitor kalturaSendAnalyticEvent Enables you to audit Kaltura events with a named callback function.

 

Youbora Analytics

The Youbora plugin listens and reports all the different player states in the current video session to Youbora Analytics.
Youbora Real Time Analytics & Monitoring uses a plugin on every player on every device of every user to track and monitor all information relevant to every view (real time for VoD and live video).For additional information on Youbora Analytics see the Youbora Player Plugin Setup and Information Guide on the Knowledge Center.

Google Analytics

Google Analytics (GA) is a web analytics service that uses a combination of cookies and APIs to enter events into a tracking site. This plugin easily translates player events into GA beacons, and the collection of beacons can then provide an analysis of player actions. 

comScore Analytics

This plugin supports sending player analytics events to comScore, a customer data collection and reporting tool that enables advertisers, media companies and publishers to take decisions based on demographics of users.
 

To configure the player analytics settings

  1. Go to the Analytics section, select the checkbox for the analytics option you wish to use, and then click the down arrow to display the parameters and details.

  2. Select the analytics capabilities you wish to configure:
  • For Youbora, enter the your Youbora account ID in the Account code field:

  • For Google Analytics, enter your Google tracking code:

  • For comScore Analytics, enter the information according to the table below:

    Field Description

    Publisher ID

    Also called the Client ID, provided by comScore.

    Label Mapping

    A comma-separated list of name-source pairs.

    Persistent Labels

    A comma-separated list of name-value pairs that are treated as static values.

  • Click Save Player Settings.
  •  Back to top.

     

    Monetization - Configuring the Player Advertising Settings

    The Kaltura TV Platform Player currently supports IMA plugins to facilitate content monetization.

     

     

    Set the following IMA settings:

     

    Field Description

    Ad Tag URL

    Enter a URL for the advertising tag.

    Loading Timeout

    Set the timeout for loading ads (in milliseconds). If an ad can’t be loaded within this timeframe, load the video automatically.

    HTML Companions

    For each companion ad, specify the container Div ID and expected ad width/height. 

    Size Criteria

    Select the size criteria to apply to ads:

    • Select Exact Match (default) – Only companion that match the size of the companion ad slot exactly will be selected.

    • Select Near Match – Any companion that is close to the size of the companion ad slot can be selected.

    • Ignore Size - Size can be ignored when selection companion

     

    Back to top.

     

    Configuring the Player's Offline Capabilities

    The Offline Capabilities tab enables you to specify how the player behaves when it's not connected to the Internet.

    Select the checkbox "PWA" (progressive Web App), to apply the ability to download content and play it offline, on the browser itself, even when not connected online.

    Back to top.

     


    Configuring the Player's Advanced Settings

     

    The Advanced Settings enable seasoned developers to configure the player using the JSON file.

     

     

    To learn more, refer to the Kaltura-Player repository.

     

    CVAA and 508 Compliancy

    All Kaltura TV Platform Players are CVAA- and 508-compliant. Refer to the Kaltura TV Platform Player Information Guide Accessiblity Options section for details.

     

    Back to top.

    Document type: 
    Product version: 
    (4152 reads)