Applet/Timing Configuration - passing custom data and identifiers to the device

Have more questions? Submit a request

You can add a number of key-value pairs into the Applet in a form of config.

The config can be added while adding Timing or it can be bundled at the time you are building Core App with bundled Applet. This config can be device-specific and is widely used for passing your display identifiers (like displayId, DUID,...) into your Applet. These key-value pairs are then available within JS API under the sos object.   

// Parsed JSON object passed for current applet & current device together



How to add config via Box on Device Detail


  1. Open Box
  2. Navigate to the Device detail of your selected device
  3. Go to the Timing section
  4. Add/modify a Timing
  5. Within the form find the Configuration section
  6. Add your key-value pairs
  7. Save Timing

How to add config to bundled Applet with Core App


  1. Open Applet Detail
  2. Navigate to the App Builder tab
  3. Find your target platform
  4. Click on Add config row and add as many rows as you need
  5. Click Build

Once the building is done, you can see your bundled config below the download link.

How to add config via REST API

Use Timing REST API endpoint with proper values in BODY - configuration

	"deviceUid": "3ca8a8XXX589b",
	"appletUid": "ca212XXXee88c",
	"appletVersion": "1.0.0",
	"startsAt": "2018-09-12T10:02:21.123",
	"endsAt": "2018-09-12T11:02:21.123",
	"configuration": { "identification": "d157bcd63a" },
	"position": 1,
	"finishEventType": "IDLE_TIMEOUT",
	"finishEventData": "DURATION"

How to define mandatory and optional configuration

While building your Applet you can define mandatory and optional configuration in your package.json file. If you do so, the configuration will be rendered in the Box:



You can define multiple configuration in a config array. Each configuration item has the following definition:

Key Value type Description
name string name of the configuration
valueType string/URL/enum/number expected value type
list array of strings | numbers only for valueType enum, list of predefined options
mandatory boolean required to be filled before building applet or assigning applet
description string description shown in the UI to guide user
placeholder string field placeholder in the UI to guide user


// package.json "sos": { "config": [ { "name": "authToken", "valueType": "string", "mandatory": true, "description": "A token generated by My Control used for authentication against My cloud." }, { "name": "myBaseUrl", "valueType": "URL", "description": "A base URL to My cloud. No slash at the end required.", "placeholder": "" }, { "name": "playerDuration", "valueType": "string", "description": "A length of generated playlist in '##s' format (seconds).", "placeholder": "172800s" }, { "name": "refreshIntervalMs", "valueType": "number", "description": "Frequency of trying to generate new playlist from My cloud in milliseconds.", "placeholder": "65000", "min": 60000 }, { "name": "playerId", "valueType": "string", "description": "An identifier for the device used to identifying against AIR cloud. E.g. platform: SSSP, WEBOS, BRIGHTSIGN, ANDROID, WINDOWS, LINUX", "placeholder": "{PLATFORM}_{SERIAL_NUMBER}" }, { "name": "proxyUrl", "valueType": "URL", "description": "A prefix for all HTTP(s) requests done by My player to My cloud. Default is no proxy.", "placeholder": "" } ], "appletUid": "967daxxxxxxx58e27376a5596028" },

Typescript Interface:

interface GeneralConfigDefinition {
	placeholder?: string;
	description?: string;
	mandatory?: boolean;

interface StringConfigDefinition extends GeneralConfigDefinition {
	name: string;
	valueType: 'string';

interface UrlConfigDefinition extends GeneralConfigDefinition {
	name: string;
	valueType: 'URL';

interface EnumConfigDefinition extends GeneralConfigDefinition {
	name: string;
	valueType: 'enum';
	list: (string | number)[];

interface NumberConfigDefinition extends GeneralConfigDefinition {
	name: string;
	valueType: 'number';
	min?: number;
	max?: number;

export type IAppletVersionConfigDefinition = StringConfigDefinition | UrlConfigDefinition | EnumConfigDefinition | NumberConfigDefinition;
Was this article helpful?
0 out of 0 found this helpful