This topic describes Web application configuration, especially for privileges and features specific to Samsung TVs and other devices. Many privileges and features available for mobile and wearable Web applications are also available for TV Web 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:
Application ID:
The Samsung TV SDK automatically creates an application ID, which uniquely identifies the application within the package.
Application icon:
File path for the launcher icon.
<icon src="Icon Path" />
HTML content:
File path for the start-up file of the Web application. By default, it is the "index.html" file in the root directory.
<content src="HTML Path" />
Privileges:
Tizen and Samsung Product APIs that handle platform and user-sensitive data require privileges that must be declared before the APIs can be used.
Meta data features:
Some features, such as prelaunching, are implemented by adding values to the <tizen:metadata> element.
Mouse support:
Interaction with the application using a mouse, is enabled by default. If you want to disable it for your application, add the following key and value to the <tizen:setting> element in the "config.xml" file:
In the Tizen Studio, you can edit the configuration file in 2 ways:
Web Configuration Editor:
You can easily set the project configuration (manifest) using a form editor, even if you have no experience in developing a Tizen Web application project.
Configuration source editor:
If you are fluent in the configuration file XML structure, you can modify the XML structure directly through the configuration source editor.
To use security-sensitive APIs, you must declare the required privileges by adding key-value pairs to the <tizen:privilege> element 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.
Tizen Web Device API Privileges
The following table lists the privileged Tizen APIs specific to Smart TVs and other devices commonly in brief.
Some features are implemented by adding key-value pairs to the <tizen:metadata> element. You can add meta data in the "Tizen" tab of the Configuration Editor in the Tizen Studio.
The following table lists the meta data keys available for Smart TVs and other devices.
Key
Value (default in bold)
Since
Description
http://samsung.com/tv/metadata/prelaunch.support
“true” “false”
Tizen 2.3 (2015)
Enable or disable prelaunching. The default value is “false” for 2015 models.
http://samsung.com/tv/metadata/use.network
Enable or disable checking the network connection when the application is launched.
http://samsung.com/tv/metadata/auto.update
Enable or disable automatically updating the application during regularly-scheduled updates.
http://samsung.com/tv/metadata/force.update
“true” “false”
Tizen 2.3 ~ 2.4 (2015 ~ 2016)
Enable or disable automatically updating the application outside regularly-scheduled updates.
Enable or disable voice guide for the application, if the user has enabled it in the TV settings.
Table 4. Meta data
NotePrelaunching and Smart Hub Preview are supported for Smart TV and hospitality display, not for signage display.
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.