top

Application UI Description

This topic describes the application UI description file, required when submitting an application to the Samsung Apps TV Seller Office.

When submitting your application, you must include an application UI description created using the provided template file. It documents your application UI and helps the QA certification team test the application efficiently. You must update and resubmit the application UI description whenever you submit an application update.

Important

Use the provided template file and follow the instructions in it. Do not add or remove content, or modify the structure. By ensuring that your application UI description conforms to the template, you 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:

  1. UI structure
    Illustrates the overall structure and navigation flow between application pages.

  2. Use cases
    Provides detailed instructions for using the main application features.

  3. Menus and functions
    Labels and describes the screen components for all application screens, using screenshots.

  4. Remote control keys
    Describes the remote control key functions.

  5. Language options
    Specifies whether the application language can be changed and how to do it.

Note

If 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.

Figure 1. Flow graph

Figure 1. Flow graph


Figure 2. Tree structure

Figure 2. Tree structure


Figure 3. Depth navigation

Figure 3. Depth navigation

Important

All 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.

Note

Do 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" part.

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.
Table 1. Ways to describe use cases
Use Case Description Method Example
Using figures Using figures
Using text Using text
Using screenshots Using screenshots

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.

Table 2. Information required to avoid application rejection
Application Feature Required Information
(missing information causes application rejection)
User login
  • Test account with a valid user ID and password
Device activation
  • Test account must permit an unlimited number of activated devices
  • Instructions for activating the device at an external Web site, if needed
In-app purchases
  • Valid credit card information for testing
  • Test account must have 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 trivia quiz 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 address added to access whitelist
    For more information, see "Samsung Apps TV Seller Office > Guide > Self Checklist".
Important

This 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.

Figure 4. Number labels

Figure 4. Number labels

Figure 5. Text labels

Figure 5. Text labels

Important

This 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)
Note

The "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.