Do I need SmartMEDIA if I don’t deliver channels, I only want to provide VoD?

Contents

Baselines

Format of Configuration Files

Priority of Applying Configuration Parameters

Configuring Large-Screen Apps

Primary UI/UX Settings

Parameter Description

Apps for Android Mobile

In-App Loading Animation (optional)

Baselines

SmartLabs offers service operators a variety of applications for end-user devices that are compatible with the SmartTUBE solution — including set-top boxes, Smart TVs, mobile iOS/Android devices, and web browsers. The user interface (UI) and user experience (UX) of the SmartTUBE applications can be tailored to specific requirements using a set of configuration files outlined in this section.

Format of Configuration Files

Configuration files for the SmartTUBE applications are structured in JSON format. The composition of files and parameters for each SmartTUBE application varies based on the target device platform. You can find their description in the relevant subsections of Configuring &Customizing Apps section.

Priority of Applying Configuration Parameters

The sequence in which the configuration parameters are executed by the application is as outlined below:

  1. Default settings retrieved from the local file.
    1. Override settings retrieved from the local file.
    2. Override settings uploaded from the SmartTUBE Device Manager.
      1. Override settings retrieved from the local file.
      2. Override settings uploaded from the SmartTUBE Device Manager.
  2. Override settings retrieved from the local file.
  3. Override settings uploaded from the SmartTUBE Device Manager.

Local configuration files are installed with the app, stored locally on a device in the [app_container]\src\configs\ directory and adhere the following format:

{
// Start of default configuration settings

“param_1”: “value_1”,
“param_2”: “value_2”,
“set_of_params”: {
“param_3”: “value_3”,
“param_4”: “value_4”
},

// End of default configuration settings

“overrides”: { // Overriding settings for the configuration parameters above
“param_2”: “value_5”,
“set_of_params.param_3”: “value_6”
}
}

Utilizing the “overrides” section enables the safe testing of alternative parameter values while maintaining the default settings. For instance:

platform, string

Platform of the end-user device. Acceptable values: tizen, webos, cobalt, web.

platformVersion, number

Version of the end-user device’s platform

deviceType, string

Name of the end-user device’s type. The list of acceptable values is determined by the dictionary SmartTUBE Admin Console > Dictionaries > Device types.

tenant, string

Name of the tenant. The list of acceptable values is determined by the dictionary SmartTUBE Admin Console > Administration > Tenants.

authorized, boolean

Flag of the authorization status of a device

Note

Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted..

Caution!

Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted.
Changes to the setup.json file are applied only after the application is rebooted..

Parameter Description

Filter panel

The “filter” section in this case will look as follows:

urlArgs — parameters of content filtering

sort — sorting the content by:

  • name — the movie name
  • rating — the Default order field on the movie/series details page in the SmartTUBE Admin Console
  • startDate — the date when the movie became available for rental (in ascending order)
  • startDate desc (not a typo) — the date when the movie became available for rental (in descending order)
  • newRelease_desc — the movie release date

year — list of movie/series by production years. Examples of acceptable values: 2015 (one year), 2005,2007,2008 (several years), 2005-2015 (interval).

exclusive — indicates that this filter could be selected exclusively, i.e. other filters in the group are reset.

API Request Parameter Type Description Player
Shaka HLSJS Cobalt +
ExoPlayer
iOS Android
e=SESSION_START String Event type + + + + +
ste String Result of starting the stream / keep alive status:
LS — multicast Live TV stream started;
LE — multicast Live TV stream failed to start;
VODS — VoD stream started;
VODE — VoD stream failed to start.
DVRS​ — unicast DVR stream (PauseLive, TSTV, nPVR) started;
DVRE​ — unicast DVR stream (PauseLive, TSTV, nPVR) failed to start;
DVRLS​ — unicast Live TV (DVR stream) started;
DVRLE​ — unicast Live TV (DVR stream) failed to start.
+ + + + +
error String Description of the stream start error (code):
0: Stream Not Found
1: CAS: No Stream Keys
2: Codec Not Supported
3: Too Many Connections
4: Internal Server Error
5: Forbidden
6: Function Not Supported
7: Connection Timeout
8: Connection Terminated
9: Failed To Start
10: Invalid URL
11: Other errors
dt
ver
idc
String Device type + + + + +
String Client application / firmware version + + + + +
String Channel ID or content ID (movie name, local file name, YouTUBE content ID, etc.) + + + + +
url String URL of the content playlist/manifest + + + + +
idp Integer TV program ID (if the Live TV or DVR stream is played) + + + + +
btr Integer Average bitrate calculated by the video PES packet N/A N/A N/A N/A +
pbr Integer The bandwidth required for the current streams (total, in bit/sec). It takes into account the playback rate. + + + + +
dbr Integer Download bitrate N/A + + + +
abr Integer Available bitrates + + + + +
bdr Integer Buffer size (sec) + + + N/A ?
idpStart Unixtime Program start date (timestamp) + + + N/A +
idpEnd Unixtime Program end date (timestamp) + + + N/A +
fr Integer Number of frames (not fields) per second multiplied by 1000. For example, 24 fps is recorded as 24000 N/A N/A + N/A +
ibr Integer NOT USED: Not sent by devices. Incoming stream bitrate
bfu Integer Loading buffer occupancy (%)
cfg String Player configuration parameters +

CONTENTS
Sign-in
Sign-in with your SmartLabs Support Portal account credentials to see non-public articles.