This topic describes the App UI Description file, required when submitting an application to the Samsung Apps TV Seller Office.
Application UI Description Template
(348.73 KB)
When submitting your application, you must include the Application UI Description created using the provided template file. The UI description documents your application UI and helps the QA certification team test the application efficiently. You must update and resubmit the application UI description file whenever you submit an application update.
ImportantUse the provided template file and follow the instructions in it. Do not add or remove content from the template, or modify the structure. By ensuring that your application UI description conforms to the template, you can ease and accelerate the testing required to approve your application for publication.
Application UI Description Structure
On the title slide, enter the application and content provider name. The revision history documents the changes made to the application UI description. Include the file version, date, list of changes, and author. You must also define the application version related to the file version.
The application UI description consists of the following parts:
UI structure: Illustrates the overall structure and navigation flow between application pages.
Use cases: Provides detailed instructions for using the main application features.
Menus and functions: Labels and describes the screen components for all application screens, using screenshots.
Remote control keys: Describes the remote control key functions.
Language options: Specifies whether the application language can be changed and how to do it.
NoteIf your application supports English, use English screenshots in the Application UI Description. If English is not supported, provide translations for all screen texts.
UI Structure
Use a flow graph, tree structure, or depth navigation diagram to illustrate the navigation between all screens in the application.
The UI structure diagram shows the overall structure of the application. It does not show or describe the content on individual screens.
NoteAll application screens and navigation paths must be included in the UI structure diagram. For clarity, show the application screens as named boxes, instead of using screenshots or photographs of the actual screens.
Use Cases
Describe the application functionality in detail, by dividing it into clear use cases. A use case is a specific and defined task the user can or must do, such as searching for content or playing a video. The use cases must cover the main functions or scenarios of the application. In addition to application-specific features, you must also describe any general user login, menu browsing, and in-app purchase features.
WarningDo not provide a list of application screens, describing what the user can do on each screen. Such information must be provided using screenshots in the Menus and Functions section.
The following guidelines apply to use case descriptions:
Label each use case with a title.
For each use case, describe the steps the user must perform to do the task. You can use text, figures, and screenshots in the descriptions.
Since the launch process is the same for all applications, do not describe how to launch the application.
Refer to application screens with the names you have defined for them in the UI structure diagram.
Use Case Description Method
Example
Using figures
Using text
Using screenshots
Table 1. Ways to describe use cases
Missing information is a major cause for application rejection. If your application includes any of the following features, you must provide additional information within the applicable use cases.
Application Feature
Required Information (missing information causes application rejection)
User login
Test account with a valid user ID and password
Device activation
Test account that permits an unlimited number of activated devices
Instructions for activating the device at an external website, if needed
In-app purchases
Valid credit card information for testing
Test account with funds available for making purchases
Valid coupon or promotional codes, if supported
Gaming
Cheat codes or master account for accessing all game levels
List of correct responses to any trivia questions
Smart View mobile integration
Mobile application package attached to the TV application submission
Instructions for connecting the mobile application to the TV
Geolocation or IP-restricted access
List of countries from which content can be accessed and permission to access the content through a VPN
Testing IP addresses added to allowed list
Table 2. Information required to avoid application rejection
ImportantThis part of the application UI description is a frequent cause for application rejection.
Make sure your use case descriptions are complete and include all the information needed for the QA certification team to fully verify each use case.
Menus and Functions
Use labeled screenshots to describe the UI elements and their functions on each application screen.
The following guidelines apply to menu and function descriptions:
Provide a screenshot of each screen defined in the UI structure diagram.
Label all clickable and non-clickable UI elements with names or numbers. If there are many elements, use number labels.
Accompany each screenshot with a table describing the UI elements. For clickable elements, describe what happens when the element is clicked.
Provide English translations for titles, headings, and button labels, if needed.
ImportantThis part of the application UI description is a frequent cause for application rejection.
Make sure your menu and function descriptions are complete. Providing only screenshots without function descriptions is not acceptable.
Remote Control Keys
List the key mappings for any remote control keys that have been mapped to custom functions in your application:
Special function keys, such as the color, "Info", and "Tool" keys
Standard remote control keys whose function has been modified or disabled (for example, if the "Volume Up" key is implemented to zoom in on an image)
WarningThe "Return" and "Exit" keys are designed to return to the previous screen or close the application. These functions are mandatory and common to all applications. Do not modify them.
Language Options
If the application supports multiple languages, describe how the user can switch the application language, such as by changing the TV language or country settings, or selecting the language within the application settings.
If the application does not support multiple languages, state that the application has no language options.
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.