This topic describes Web application configuration, especially for privileges and features specific to Samsung Signage's. Many privileges and features available for mobile and wearable Web applications are also available for SSSP applications.
All Tizen Web application projects must have a "config.xml" file in the project root directory. The configuration file is composed of XML elements, including the <widget>
element as its root. The configuration information is used when you install or run the Tizen Web application.
The "config.xml" file contains the following information:
<tizen:application id='{Package}.{Project Name}' ... />
<widget … version='{0-255}.{0-255}.{0-65535}' ... />
<icon src='Icon Path' />
<content src='HTML Path' />
<tizen privilege name='http://tizen.org/privilege/Privilege Name' /><tizen privilege name='http://developer.samsung.com/privilege/Privilege Name' />
metadata
element.<tizen:setting pointing-device-support='disable' />
In the Tizen Studio, you can edit the configuration file in 2 ways:
For more information, see Setting Project Properties and Configuring Applications.
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
The following table lists the privileged Tizen APIs specific to TVs.
For more information on Tizen API privileges, see Security and API Privileges.
Privilege | Level | Related API |
---|---|---|
http://tizen.org/privilege/tv.audio | Public | TVAudioControl 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 |
The following table lists the privileged Samsung Product APIs specific to SSSP.
Privilege | Level | Related API |
---|---|---|
http://developer.samsung.com/privilege/drmplay | Public | setDrm() method of the AVPlay API |
http://developer.samsung.com/privilege/network.public | Network API | |
http://developer.samsung.com/privilege/productinfo | ProductInfo API | |
http://developer.samsung.com/privilege/widgetdata | WidgetData API |
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
The following table lists the meta data keys available for TVs.
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 Signage 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. |