top

Configuring TV Applications

This topic describes Web application configuration for privileges and features specific to Samsung TVs.

All Tizen Web applications contain a “config.xml” file. The file defines the Web application configuration, which consists of application information, such as version, features, and privileges available for the application. For more information, see Setting Project Properties and Configuring Applications.

This topic describes privileges and features specific to Samsung TVs. Many privileges and features available for mobile and wearable Web applications are also available for TV Web applications.

Privileges

To use security-sensitive APIs, you must declare the required privileges and sign your application with a certificate for the appropriate privilege level. You can add privileges to the “config.xml” file using the “Privileges” tab of the Configuration Editor in the Tizen Studio.

Figure 1. Adding privileges

Figure 1. Adding privileges

Tizen API

The following table lists the privileged Tizen APIs specific to TVs.

For more information on Tizen API privileges, see Security and API Privileges.

Table 1. Tizen API privileges
Privilege Level Related API
http://tizen.org/privilege/tv.audio Public TVAudioControl API
http://tizen.org/privilege/tv.channel TVChannel API
http://tizen.org/privilege/tv.display TVDisplayControl API
http://tizen.org/privilege/tv.inputdevice TVInputDevice API
http://tizen.org/privilege/tv.window TVWindow API

Samsung Product API

The following table lists the privileged Samsung Product APIs specific to TVs.

Table 2. Samsung Product API privileges
Privilege Level Related API
http://developer.samsung.com/privilege/allshare Public ASFService API
DeviceDiscovery API
Item API
Provider API
http://developer.samsung.com/privilege/billing Billing API
http://developer.samsung.com/privilege/drminfo Partner DrmInfo API
http://developer.samsung.com/privilege/drmplay Public setDrm() method of the AVPlay API
http://developer.samsung.com/privilege/microphone Microphone API
http://developer.samsung.com/privilege/network.public Network API
http://developer.samsung.com/privilege/productinfo ProductInfo API
http://developer.samsung.com/privilege/sso.partner Partner SSO API
http://developer.samsung.com/privilege/widgetdata Public WidgetData API

Features

Additional features can be configured by adding metadata and setting elements to the “config.xml” file.

Meta Data

Some features are implemented by adding key-value pairs to the metadata element. You can add meta data in the “Tizen” tab of the Configuration Editor in the Tizen Studio.

Figure 2. Adding meta data

Figure 2. Adding meta data

The following table lists the meta data keys available for TVs.

Table 3. Meta data
Key Value
(default in bold)
Supported Models Description
“http://samsung.com/tv/metadata/prelaunch.support” true
“false”
Since 2015 Enable or disable prelaunching.
The default value is “false” for 2015 models.
“http://samsung.com/tv/metadata/use.preview” JSON file path Since 2016 Content for Smart Hub Preview.
“http://samsung.com/tv/metadata/gamepad” Gamepad model name Require a specific gamepad model to be connected.
“http://samsung.com/tv/metadata/use.network” true
“false”
Since 2015 Enable or disable checking the network connection when the application is launched.
“http://samsung.com/tv/metadata/use.voiceguide” Since 2016 Enable or disable voice guide for the application, if the user has enabled it in the TV settings.
“http://samsung.com/tv/metadata/auto.update” Since 2015 Enable or disable automatically updating the application during regularly-scheduled updates.
“http://samsung.com/tv/metadata/force.update” “true”
false
2015 to 2016 Enable or disable automatically updating the application outside regularly-scheduled updates.

Other Settings

Some features are implemented using setting elements. You can add setting elements directly to the “config.xml” file using the “Source” tab of the Configuration Editor in the Tizen Studio.

The following table lists the available setting elements for TVs.

Table 4. Other settings
Element Value
(default in bold )
Description
<tizen:setting pointing-device-support='xxx' >
</tizen:setting>
enable
“disable”
Enable or disable interaction with the application using a mouse.