Filter
-
Content Type
-
Category
Mobile/Wearable
Visual Display
Digital Appliance
Platform
Recommendations
Filter
Learn Code Lab
codelabcreate a smartthings edge driver for an iot bulb objective learn how to create and customize an edge driver for an iot bulb to seamlessly interoperate on the smartthings platform overview smartthings is a platform for iot devices to communicate within its ecosystem, enabling smarter living solutions that simplify everybody else's way of life there are multiple methods to connect an iot device to the smartthings platform, one of which is through a smartthings hub hub connected devices connect to a smartthings-compatible hub using matter, zigbee, z-wave, or lan protocols the smartthings-compatible hub allows devices that utilize these protocols to integrate within the smartthings platform, permitting users to view and control devices from the smartthings app to automate actions and more the connection from a smartthings device to a smartthings hub is made possible with edge drivers smartthings edge drivers serve as translators between the protocols used by the device and the smartthings platform these drivers enable the devices to run locally on the hub, offering many benefits including speed, reliability, and enhanced functionality learn more about edge drivers in the smartthings edge architecture section set up your environment you will need the following host pc running on windows 10 or higher or ubuntu 20 04 x64 visual studio code latest version recommended devices connected on the same network android mobile device with smartthings app installed with android 10 or higher smartthings station or smartthings hub onboarded with samsung account philips hue bulb smartthings connected device sample code here is a sample code for this code lab download it and start your learning experience! edge driver sample code 6 1 kb install smartthings cli you need to install smartthings cli as this is the main tool for developing apps and drivers for smartthings edge drivers to install smartthings cli, open a web browser and download the smartthings msi installer from the latest release open the smartthings cli setup in the downloaded file, then click next accept the license agreement terms, then click next select the destination path for installation and click next to begin the installation process, click install notethe windows installer may display a warning titled windows protected your pc to continue the installation, click more info > run anyway complete the setup by clicking finish to verify if smartthings cli is installed correctly, open the command prompt and run this command smartthings --version view and run available commands for smartthings cli with this command smartthings --help for a full list of commands, visit the smartthings cli commands notethe smartthings cli supports an automatic login flow that launches a browser window, prompting the user to log in with a samsung account and grant the cli permissions to access the user's account start your project after downloading and extracting the sample code containing the project files, click file > open folder in visual studio code to open it locate the sample code directory and click select folder once finished, the project files are seen on the explorer menu set the bulb's color configuration in init lua, under the device_init function, write the code below to set the bulb's colors and its transition time local colorcontrol = clusters colorcontrol local philips_hue_colors = { {0xed, 0xc4}, -- red {0xae, 0xe3}, -- blue {0x2c, 0xc3}, -- yellow {0x53, 0xd3}, -- green {0xca, 0x08}, -- white } local index = 1 local transition_time = 0 --1/10ths of a second -- when sent with a command, these options mask and override bitmaps cause the command -- to take effect when the switch/light is off local options_mask = 0x01 local options_override = 0x01 device send colorcontrol server commands movetohueandsaturation device, philips_hue_colors[5][1], philips_hue_colors[5][2], transition_time, options_mask, options_override local timer = device thread call_on_schedule 1, function local hue = philips_hue_colors[index][1] local sat = philips_hue_colors[index][2] device send colorcontrol server commands movetohueandsaturation device, hue, sat, transition_time, options_mask, options_override index = index + 1 % 6 if index == 0 then index = 1 end end, "color_schedule_timer" save the file and open either the command prompt or terminal notemake sure that the path directory in your cli contains the project file build and upload your edge driver in the terminal, type the following command to build and upload your edge driver package to the smartthings cloud smartthings edge drivers package create a private channel create a new channel for your edge driver and enter the following channel details smartthings edge channels create channel name smartthings edge driver channel channel description channel for sdc2024 channel terms of service url www smartthings com enroll the smartthings hub in your channel enroll your hub in your newly created channel and select the corresponding channel and hub smartthings edge channels enroll assign the edge driver to your channel assign your driver to the created channel smartthings edge channels assign install the edge driver to your hub install the created edge driver from your channel to your own hub smartthings edge drivers install control the bulb via smartthings app on your mobile phone, launch the smartthings app and tap the + icon once you're on the add device page, tap scan nearby make sure that the philips light bulb is turned on wait for the light bulb to be visible once visible, tap done now, observe the blinking and changing colors of your bulb you're done! congratulations! you have successfully achieved the goal of this code lab now, you can create an edge driver for smartthings devices that can be integrated into the smartthings ecosystem! if you're having trouble, you may download this file edge driver complete code 8 6 kb to learn more about smartthings hub connected devices and edge drivers, visit smartthings hub connected devices smartthings edge driver documentation
Learn Code Lab
codelabtest edge drivers using smartthings test suite objective learn how to identify and resolve issues when deploying edge drivers using smartthings test suite overview smartthings test suite is a tool for testing iot device integrations within the smartthings platform this solution provides a seamless certification process, allowing developers of smartthings hub connected devices to submit their products for certification without the need for manual testing this accelerates the certification timeline and offers a more cost-effective path to certifying these devices the key feature of this self-testing tool is it contains an automated testing suite that covers critical certification criteria, ranging from functionality to performance tests the tool also provides real-time feedback that gives detailed information on the device's compliance status, allowing for quick identification and resolution of any issues lastly, it has an intuitive and user-friendly interface that ensures a seamless experience for developers of all levels set up your environment you will need the following host pc running on windows 10 or higher or ubuntu 20 04 x64 visual studio code latest version recommended devices connected on the same network android mobile device with smartthings app installed with android 10 or higher smartthings station or smartthings hub onboarded with samsung account smartthings v4 multipurpose sensor or lightify tunable white 60 light bulb notemake sure that your devices are connected to your smartthings app sample code here is a sample code for this code lab download it and start your learning experience! test suite sample code 185 4 kb install smartthings cli you need to install smartthings cli as this is the main tool for developing apps and drivers for smartthings edge drivers to install smartthings cli, open a web browser and download the smartthings msi installer from the latest release notefor other operating systems, download the appropriate zipped binary and install it on your system path open the smartthings cli setup in the downloaded file, then click next accept the license agreement terms, then click next select the destination path for installation and click next to begin the installation process, click install notethe windows installer may display a warning titled windows protected your pc to continue the installation, click more info > run anyway complete the setup by clicking finish to verify if smartthings cli is installed correctly, open the command prompt and run this command smartthings --version view and run available commands for smartthings cli with this command smartthings --help for a full list of commands, visit the smartthings cli commands notethe smartthings cli supports an automatic login flow that launches a browser window, prompting the user to log in with samsung account and grant the cli permissions to access the user's account start your project after downloading and extracting the sample code containing the project files, click file > open folder in visual studio code to open it locate the sample code file directory and click select folder once finished, the project files are seen on the explorer menu configure custom edge drivers open your command prompt or terminal and follow the corresponding instructions depending on your device availability make sure that the path directory in your cli contains the project file smartthings multipurpose sensor in the terminal, type the following command to build and upload your edge driver package to the smartthings cloud smartthings edge drivers package drivers/codelab-zigbee-contact create a new channel for your edge driver and enter the following channel details smartthings edge channels create channel name smartthings test suite demo channel description channel for sdc2024 channel terms of service url www smartthings com enroll your hub in your newly created channel and select the corresponding channel and hub smartthings edge channels enroll assign your driver to the created channel smartthings edge channels assign install the created edge driver from your channel to your own hub smartthings edge drivers install confirm that the correct version of the driver is present in your hub smartthings edge drivers installed select the edge driver for this device smartthings edge drivers switch lightify tunable white 60 bulb in the terminal, type the following command to build and upload your edge driver package to the smartthings cloud smartthings edge drivers package drivers/codelab-zigbee-switch create a new channel for your edge driver and enter the following channel details smartthings edge channels create channel name smartthings test suite demo channel description channel for sdc2024 channel terms of service url www smartthings com enroll your hub in your newly created channel and select the corresponding channel and hub smartthings edge channels enroll assign your driver to the created channel smartthings edge channels assign install the created edge driver from your channel to your own hub smartthings edge drivers install confirm that the correct version of the driver is present in your hub smartthings edge drivers installed select the edge driver for this device smartthings edge drivers switch test your device on your web browser, go to smartthings test suite, login to your samsung account and follow the corresponding instructions depending on your device availability smartthings multipurpose sensor on the test suite, look for your device, click menu icon > prepare new test under the compatible capabilities, select all capabilities except for battery, and click start during the test execution, perform the indicated user actions for every test case if there are any it might cause incorrect test results if user actions are not performed tipyou may view the real-time sensor states of the device in the smartthings mobile app view the test summary after the test it returns a failed test that you are going to resolve in the next step lightify tunable 60 white bulb on the test suite, look for your device, click menu icon > prepare new test under the compatible capabilities, select all capabilities after you've selected the capabilities, click start warningduring the test execution, observe the behavior of the bulb it might cause incorrect test results if automated tests are interrupted view the test summary after the test it returns a failed test that you are going to resolve in the next step resolve test failures smartthings multipurpose sensor the test logs contain basic information about the test results and specific test cases, providing technical context to users for efficient troubleshooting download the test logs by navigating to the bottom page of the test summary > show full test details > download log to understand the test logs, its structure follows this schema {execution timestamp} device node path node type [node state] {execution message} in the downloaded test log, two test cases failed with the following error [failed] initialize states following states were not set correctly [contact any other state than "open" on main contactsensor] [failed] send command and validate some events didn't happen [contact "closed" on main contactsensor] some states aren't final [contact "closed" on main contactsensor] in the first error log, it appears that the test suite cannot change the device's state to anything other than an open state in the second error log, the test suite tries to change its state to closed, but to no avail it is confirmed in the capability definition that the contact sensor has only two states open and closed therefore, the device is constantly in an open state and unable to change to a closed state with these information, you can start troubleshooting by going to drivers > codelab-zigbee-contact > multi-sensor > init lua and look for incorrect code implementation with these keywords open, closed, contactsensor it can be seen in the zone_status_change_handler and zone_status_handler functions that there are code blocks on comment this might be a result of someone developing this code have changed this part of code for debugging and forgot to uncomment this part uncomment this code block from zone_status_change_handler function if not device preferences["certifiedpreferences garagesensor"] then contactsensor_defaults ias_zone_status_change_handler driver, device, zb_rx end uncomment this code block from zone_status_handler function if not device preferences["certifiedpreferences garagesensor"] then contactsensor_defaults ias_zone_status_attr_handler driver, device, zone_status, zb_rx end remove this line of code from zone_status_change_handler and zone_status_handler functions device emit_event_for_endpoint zb_rx address_header src_endpoint_value, capabilities contactsensor contact open save the file and update the driver by invoking the same cli commands that were also used during the configuration of custom edge drivers smartthings edge drivers package drivers/codelab-zigbee-contact smartthings edge channels assign smartthings edge drivers install again, go to smartthings test suite, select your device, click menu > prepare new test ensure that all compatible capabilities are selected, with the exception for battery again, start the test and perform indicated user actions for every test case if there are any now, all tests are passed! lightify tunable white 60 bulb the test logs contain basic information about the test results and specific test cases, providing technical context to users for efficient troubleshooting download the test logs by navigating to the bottom page of the test summary > show full test details > download log to understand the test logs, its structure follows this schema {execution timestamp} device node path node type [node state] {execution message} in the downloaded test log, one test case failed with the following error [failed] send command and validate some events didn't happen [colortemperature maximum 7500k on main colortemperature] some states aren't final [colortemperature maximum 7500k on main colortemperature] in the error log, it directs to an issue for setting an incorrect maximum colortemperature value the configuration on your edge driver is set to 7500k you can start to troubleshoot by looking for the bulb's color temperature rating either from the device packaging or the device manufacturer website with these information, you can start troubleshooting by going to drivers > codelab-zigbee-switch > profiles > rgbw-bulb yml and look for lines that declares the colortemperature value change the colortemperature range declaration range [ 2700, 6500 ] save the file and update the driver by invoking the same cli commands that were also used during the configuration of custom edge drivers smartthings edge drivers package drivers/codelab-zigbee-switch smartthings edge channels assign smartthings edge drivers install again, go to smartthings test suite, select your device, click menu > prepare new test under the compatible capabilities, select all capabilities again, start the test and perform indicated user actions for every test case if there are any now, all tests are passed! you're done! congratulations! you have successfully achieved the goal of this code lab now, you can test your edge driver for smartthings devices using smartthings test suite! if you're having trouble, you may download this file test suite complete code 184 6 kb to learn more about smartthings test suite, visit smartthings edge architecture smartthings developer console
Develop Smart TV
doccommon this topic describes test cases and pass criteria related to common application features general test case id definition support tv htv signage co-ge-01 check that application pages load and the application responds to clicked keys within a reasonable amount of time yes yes yes the application responds in at most 30 seconds related info launch time optimization test case id definition support tv htv signage co-ge-02 check that the supported languages listed in the application description are properly supported yes yes yes all languages listed in the application description are supported test case id definition support tv htv signage co-ge-03 check that the application works normally after being left running for a long time yes yes yes after being left running for a long time, the application remains responsive and works normally test case id definition support tv htv signage co-ge-04 check that all menus and features are implemented as described in the application description yes yes yes all menus and features are implemented and work as described test case id definition support tv htv signage co-ge-05 close the application by clicking the exit key or the close button, then relaunch it from smart hub or apps panel check that the application works properly and does not initiate unnecessary content updates note test both the on-screen and the remote control exit keys yes yes yes the application runs normally unnecessary updates are not initiated related info terminating applications test case id definition support tv htv signage co-ge-06 check that the tv recovers from being switched off while content is loading yes yes yes while content is loading in the application, switch the tv off using the power key after a few seconds, click the power key again the tv switches on test case id definition support tv htv signage co-ge-07 after launching the application from the smart hub first screen or apps panel, check that application termination and multitasking works properly yes yes yes when the return or exit key is clicked, the application is terminated when the smart hub key is clicked, the application is moved to the background and the smart hub first screen is shown for tv models that do not support multitasking, when the smart hub key is clicked, the application is terminated and the smart hub first screen is shown related info multitasking, terminating applications test case id definition support tv htv signage co-ge-08 during media playback, switch off the device when the device is switched on again, check that the application's previous screen or detail page is shown yes no yes the application's previous screen or detail page is shown related info multitasking connection test case id definition support tv htv signage co-cn-01 after network disconnection and reconnection, including during media playback, check that the application resumes working normally yes yes yes the application does not freeze when the network connection is lost if the network is disconnected and reconnected, while the application is launching, it is not stuck on loading and the return key is functional when the network is reconnected, the network disconnected message is dismissed related info checking network status test case id definition support tv htv signage co-cn-02 if the network connection is lost while the application is running, including during media playback, check that a notification message is shown yes yes yes when the network connection is lost, a message is shown when the network disconnected message is shown, the application does not lock up the device or cause it to reboot related info checking network status noteif your application content cannot be accessed due to http client or server issues, you must show a clear error message with information on what to do or who to contact for support remember that samsung cannot provide support to tv users with issues related to content availability within your application test case id definition support tv htv signage co-cn-03 while loading or buffering content, check that a loading or progress indicator is shown yes yes yes a loading or progress indicator is present related info progress indicators installation test case id definition support tv htv signage co-in-01 for 2016 and newer models, if the application supports smart hub preview, check that during installation, the application icon and preview can be automatically added to the smart hub apps preview yes yes no when installing the application, if "add to home" is selected, the application icon and preview are added to the smart hub apps preview test case id definition support tv htv signage co-in-02 check that the application can be run immediately after installation yes yes yes after installing the application, when "run now" or the application icon in smart hub is clicked, the application launches test case id definition support tv htv signage co-in-03 if the application requires privileges, on the application details page, check that the following paragraph is shown below the "install" button "check the app permissions by selecting more in the information area by selecting install, you agree to grant those permissions to this app " yes yes yes on the application details page, the required text is present test case id definition support tv htv signage co-in-04 if the application requires privileges, check that the privileges required by the application match those listed on the application details page yes yes yes the privileges required by the application match those listed on the application details page related info configuring web applications keyboard/ime test case id definition support tv htv signage co-ki-01 when using the samsung ime, if the entered text exceeds the character limit, check that the application works properly yes yes yes exceeding the character limit does not cause unexpected behavior or lock up the device test case id definition support tv htv signage co-ki-02 when entering text, check that the text does not overflow the bounds of the input box yes yes yes the entered text stays inside the input box test case id definition support tv htv signage co-ki-03 when the samsung or application ime language is changed, check that the ime is changed accordingly yes yes yes language-specific characters are input correctly test case id definition support tv htv signage co-ki-04 check that special characters and spacing can be input and displayed correctly in the application yes yes yes special character input does not cause the application to freeze or crash special characters are displayed correctly special character input stays inside the input box search works properly with special characters related info keyboard/ime test case id definition support tv htv signage co-ki-05 when using the samsung ime with the xt9 predictive text feature, if the entered word exceeds the 64-character length limit, check that the application works properly yes yes yes exceeding the character limit does not cause unexpected behavior or lock up the device test case id definition support tv htv signage co-ki-06 connect a physical keyboard to the device and launch the application if the application does not support external keyboards, only the keyboard keys with remote control key equivalents are functional yes yes yes only the keyboard keys with remote control key equivalents are functional related info keyboard/ime test case id definition support tv htv signage co-ki-07 while the application is running, connect, disconnect, and reconnect a physical keyboard to the device check that the keyboard works properly yes yes yes the physical keyboard is detected properly keyboard input works properly related info keyboard/ime test case id definition support tv htv signage co-ki-08 if the application supports physical keyboards, check that all keyboard characters can be input correctly, including modified characters note when modifier keys such as "ctrl" and "altgr" are pressed, the virtual ime does not show the modified characters yes yes yes all keyboard characters can be input correctly, including modified characters related info keyboard/ime test case id definition support tv htv signage co-ki-09 if the application implements special functions for specific keyboard keys, check that they work as described in the application description yes yes yes keyboard keys with special functions work as described related info keyboard/ime test case id definition support tv htv signage co-ki-10 connect a physical keyboard to the device and launch the application check that the keyboard keys with remote control key equivalents work correctly note during text input, these keys can function as normal keyboard keys instead of remote control keys yes yes yes when the keyboard key is clicked, the corresponding remote control key function, if applicable, is activated related info keyboard/ime multitasking test case id definition support tv htv signage co-mt-01 during media playback, send the application to the background by clicking the smart hub key check that the application resumes properly from the apps panel or the smart hub first screen yes no no when the application resumes, media playback resumes in the same state as before, or the application shows the previous page if the application implements a shortcut key for resuming playback, it works properly related info multitasking test case id definition support tv htv signage co-mt-02 while viewing a tv channel, launch the application click the smart hub key to send the application to the background check that the same tv channel is shown yes no no the same tv channel is shown before launching the application and after sending it to the background related info multitasking test case id definition support tv htv signage co-mt-03 during media playback, click the smart hub key to send the application to the background disconnect and reconnect the network, then resume the application check that media playback resumes correctly yes no no after resuming the application, audio and video playback work normally related info multitasking test case id definition support tv htv signage co-mt-04 while the application is in use, such as during media playback or showing a detail page, send the application to the background uninstall and reinstall the application check that the application is reinitialized yes no no after reinstalling the application, when it is launched, it opens to the first page prelaunching test case id definition support tv htv signage co-pl-01 for tv models that support prelaunching, check that it works properly add the application to the left side of the smart hub launcher and power cycle the tv after 3 minutes, launch the application yes no no after the tv has been switched back on, the audio and video work properly the application launches immediately without showing a loading screen when the application is launched, it works normally related info prelaunching applications privacy test case id definition support tv htv signage co-pr-01 check that all personally-identifiable information is deleted with application deletion the term "personally-identifiable information" is used as defined in the online privacy protection act yes yes yes after deleting the application, reinstall it no personally-identifiable information from the previous installation is available search test case id definition support tv htv signage co-se-01 check that searching with an empty search box is handled appropriately yes yes no a "no search results" message is shown the application does not crash test case id definition support tv htv signage co-se-02 check that keyword search finds keyword-related results yes yes no keyword search finds results related to the keyword in addition to those containing the keyword slideshow test case id definition support tv htv signage co-sl-01 check that the slideshow transition time setting is applied properly yes yes no the slideshow transition time is applied properly test case id definition support tv htv signage co-sl-02 check that slideshow transition effects such as fade, puzzle, or random are applied properly yes yes no slideshow transition effects are applied properly test case id definition support tv htv signage co-sl-03 when a slideshow reaches the end, check that it repeats properly yes yes no the slideshow repeats from the beginning the slideshow does not cause the application to crash test case id definition support tv htv signage co-sl-04 when creating a slideshow from selected images or image categories, check that the selected images are shown yes yes no during image selection, the application does not crash only the selected images are included in the slideshow test case id definition support tv htv signage co-sl-05 when launching a slideshow, check that all images can be loaded yes yes no all slideshow images can be loaded test case id definition support tv htv signage co-sl-06 during a slideshow, check that the user can browse through the images using the arrow keys or other assigned keys yes yes no slideshow images can be browsed using the arrow keys or other assigned keys sound test case id definition support tv htv signage co-so-01 if the application uses the samsung osd, after clicking various remote control keys except the return, exit, and search keys , check that the volume and mute keys work properly yes yes yes lfd only the sound bar displays the correct volume level if mute is switched on, it stays on when entering or exiting the application test case id definition support tv htv signage co-so-02 check that volume controls work properly in the application yes yes yes the sound output is adjustable throughout an appropriate range when the volume keys are clicked, mute is not switched on or off test case id definition support tv htv signage co-so-03 check that running the application switches off the tv channel audio yes yes yes lfd only while the application is running, the tv channel audio cannot be heard test case id definition support tv htv signage co-so-04 switch mute on, then launch the application check that mute works properly in the application yes yes yes sound is muted only 1 copy of the mute ui is shown while muted, when the application is closed, mute stays switched on while muted, when the mute key or the volume keys are clicked, mute is switched off test case id definition support tv htv signage co-so-05 check that the mute and volume uis are functional yes yes yes the mute and volume keys are functional the appropriate mute or volume ui is shown test case id definition support tv htv signage co-so-06 check that mute is not unintentionally switched on when launching or closing the application yes yes yes if mute is switched off, when the application is closed, mute stays switched off test case id definition support tv htv signage co-so-07 launch the application, then switch mute on check that mute works properly yes yes yes when the mute key or the volume keys are clicked, mute is switched off while mute is switched on, when the application is closed, mute stays on and the mute ui is shown ui test case id definition support tv htv signage co-ui-01 check that the application icon displays properly in smart hub or apps panel yes yes yes the icon is shown in smart hub properly the icon and name do not overlap the icon is the correct size the icon is identical in samsung apps and in smart hub the icon highlight is consistent with that of other application icons related info app icon test case id definition support tv htv signage co-ui-02 check that the help bar keys are shown in the correct order yes yes yes lfd only the help bar keys are shown in the following order color keys red a , green b , yellow c , and blue d playback control keystools keyarrow keysenter keyreturn key test case id definition support tv htv signage co-ui-03 hover the cursor over the application icon in the smart hub apps preview check that the preview panel and its deep links work properly yes yes no the preview tiles display properly when a preview tile is clicked, the indicated content or detail page in the application launches directly related info smart hub preview test case id definition support tv htv signage co-ui-04 check that list or content navigation using the arrow keys works properly yes yes yes lfd only the focus can move between all items in a list when the focus moves to the beginning or ending of a list or content, the arrow keys for directions in which it is not possible to navigate are deactivated the focus does not disappear related info remote control test case id definition support tv htv signage co-ui-05 check that ui elements do not move around unintentionally when remote control keys are clicked yes yes yes lfd only the ui elements stay in place test case id definition support tv htv signage co-ui-06 check that focus can be moved to all selectable parts of the ui yes yes yes focus can be moved to all selectable parts of the ui test case id definition support tv htv signage co-ui-07 when entering and leaving the page multiple times, using the enter and return keys, check that the ui works properly yes yes yes lfd only the ui is shown correctly no error messages appear the application does not crash, nor causes the device to lock up or reboot test case id definition support tv htv signage co-ui-08 check that all ui text, including special characters and symbols, is displayed properly yes yes yes all ui text is displayed properly special characters and symbols are not corrupted all html code is valid and rendered correctly test case id definition support tv htv signage co-ui-09 when the arrow keys are clicked multiple times, check that the ui works properly yes yes no the ui is shown correctly the ui elements do not unintentionally move around or overlap the focus does not disappear there is no double focus the application does not crash, nor causes the device to lock up or reboot test case id definition support tv htv signage co-ui-10 if the application has multiple category pages, check that the arrow keys navigate between the pages properly yes yes no all category pages can be selected when a category is selected, the correct page is shown test case id definition support tv htv signage co-ui-11 on pages with too much content to fit on 1 screen, check that the full content can be viewed using a scroll bar yes yes yes the scroll bar is displayed properly the scroll bar is functional related info position indicators test case id definition support tv htv signage co-ui-12 check that the control buttons on scroll bars are displayed properly yes yes yes the control buttons on scroll bars are displayed properly related info position indicators test case id definition support tv htv signage co-ui-13 check that image thumbnails are displayed properly if the media has no image, or the image is not supported, check that an alternative image is shown yes yes no image thumbnails are displayed properly if the media has no video image, or the image is not supported, an alternative image is shown user controls test case id definition support tv htv signage co-us-01 in the application, check that all remote control keys work properly yes yes yes lfd only in the application, all remote control keys function properly, including during media playback if the remote control has a search key, clicking it closes the application and shows the search box on the tv channel screen for 2014 models, the search box is shown in the following locations on tvs on the application screenon bd players on the main menuon bd pvrs on the dtv screenif there are keys which are not defined in the application description, they must not respond to clicks the screen does not flicker when keys are clicked while video playback is paused, skipping the video forward or backward does not cause double focus related info remote control test case id definition support tv htv signage co-us-02 while loading or buffering media content, check that the remote control keys work properly yes yes yes lfd only when the remote control keys are clicked, the application does not lock up the device or cause it to reboot when the return key is clicked, the focus does not disappear when the return key is clicked, the application goes back to the previous page when the stop key is clicked, playback is stopped when the return or stop key is clicked, the loading indicator disappears related info remote control test case id definition support tv htv signage co-us-03 check that all help bar keys work properly yes yes yes lfd only all help bar keys work as described test case id definition support tv htv signage co-us-04 check that the exit key works correctly yes yes yes lfd only if a popup or the ime is open, clicking the exit key closes it the exit key works during media playback on an application page, clicking the exit key closes the application and shows the tv channel screen the tv channel outputs normally on bd players, clicking the exit key closes the application and shows the main menu related info remote control test case id definition support tv htv signage co-us-05 check that the return key works according to the return key policy yes yes yes lfd only if a popup is open, clicking the return key closes the popup on an application page, clicking the return key goes to the previous page on the application home page, clicking the return key closes the application and shows the smart hub since 2016 models, on the application home page, clicking the return key closes the application and shows the tv channel screen launch the application from the samsung apps screen clicking the return key closes the application and shows the smart hub related info terminating applications test case id definition support tv htv signage co-us-06 check that the channel list, channel guide, and number keys work properly yes yes no when the channel list, channel guide, and number keys are clicked, unexpected behavior does not occur if the number keys are assigned to actions in the application description, they work as described related info remote control test case id definition support tv htv signage co-us-07 check that the color red, yellow, green, and blue keys work as described in the application description yes yes no the color keys work as described in the application description if the color keys are not assigned to actions, they do not respond to clicks related info remote control
Develop Smart Signage
doccommon this topic describes test cases and pass criteria related to common application features general test case id definition support tv htv signage co-ge-01 check that application pages load and the application responds to clicked keys within a reasonable amount of time yes yes yes the application responds in at most 30 seconds related info launch time optimization test case id definition support tv htv signage co-ge-02 check that the supported languages listed in the application description are properly supported yes yes yes all languages listed in the application description are supported test case id definition support tv htv signage co-ge-03 check that the application works normally after being left running for a long time yes yes yes after being left running for a long time, the application remains responsive and works normally test case id definition support tv htv signage co-ge-04 check that all menus and features are implemented as described in the application description yes yes yes all menus and features are implemented and work as described test case id definition support tv htv signage co-ge-05 close the application by clicking the exit key or the close button, then relaunch it from smart hub or apps panel check that the application works properly and does not initiate unnecessary content updates note test both the on-screen and the remote control exit keys yes yes yes the application runs normally unnecessary updates are not initiated related info terminating applications test case id definition support tv htv signage co-ge-06 check that the tv recovers from being switched off while content is loading yes yes yes while content is loading in the application, switch the tv off using the power key after a few seconds, click the power key again the tv switches on test case id definition support tv htv signage co-ge-07 after launching the application from the smart hub first screen or apps panel, check that application termination and multitasking works properly yes yes yes when the return or exit key is clicked, the application is terminated when the smart hub key is clicked, the application is moved to the background and the smart hub first screen is shown for tv models that do not support multitasking, when the smart hub key is clicked, the application is terminated and the smart hub first screen is shown related info multitasking, terminating applications test case id definition support tv htv signage co-ge-08 during media playback, switch off the device when the device is switched on again, check that the application's previous screen or detail page is shown yes no yes the application's previous screen or detail page is shown related info multitasking connection test case id definition support tv htv signage co-cn-01 after network disconnection and reconnection, including during media playback, check that the application resumes working normally yes yes yes the application does not freeze when the network connection is lost if the network is disconnected and reconnected, while the application is launching, it is not stuck on loading and the return key is functional when the network is reconnected, the network disconnected message is dismissed related info checking network status test case id definition support tv htv signage co-cn-02 if the network connection is lost while the application is running, including during media playback, check that a notification message is shown yes yes yes when the network connection is lost, a message is shown when the network disconnected message is shown, the application does not lock up the device or cause it to reboot related info checking network status noteif your application content cannot be accessed due to http client or server issues, you must show a clear error message with information on what to do or who to contact for support remember that samsung cannot provide support to tv users with issues related to content availability within your application test case id definition support tv htv signage co-cn-03 while loading or buffering content, check that a loading or progress indicator is shown yes yes yes a loading or progress indicator is present related info progress indicators installation test case id definition support tv htv signage co-in-01 for 2016 and newer models, if the application supports smart hub preview, check that during installation, the application icon and preview can be automatically added to the smart hub apps preview yes yes no when installing the application, if "add to home" is selected, the application icon and preview are added to the smart hub apps preview test case id definition support tv htv signage co-in-02 check that the application can be run immediately after installation yes yes yes after installing the application, when "run now" or the application icon in smart hub is clicked, the application launches test case id definition support tv htv signage co-in-03 if the application requires privileges, on the application details page, check that the following paragraph is shown below the "install" button "check the app permissions by selecting more in the information area by selecting install, you agree to grant those permissions to this app " yes yes yes on the application details page, the required text is present test case id definition support tv htv signage co-in-04 if the application requires privileges, check that the privileges required by the application match those listed on the application details page yes yes yes the privileges required by the application match those listed on the application details page related info configuring web applications keyboard/ime test case id definition support tv htv signage co-ki-01 when using the samsung ime, if the entered text exceeds the character limit, check that the application works properly yes yes yes exceeding the character limit does not cause unexpected behavior or lock up the device test case id definition support tv htv signage co-ki-02 when entering text, check that the text does not overflow the bounds of the input box yes yes yes the entered text stays inside the input box test case id definition support tv htv signage co-ki-03 when the samsung or application ime language is changed, check that the ime is changed accordingly yes yes yes language-specific characters are input correctly test case id definition support tv htv signage co-ki-04 check that special characters and spacing can be input and displayed correctly in the application yes yes yes special character input does not cause the application to freeze or crash special characters are displayed correctly special character input stays inside the input box search works properly with special characters related info keyboard/ime test case id definition support tv htv signage co-ki-05 when using the samsung ime with the xt9 predictive text feature, if the entered word exceeds the 64-character length limit, check that the application works properly yes yes yes exceeding the character limit does not cause unexpected behavior or lock up the device test case id definition support tv htv signage co-ki-06 connect a physical keyboard to the device and launch the application if the application does not support external keyboards, only the keyboard keys with remote control key equivalents are functional yes yes yes only the keyboard keys with remote control key equivalents are functional related info keyboard/ime test case id definition support tv htv signage co-ki-07 while the application is running, connect, disconnect, and reconnect a physical keyboard to the device check that the keyboard works properly yes yes yes the physical keyboard is detected properly keyboard input works properly related info keyboard/ime test case id definition support tv htv signage co-ki-08 if the application supports physical keyboards, check that all keyboard characters can be input correctly, including modified characters note when modifier keys such as "ctrl" and "altgr" are pressed, the virtual ime does not show the modified characters yes yes yes all keyboard characters can be input correctly, including modified characters related info keyboard/ime test case id definition support tv htv signage co-ki-09 if the application implements special functions for specific keyboard keys, check that they work as described in the application description yes yes yes keyboard keys with special functions work as described related info keyboard/ime test case id definition support tv htv signage co-ki-10 connect a physical keyboard to the device and launch the application check that the keyboard keys with remote control key equivalents work correctly note during text input, these keys can function as normal keyboard keys instead of remote control keys yes yes yes when the keyboard key is clicked, the corresponding remote control key function, if applicable, is activated related info keyboard/ime multitasking test case id definition support tv htv signage co-mt-01 during media playback, send the application to the background by clicking the smart hub key check that the application resumes properly from the apps panel or the smart hub first screen yes no no when the application resumes, media playback resumes in the same state as before, or the application shows the previous page if the application implements a shortcut key for resuming playback, it works properly related info multitasking test case id definition support tv htv signage co-mt-02 while viewing a tv channel, launch the application click the smart hub key to send the application to the background check that the same tv channel is shown yes no no the same tv channel is shown before launching the application and after sending it to the background related info multitasking test case id definition support tv htv signage co-mt-03 during media playback, click the smart hub key to send the application to the background disconnect and reconnect the network, then resume the application check that media playback resumes correctly yes no no after resuming the application, audio and video playback work normally related info multitasking test case id definition support tv htv signage co-mt-04 while the application is in use, such as during media playback or showing a detail page, send the application to the background uninstall and reinstall the application check that the application is reinitialized yes no no after reinstalling the application, when it is launched, it opens to the first page prelaunching test case id definition support tv htv signage co-pl-01 for tv models that support prelaunching, check that it works properly add the application to the left side of the smart hub launcher and power cycle the tv after 3 minutes, launch the application yes no no after the tv has been switched back on, the audio and video work properly the application launches immediately without showing a loading screen when the application is launched, it works normally related info prelaunching applications privacy test case id definition support tv htv signage co-pr-01 check that all personally-identifiable information is deleted with application deletion the term "personally-identifiable information" is used as defined in the online privacy protection act yes yes yes after deleting the application, reinstall it no personally-identifiable information from the previous installation is available search test case id definition support tv htv signage co-se-01 check that searching with an empty search box is handled appropriately yes yes no a "no search results" message is shown the application does not crash test case id definition support tv htv signage co-se-02 check that keyword search finds keyword-related results yes yes no keyword search finds results related to the keyword in addition to those containing the keyword slideshow test case id definition support tv htv signage co-sl-01 check that the slideshow transition time setting is applied properly yes yes no the slideshow transition time is applied properly test case id definition support tv htv signage co-sl-02 check that slideshow transition effects such as fade, puzzle, or random are applied properly yes yes no slideshow transition effects are applied properly test case id definition support tv htv signage co-sl-03 when a slideshow reaches the end, check that it repeats properly yes yes no the slideshow repeats from the beginning the slideshow does not cause the application to crash test case id definition support tv htv signage co-sl-04 when creating a slideshow from selected images or image categories, check that the selected images are shown yes yes no during image selection, the application does not crash only the selected images are included in the slideshow test case id definition support tv htv signage co-sl-05 when launching a slideshow, check that all images can be loaded yes yes no all slideshow images can be loaded test case id definition support tv htv signage co-sl-06 during a slideshow, check that the user can browse through the images using the arrow keys or other assigned keys yes yes no slideshow images can be browsed using the arrow keys or other assigned keys sound test case id definition support tv htv signage co-so-01 if the application uses the samsung osd, after clicking various remote control keys except the return, exit, and search keys , check that the volume and mute keys work properly yes yes yes lfd only the sound bar displays the correct volume level if mute is switched on, it stays on when entering or exiting the application test case id definition support tv htv signage co-so-02 check that volume controls work properly in the application yes yes yes the sound output is adjustable throughout an appropriate range when the volume keys are clicked, mute is not switched on or off test case id definition support tv htv signage co-so-03 check that running the application switches off the tv channel audio yes yes yes lfd only while the application is running, the tv channel audio cannot be heard test case id definition support tv htv signage co-so-04 switch mute on, then launch the application check that mute works properly in the application yes yes yes sound is muted only 1 copy of the mute ui is shown while muted, when the application is closed, mute stays switched on while muted, when the mute key or the volume keys are clicked, mute is switched off test case id definition support tv htv signage co-so-05 check that the mute and volume uis are functional yes yes yes the mute and volume keys are functional the appropriate mute or volume ui is shown test case id definition support tv htv signage co-so-06 check that mute is not unintentionally switched on when launching or closing the application yes yes yes if mute is switched off, when the application is closed, mute stays switched off test case id definition support tv htv signage co-so-07 launch the application, then switch mute on check that mute works properly yes yes yes when the mute key or the volume keys are clicked, mute is switched off while mute is switched on, when the application is closed, mute stays on and the mute ui is shown ui test case id definition support tv htv signage co-ui-01 check that the application icon displays properly in smart hub or apps panel yes yes yes the icon is shown in smart hub properly the icon and name do not overlap the icon is the correct size the icon is identical in samsung apps and in smart hub the icon highlight is consistent with that of other application icons related info app icon test case id definition support tv htv signage co-ui-02 check that the help bar keys are shown in the correct order yes yes yes lfd only the help bar keys are shown in the following order color keys red a , green b , yellow c , and blue d playback control keystools keyarrow keysenter keyreturn key test case id definition support tv htv signage co-ui-03 hover the cursor over the application icon in the smart hub apps preview check that the preview panel and its deep links work properly yes yes no the preview tiles display properly when a preview tile is clicked, the indicated content or detail page in the application launches directly related info smart hub preview test case id definition support tv htv signage co-ui-04 check that list or content navigation using the arrow keys works properly yes yes yes lfd only the focus can move between all items in a list when the focus moves to the beginning or ending of a list or content, the arrow keys for directions in which it is not possible to navigate are deactivated the focus does not disappear related info remote control test case id definition support tv htv signage co-ui-05 check that ui elements do not move around unintentionally when remote control keys are clicked yes yes yes lfd only the ui elements stay in place test case id definition support tv htv signage co-ui-06 check that focus can be moved to all selectable parts of the ui yes yes yes focus can be moved to all selectable parts of the ui test case id definition support tv htv signage co-ui-07 when entering and leaving the page multiple times, using the enter and return keys, check that the ui works properly yes yes yes lfd only the ui is shown correctly no error messages appear the application does not crash, nor causes the device to lock up or reboot test case id definition support tv htv signage co-ui-08 check that all ui text, including special characters and symbols, is displayed properly yes yes yes all ui text is displayed properly special characters and symbols are not corrupted all html code is valid and rendered correctly test case id definition support tv htv signage co-ui-09 when the arrow keys are clicked multiple times, check that the ui works properly yes yes no the ui is shown correctly the ui elements do not unintentionally move around or overlap the focus does not disappear there is no double focus the application does not crash, nor causes the device to lock up or reboot test case id definition support tv htv signage co-ui-10 if the application has multiple category pages, check that the arrow keys navigate between the pages properly yes yes no all category pages can be selected when a category is selected, the correct page is shown test case id definition support tv htv signage co-ui-11 on pages with too much content to fit on 1 screen, check that the full content can be viewed using a scroll bar yes yes yes the scroll bar is displayed properly the scroll bar is functional related info position indicators test case id definition support tv htv signage co-ui-12 check that the control buttons on scroll bars are displayed properly yes yes yes the control buttons on scroll bars are displayed properly related info position indicators test case id definition support tv htv signage co-ui-13 check that image thumbnails are displayed properly if the media has no image, or the image is not supported, check that an alternative image is shown yes yes no image thumbnails are displayed properly if the media has no video image, or the image is not supported, an alternative image is shown user controls test case id definition support tv htv signage co-us-01 in the application, check that all remote control keys work properly yes yes yes lfd only in the application, all remote control keys function properly, including during media playback if the remote control has a search key, clicking it closes the application and shows the search box on the tv channel screen for 2014 models, the search box is shown in the following locations on tvs on the application screenon bd players on the main menuon bd pvrs on the dtv screenif there are keys which are not defined in the application description, they must not respond to clicks the screen does not flicker when keys are clicked while video playback is paused, skipping the video forward or backward does not cause double focus related info remote control test case id definition support tv htv signage co-us-02 while loading or buffering media content, check that the remote control keys work properly yes yes yes lfd only when the remote control keys are clicked, the application does not lock up the device or cause it to reboot when the return key is clicked, the focus does not disappear when the return key is clicked, the application goes back to the previous page when the stop key is clicked, playback is stopped when the return or stop key is clicked, the loading indicator disappears related info remote control test case id definition support tv htv signage co-us-03 check that all help bar keys work properly yes yes yes lfd only all help bar keys work as described test case id definition support tv htv signage co-us-04 check that the exit key works correctly yes yes yes lfd only if a popup or the ime is open, clicking the exit key closes it the exit key works during media playback on an application page, clicking the exit key closes the application and shows the tv channel screen the tv channel outputs normally on bd players, clicking the exit key closes the application and shows the main menu related info remote control test case id definition support tv htv signage co-us-05 check that the return key works according to the return key policy yes yes yes lfd only if a popup is open, clicking the return key closes the popup on an application page, clicking the return key goes to the previous page on the application home page, clicking the return key closes the application and shows the smart hub since 2016 models, on the application home page, clicking the return key closes the application and shows the tv channel screen launch the application from the samsung apps screen clicking the return key closes the application and shows the smart hub related info terminating applications test case id definition support tv htv signage co-us-06 check that the channel list, channel guide, and number keys work properly yes yes no when the channel list, channel guide, and number keys are clicked, unexpected behavior does not occur if the number keys are assigned to actions in the application description, they work as described related info remote control test case id definition support tv htv signage co-us-07 check that the color red, yellow, green, and blue keys work as described in the application description yes yes no the color keys work as described in the application description if the color keys are not assigned to actions, they do not respond to clicks related info remote control
Develop Smart Hospitality Display
doccommon this topic describes test cases and pass criteria related to common application features general test case id definition support tv htv signage co-ge-01 check that application pages load and the application responds to clicked keys within a reasonable amount of time yes yes yes the application responds in at most 30 seconds related info launch time optimization test case id definition support tv htv signage co-ge-02 check that the supported languages listed in the application description are properly supported yes yes yes all languages listed in the application description are supported test case id definition support tv htv signage co-ge-03 check that the application works normally after being left running for a long time yes yes yes after being left running for a long time, the application remains responsive and works normally test case id definition support tv htv signage co-ge-04 check that all menus and features are implemented as described in the application description yes yes yes all menus and features are implemented and work as described test case id definition support tv htv signage co-ge-05 close the application by clicking the exit key or the close button, then relaunch it from smart hub or apps panel check that the application works properly and does not initiate unnecessary content updates note test both the on-screen and the remote control exit keys yes yes yes the application runs normally unnecessary updates are not initiated related info terminating applications test case id definition support tv htv signage co-ge-06 check that the tv recovers from being switched off while content is loading yes yes yes while content is loading in the application, switch the tv off using the power key after a few seconds, click the power key again the tv switches on test case id definition support tv htv signage co-ge-07 after launching the application from the smart hub first screen or apps panel, check that application termination and multitasking works properly yes yes yes when the return or exit key is clicked, the application is terminated when the smart hub key is clicked, the application is moved to the background and the smart hub first screen is shown for tv models that do not support multitasking, when the smart hub key is clicked, the application is terminated and the smart hub first screen is shown related info multitasking, terminating applications test case id definition support tv htv signage co-ge-08 during media playback, switch off the device when the device is switched on again, check that the application's previous screen or detail page is shown yes no yes the application's previous screen or detail page is shown related info multitasking connection test case id definition support tv htv signage co-cn-01 after network disconnection and reconnection, including during media playback, check that the application resumes working normally yes yes yes the application does not freeze when the network connection is lost if the network is disconnected and reconnected, while the application is launching, it is not stuck on loading and the return key is functional when the network is reconnected, the network disconnected message is dismissed related info checking network status test case id definition support tv htv signage co-cn-02 if the network connection is lost while the application is running, including during media playback, check that a notification message is shown yes yes yes when the network connection is lost, a message is shown when the network disconnected message is shown, the application does not lock up the device or cause it to reboot related info checking network status noteif your application content cannot be accessed due to http client or server issues, you must show a clear error message with information on what to do or who to contact for support remember that samsung cannot provide support to tv users with issues related to content availability within your application test case id definition support tv htv signage co-cn-03 while loading or buffering content, check that a loading or progress indicator is shown yes yes yes a loading or progress indicator is present related info progress indicators installation test case id definition support tv htv signage co-in-01 for 2016 and newer models, if the application supports smart hub preview, check that during installation, the application icon and preview can be automatically added to the smart hub apps preview yes yes no when installing the application, if "add to home" is selected, the application icon and preview are added to the smart hub apps preview test case id definition support tv htv signage co-in-02 check that the application can be run immediately after installation yes yes yes after installing the application, when "run now" or the application icon in smart hub is clicked, the application launches test case id definition support tv htv signage co-in-03 if the application requires privileges, on the application details page, check that the following paragraph is shown below the "install" button "check the app permissions by selecting more in the information area by selecting install, you agree to grant those permissions to this app " yes yes yes on the application details page, the required text is present test case id definition support tv htv signage co-in-04 if the application requires privileges, check that the privileges required by the application match those listed on the application details page yes yes yes the privileges required by the application match those listed on the application details page related info configuring web applications keyboard/ime test case id definition support tv htv signage co-ki-01 when using the samsung ime, if the entered text exceeds the character limit, check that the application works properly yes yes yes exceeding the character limit does not cause unexpected behavior or lock up the device test case id definition support tv htv signage co-ki-02 when entering text, check that the text does not overflow the bounds of the input box yes yes yes the entered text stays inside the input box test case id definition support tv htv signage co-ki-03 when the samsung or application ime language is changed, check that the ime is changed accordingly yes yes yes language-specific characters are input correctly test case id definition support tv htv signage co-ki-04 check that special characters and spacing can be input and displayed correctly in the application yes yes yes special character input does not cause the application to freeze or crash special characters are displayed correctly special character input stays inside the input box search works properly with special characters related info keyboard/ime test case id definition support tv htv signage co-ki-05 when using the samsung ime with the xt9 predictive text feature, if the entered word exceeds the 64-character length limit, check that the application works properly yes yes yes exceeding the character limit does not cause unexpected behavior or lock up the device test case id definition support tv htv signage co-ki-06 connect a physical keyboard to the device and launch the application if the application does not support external keyboards, only the keyboard keys with remote control key equivalents are functional yes yes yes only the keyboard keys with remote control key equivalents are functional related info keyboard/ime test case id definition support tv htv signage co-ki-07 while the application is running, connect, disconnect, and reconnect a physical keyboard to the device check that the keyboard works properly yes yes yes the physical keyboard is detected properly keyboard input works properly related info keyboard/ime test case id definition support tv htv signage co-ki-08 if the application supports physical keyboards, check that all keyboard characters can be input correctly, including modified characters note when modifier keys such as "ctrl" and "altgr" are pressed, the virtual ime does not show the modified characters yes yes yes all keyboard characters can be input correctly, including modified characters related info keyboard/ime test case id definition support tv htv signage co-ki-09 if the application implements special functions for specific keyboard keys, check that they work as described in the application description yes yes yes keyboard keys with special functions work as described related info keyboard/ime test case id definition support tv htv signage co-ki-10 connect a physical keyboard to the device and launch the application check that the keyboard keys with remote control key equivalents work correctly note during text input, these keys can function as normal keyboard keys instead of remote control keys yes yes yes when the keyboard key is clicked, the corresponding remote control key function, if applicable, is activated related info keyboard/ime multitasking test case id definition support tv htv signage co-mt-01 during media playback, send the application to the background by clicking the smart hub key check that the application resumes properly from the apps panel or the smart hub first screen yes no no when the application resumes, media playback resumes in the same state as before, or the application shows the previous page if the application implements a shortcut key for resuming playback, it works properly related info multitasking test case id definition support tv htv signage co-mt-02 while viewing a tv channel, launch the application click the smart hub key to send the application to the background check that the same tv channel is shown yes no no the same tv channel is shown before launching the application and after sending it to the background related info multitasking test case id definition support tv htv signage co-mt-03 during media playback, click the smart hub key to send the application to the background disconnect and reconnect the network, then resume the application check that media playback resumes correctly yes no no after resuming the application, audio and video playback work normally related info multitasking test case id definition support tv htv signage co-mt-04 while the application is in use, such as during media playback or showing a detail page, send the application to the background uninstall and reinstall the application check that the application is reinitialized yes no no after reinstalling the application, when it is launched, it opens to the first page prelaunching test case id definition support tv htv signage co-pl-01 for tv models that support prelaunching, check that it works properly add the application to the left side of the smart hub launcher and power cycle the tv after 3 minutes, launch the application yes no no after the tv has been switched back on, the audio and video work properly the application launches immediately without showing a loading screen when the application is launched, it works normally related info prelaunching applications privacy test case id definition support tv htv signage co-pr-01 check that all personally-identifiable information is deleted with application deletion the term "personally-identifiable information" is used as defined in the online privacy protection act yes yes yes after deleting the application, reinstall it no personally-identifiable information from the previous installation is available search test case id definition support tv htv signage co-se-01 check that searching with an empty search box is handled appropriately yes yes no a "no search results" message is shown the application does not crash test case id definition support tv htv signage co-se-02 check that keyword search finds keyword-related results yes yes no keyword search finds results related to the keyword in addition to those containing the keyword slideshow test case id definition support tv htv signage co-sl-01 check that the slideshow transition time setting is applied properly yes yes no the slideshow transition time is applied properly test case id definition support tv htv signage co-sl-02 check that slideshow transition effects such as fade, puzzle, or random are applied properly yes yes no slideshow transition effects are applied properly test case id definition support tv htv signage co-sl-03 when a slideshow reaches the end, check that it repeats properly yes yes no the slideshow repeats from the beginning the slideshow does not cause the application to crash test case id definition support tv htv signage co-sl-04 when creating a slideshow from selected images or image categories, check that the selected images are shown yes yes no during image selection, the application does not crash only the selected images are included in the slideshow test case id definition support tv htv signage co-sl-05 when launching a slideshow, check that all images can be loaded yes yes no all slideshow images can be loaded test case id definition support tv htv signage co-sl-06 during a slideshow, check that the user can browse through the images using the arrow keys or other assigned keys yes yes no slideshow images can be browsed using the arrow keys or other assigned keys sound test case id definition support tv htv signage co-so-01 if the application uses the samsung osd, after clicking various remote control keys except the return, exit, and search keys , check that the volume and mute keys work properly yes yes yes lfd only the sound bar displays the correct volume level if mute is switched on, it stays on when entering or exiting the application test case id definition support tv htv signage co-so-02 check that volume controls work properly in the application yes yes yes the sound output is adjustable throughout an appropriate range when the volume keys are clicked, mute is not switched on or off test case id definition support tv htv signage co-so-03 check that running the application switches off the tv channel audio yes yes yes lfd only while the application is running, the tv channel audio cannot be heard test case id definition support tv htv signage co-so-04 switch mute on, then launch the application check that mute works properly in the application yes yes yes sound is muted only 1 copy of the mute ui is shown while muted, when the application is closed, mute stays switched on while muted, when the mute key or the volume keys are clicked, mute is switched off test case id definition support tv htv signage co-so-05 check that the mute and volume uis are functional yes yes yes the mute and volume keys are functional the appropriate mute or volume ui is shown test case id definition support tv htv signage co-so-06 check that mute is not unintentionally switched on when launching or closing the application yes yes yes if mute is switched off, when the application is closed, mute stays switched off test case id definition support tv htv signage co-so-07 launch the application, then switch mute on check that mute works properly yes yes yes when the mute key or the volume keys are clicked, mute is switched off while mute is switched on, when the application is closed, mute stays on and the mute ui is shown ui test case id definition support tv htv signage co-ui-01 check that the application icon displays properly in smart hub or apps panel yes yes yes the icon is shown in smart hub properly the icon and name do not overlap the icon is the correct size the icon is identical in samsung apps and in smart hub the icon highlight is consistent with that of other application icons related info app icon test case id definition support tv htv signage co-ui-02 check that the help bar keys are shown in the correct order yes yes yes lfd only the help bar keys are shown in the following order color keys red a , green b , yellow c , and blue d playback control keystools keyarrow keysenter keyreturn key test case id definition support tv htv signage co-ui-03 hover the cursor over the application icon in the smart hub apps preview check that the preview panel and its deep links work properly yes yes no the preview tiles display properly when a preview tile is clicked, the indicated content or detail page in the application launches directly related info smart hub preview test case id definition support tv htv signage co-ui-04 check that list or content navigation using the arrow keys works properly yes yes yes lfd only the focus can move between all items in a list when the focus moves to the beginning or ending of a list or content, the arrow keys for directions in which it is not possible to navigate are deactivated the focus does not disappear related info remote control test case id definition support tv htv signage co-ui-05 check that ui elements do not move around unintentionally when remote control keys are clicked yes yes yes lfd only the ui elements stay in place test case id definition support tv htv signage co-ui-06 check that focus can be moved to all selectable parts of the ui yes yes yes focus can be moved to all selectable parts of the ui test case id definition support tv htv signage co-ui-07 when entering and leaving the page multiple times, using the enter and return keys, check that the ui works properly yes yes yes lfd only the ui is shown correctly no error messages appear the application does not crash, nor causes the device to lock up or reboot test case id definition support tv htv signage co-ui-08 check that all ui text, including special characters and symbols, is displayed properly yes yes yes all ui text is displayed properly special characters and symbols are not corrupted all html code is valid and rendered correctly test case id definition support tv htv signage co-ui-09 when the arrow keys are clicked multiple times, check that the ui works properly yes yes no the ui is shown correctly the ui elements do not unintentionally move around or overlap the focus does not disappear there is no double focus the application does not crash, nor causes the device to lock up or reboot test case id definition support tv htv signage co-ui-10 if the application has multiple category pages, check that the arrow keys navigate between the pages properly yes yes no all category pages can be selected when a category is selected, the correct page is shown test case id definition support tv htv signage co-ui-11 on pages with too much content to fit on 1 screen, check that the full content can be viewed using a scroll bar yes yes yes the scroll bar is displayed properly the scroll bar is functional related info position indicators test case id definition support tv htv signage co-ui-12 check that the control buttons on scroll bars are displayed properly yes yes yes the control buttons on scroll bars are displayed properly related info position indicators test case id definition support tv htv signage co-ui-13 check that image thumbnails are displayed properly if the media has no image, or the image is not supported, check that an alternative image is shown yes yes no image thumbnails are displayed properly if the media has no video image, or the image is not supported, an alternative image is shown user controls test case id definition support tv htv signage co-us-01 in the application, check that all remote control keys work properly yes yes yes lfd only in the application, all remote control keys function properly, including during media playback if the remote control has a search key, clicking it closes the application and shows the search box on the tv channel screen for 2014 models, the search box is shown in the following locations on tvs on the application screenon bd players on the main menuon bd pvrs on the dtv screenif there are keys which are not defined in the application description, they must not respond to clicks the screen does not flicker when keys are clicked while video playback is paused, skipping the video forward or backward does not cause double focus related info remote control test case id definition support tv htv signage co-us-02 while loading or buffering media content, check that the remote control keys work properly yes yes yes lfd only when the remote control keys are clicked, the application does not lock up the device or cause it to reboot when the return key is clicked, the focus does not disappear when the return key is clicked, the application goes back to the previous page when the stop key is clicked, playback is stopped when the return or stop key is clicked, the loading indicator disappears related info remote control test case id definition support tv htv signage co-us-03 check that all help bar keys work properly yes yes yes lfd only all help bar keys work as described test case id definition support tv htv signage co-us-04 check that the exit key works correctly yes yes yes lfd only if a popup or the ime is open, clicking the exit key closes it the exit key works during media playback on an application page, clicking the exit key closes the application and shows the tv channel screen the tv channel outputs normally on bd players, clicking the exit key closes the application and shows the main menu related info remote control test case id definition support tv htv signage co-us-05 check that the return key works according to the return key policy yes yes yes lfd only if a popup is open, clicking the return key closes the popup on an application page, clicking the return key goes to the previous page on the application home page, clicking the return key closes the application and shows the smart hub since 2016 models, on the application home page, clicking the return key closes the application and shows the tv channel screen launch the application from the samsung apps screen clicking the return key closes the application and shows the smart hub related info terminating applications test case id definition support tv htv signage co-us-06 check that the channel list, channel guide, and number keys work properly yes yes no when the channel list, channel guide, and number keys are clicked, unexpected behavior does not occur if the number keys are assigned to actions in the application description, they work as described related info remote control test case id definition support tv htv signage co-us-07 check that the color red, yellow, green, and blue keys work as described in the application description yes yes no the color keys work as described in the application description if the color keys are not assigned to actions, they do not respond to clicks related info remote control
Develop Smart Hospitality Display
apisamsung product api references for htv the samsung product api extends the capabilities of your application beyond those provided by the tizen tv web device api to use samsung product api, <script type="text/javascript" src="$webapis/webapis/webapis js"></script> should be loaded in "index html" the following apis provide access to features specific to hospitality displays api description since webapi you can access the basic definitions used in the samsung product api for smart tvs 2 3 appcommon you can switch the screensaver on and off 2 3 asfservice you can share media content between dlna-certified devices by initializing and using the allshare framework you can retrieve a list of discovered allshare devices with a specified id or information about media files and folders, such as the file extension and size, and content duration 2 3 avinfo you can retrieve information about the screen and audio modes of the tv you can also set the widescreen mode 2 3 avplay you can implement audio and video playback 2 3 avplayextension you can implement multimedia playback with udp or rtp for audio or video 6 5 avplaystore you can implement audio and video playback 2 3 broadcast user can control the information that is related to the broadcast functionalities 6 5 microphone you can manage a microphone connected to the tv 2 3 network you can access information about the network connection and connection-related events 2 3 preview you can use smart hub preview to show deep links to application content 2 3 productinfo you can retrieve information about the tv, such as the device unique id duid , and the model code you can also retrieve and set system configuration parameters 2 3 remotepower you can control remote power state in case of remote mode background standby mode or remote configuration mode 6 5 systemcontrol you can control devices remotely 6 5 systeminfo you can get the system state and settings information 6 0 timer you can turn on or turn off a device at the time you set also you can register or unregister ntp server connected to devices 6 5 tvinfo you can manage the tv settings 2 3 widgetdata you can store data in the application secure storage 2 3 systemdebug you can collect logs for debugging 6 5 table 1 samsung product apis for smart hospitality display note the appcommonkeyname type definition of appcommon api is supported since 2 4, and the"ambient" key is defined since tizen 4 0 the read , write andremove methods of the widgetdatamanager interface of the widgetdata api are supported since tizen 4 0 warningif you want to use avplayextension api among samsung product apis, the following should be included at the "index html" additionally <script type="text/javascript" src="$webapis/avplayextension/avplayextension js"></script>
FAQ game, smarttv
docapplication testing q&a the following questions are related to testing applications faq search form search q1 can i test my application without using the tizen studio ide? to test your application on a tv, you must use the tizen studio ide you can also use the usb demo packaging tool, available in the samsung apps tv seller office you can test your application on the emulator without using the ide the tizen studio command line interface cli provides functionalities for installing, running, and uninstalling applications tvhtv#tizen studio ide q2 how do i test my application on a samsung smart tv? to install and test your application on a tv, you must connect the tv and the tizen studio for more information, see tv device if you do not have access to an actual samsung smart tv, you can also test your application in the tv emulator tvhtv#tv emulator q3 how do i enable developer mode on the tv? before connecting a samsung smart tv to the tizen studio, you must enable developer mode on the tv for more information, see connecting the tv and sdk noteif the tv has the "samsung instant on" feature enabled, you must power-cycle the tv disconnect and reconnect the power source at the reboot step tvhtv#developer mode q4 how do i connect my tv to the tizen studio? to connect a smart tv to the tizen studio, you must enable developer mode on the tv, connect the tv and your computer to the same network, and launch the remote device manager in the tizen studio for more information, see tv device tvhtv#connect tv#tizen studio q5 i am unable to connect my tv to the tizen studio how do i fix this? make sure that you have connected the tv and computer to the same network, and enabled developer mode on the tv for more information, see tv device you can also try to connect the tv to the tizen studio without using the remote device manager on the tv, enable developer mode in the windows® command prompt, navigate to your <tizen studio>\tools directory enter the sdb connect <your tv ip address> command tvhtv#unable to connect tv q6 while testing my application on a tv, i experienced a bug why am i unable to reproduce it on the tv emulator? the emulator and the tv environments are very similar, but there are some differences at the hardware level for more information, see emulator limitations make sure you perform the final testing of your application on the tv the tv emulator does not support hotel tv environment tvhtv#unable to reproduce bug q7 i am testing my application on a tv why is the application uninstalled when i switch off the tv? applications installed to a tv through the tizen studio are uninstalled when the tv is switched off or disconnected from the tizen studio this is the intended platform behavior tvhtv#application uninstalled q8 how do i use the tv emulator? the tv emulator is a virtual machine that reduces the inconvenience of testing the application on a real device, by providing an environment similar to a real tv for information about using the emulator, see tv emulator tvhtv#tv emulator q9 how can i test application prelaunching? prelaunching allows several applications to load in the background when the samsung tv is switched on when the user runs a prelaunched application, it launches immediately with no loading time prelaunching is supported on the tv emulator for more information, see prelaunching applications tv#prelaunching application q10 how can i test drm-protected content playback? you can test drm-protected content playback on an actual tv due to possible security issues, using drm functions in the emulator is not possible drm-protected content can only be played back on a real device tvhtv#drm q11 how can i analyze application performance? you can use the web inspector to help you optimize your web applications it provides a debugging environment, and allows you to inspect the css and layout of html pages, and monitor resource and network usage tvhtv#application performance#analyze q12 which tv model is best for testing my application? select a model based on the media formats you want to support for information on which tv models are included in each model group, see tv model groups tv#tv model q13 how do i test a hosted application on the tv? for information about testing hosted applications on a tv, contact your samsung apps tv seller office content manager noteto create hosted applications, you must be a member of a seller office partner group tvhtv#hosted application q14 when i close my application during testing, the web inspector is disconnected how can i avoid this? when no applications are running on the tv or emulator, the web socket connection to the computer closes, disconnecting the web inspector to prevent web inspector disconnection to install your application on the tv or emulator and launch the web inspector, run the application in debug mode from the tizen studio when the web inspector finishes loading, launch a different application from the smart hub return to the smart hub and launch your application the first application remains running but hidden, and prevents the web inspector from disconnecting when you close your application tvhtv#web inspector#disconnection q15 is automated testing supported? no automated testing is not supported on samsung tvs additionally, the automatic testing tools provided for samsung legacy platform are no longer supported tvhtv#automated testing q16 do applications generate crash logs? tv applications do not support generating crash logs however, you can detect when the application stops or closes unexpectedly, by implementing a software watchdog timer tvhtv#crash log q17 can i simulate accessing application content from another country? yes to test accessing content from another country or region, connect the tv to the internet through a vpn tvhtv#accessing application content#geolocation#vpn q18 can i retrieve network traffic statistics during application testing? you can view network traffic statistics in the web inspector however, the web inspector detects only ordinary web traffic it does not detect network traffic from, for example, media playback using the avplay api tvhtv#network traffic#statistics q19 why am i unable to test my application with the web inspector? the web inspector does not work properly with samsung tvs on later versions of google chrome™ you can try using an older google chrome™ version tvhtv#unable to test application#web inspector q20 can i perform memory profiling on my tv application? no for security reasons, the tizen studio dynamic analyzer is not supported on samsung tvs tvhtv#memory profiling q21 can i obtain root access to the tv through the "sdb" tool? no it is not possible to obtain root access to the tv tvhtv#root access q22 can i retrieve system logs from the tv using the "sdb" tool? no the sdb logging feature is not supported on samsung tvs it is not possible to retrieve system logs tvhtv#sdb tool#system log q23 when testing the application through the tizen studio, i get the "error 205 unable to download " error how do i resolve this? this error is related to a certificate issue try creating a new certificate profile, making sure you select the distributor certificate privilege level you need, then building the project with the new certificate profile tvhtv#privilege level#tizen studio#error q24 when testing the application through the tizen studio, i get the "error 118 unable to install " error how do i resolve this? if you have modified the content of a " wgt" file after packaging it, it can no longer be installed you must build the package again through the tizen studio tvhtv#wgt file#tizen studio#error q25 why am i unable to test a " tpk" application package on the tv? samsung tvs support only web applications " wgt" files they do not support native applications " tpk" files tvhtv#tpk file q26 can i install certificates on a samsung tv proxy, and test secure and unsecure network traffic? no testing by proxy is not supported on samsung tvs tvhtv#proxy#network traffic#security certificate q27 can i test a samsung tv application on other hardware running tizen, such as a raspberry pi? no to test samsung tv applications, the device must have access to the tizen and samsung product apis the samsung product api is only available on samsung devices tvhtv#samsung product api#hardware
FAQ game, smarttv
docapplication testing q&a the following questions are related to testing applications faq search form search q1 can i test my application without using the tizen studio ide? to test your application on a tv, you must use the tizen studio ide you can also use the usb demo packaging tool, available in the samsung apps tv seller office you can test your application on the emulator without using the ide the tizen studio command line interface cli provides functionalities for installing, running, and uninstalling applications tvhtv#tizen studio ide q2 how do i test my application on a samsung smart tv? to install and test your application on a tv, you must connect the tv and the tizen studio for more information, see tv device if you do not have access to an actual samsung smart tv, you can also test your application in the tv emulator tvhtv#tv emulator q3 how do i enable developer mode on the tv? before connecting a samsung smart tv to the tizen studio, you must enable developer mode on the tv for more information, see connecting the tv and sdk noteif the tv has the "samsung instant on" feature enabled, you must power-cycle the tv disconnect and reconnect the power source at the reboot step tvhtv#developer mode q4 how do i connect my tv to the tizen studio? to connect a smart tv to the tizen studio, you must enable developer mode on the tv, connect the tv and your computer to the same network, and launch the remote device manager in the tizen studio for more information, see tv device tvhtv#connect tv#tizen studio q5 i am unable to connect my tv to the tizen studio how do i fix this? make sure that you have connected the tv and computer to the same network, and enabled developer mode on the tv for more information, see tv device you can also try to connect the tv to the tizen studio without using the remote device manager on the tv, enable developer mode in the windows® command prompt, navigate to your <tizen studio>\tools directory enter the sdb connect <your tv ip address> command tvhtv#unable to connect tv q6 while testing my application on a tv, i experienced a bug why am i unable to reproduce it on the tv emulator? the emulator and the tv environments are very similar, but there are some differences at the hardware level for more information, see emulator limitations make sure you perform the final testing of your application on the tv the tv emulator does not support hotel tv environment tvhtv#unable to reproduce bug q7 i am testing my application on a tv why is the application uninstalled when i switch off the tv? applications installed to a tv through the tizen studio are uninstalled when the tv is switched off or disconnected from the tizen studio this is the intended platform behavior tvhtv#application uninstalled q8 how do i use the tv emulator? the tv emulator is a virtual machine that reduces the inconvenience of testing the application on a real device, by providing an environment similar to a real tv for information about using the emulator, see tv emulator tvhtv#tv emulator q9 how can i test application prelaunching? prelaunching allows several applications to load in the background when the samsung tv is switched on when the user runs a prelaunched application, it launches immediately with no loading time prelaunching is supported on the tv emulator for more information, see prelaunching applications tv#prelaunching application q10 how can i test drm-protected content playback? you can test drm-protected content playback on an actual tv due to possible security issues, using drm functions in the emulator is not possible drm-protected content can only be played back on a real device tvhtv#drm q11 how can i analyze application performance? you can use the web inspector to help you optimize your web applications it provides a debugging environment, and allows you to inspect the css and layout of html pages, and monitor resource and network usage tvhtv#application performance#analyze q12 which tv model is best for testing my application? select a model based on the media formats you want to support for information on which tv models are included in each model group, see tv model groups tv#tv model q13 how do i test a hosted application on the tv? for information about testing hosted applications on a tv, contact your samsung apps tv seller office content manager noteto create hosted applications, you must be a member of a seller office partner group tvhtv#hosted application q14 when i close my application during testing, the web inspector is disconnected how can i avoid this? when no applications are running on the tv or emulator, the web socket connection to the computer closes, disconnecting the web inspector to prevent web inspector disconnection to install your application on the tv or emulator and launch the web inspector, run the application in debug mode from the tizen studio when the web inspector finishes loading, launch a different application from the smart hub return to the smart hub and launch your application the first application remains running but hidden, and prevents the web inspector from disconnecting when you close your application tvhtv#web inspector#disconnection q15 is automated testing supported? no automated testing is not supported on samsung tvs additionally, the automatic testing tools provided for samsung legacy platform are no longer supported tvhtv#automated testing q16 do applications generate crash logs? tv applications do not support generating crash logs however, you can detect when the application stops or closes unexpectedly, by implementing a software watchdog timer tvhtv#crash log q17 can i simulate accessing application content from another country? yes to test accessing content from another country or region, connect the tv to the internet through a vpn tvhtv#accessing application content#geolocation#vpn q18 can i retrieve network traffic statistics during application testing? you can view network traffic statistics in the web inspector however, the web inspector detects only ordinary web traffic it does not detect network traffic from, for example, media playback using the avplay api tvhtv#network traffic#statistics q19 why am i unable to test my application with the web inspector? the web inspector does not work properly with samsung tvs on later versions of google chrome™ you can try using an older google chrome™ version tvhtv#unable to test application#web inspector q20 can i perform memory profiling on my tv application? no for security reasons, the tizen studio dynamic analyzer is not supported on samsung tvs tvhtv#memory profiling q21 can i obtain root access to the tv through the "sdb" tool? no it is not possible to obtain root access to the tv tvhtv#root access q22 can i retrieve system logs from the tv using the "sdb" tool? no the sdb logging feature is not supported on samsung tvs it is not possible to retrieve system logs tvhtv#sdb tool#system log q23 when testing the application through the tizen studio, i get the "error 205 unable to download " error how do i resolve this? this error is related to a certificate issue try creating a new certificate profile, making sure you select the distributor certificate privilege level you need, then building the project with the new certificate profile tvhtv#privilege level#tizen studio#error q24 when testing the application through the tizen studio, i get the "error 118 unable to install " error how do i resolve this? if you have modified the content of a " wgt" file after packaging it, it can no longer be installed you must build the package again through the tizen studio tvhtv#wgt file#tizen studio#error q25 why am i unable to test a " tpk" application package on the tv? samsung tvs support only web applications " wgt" files they do not support native applications " tpk" files tvhtv#tpk file q26 can i install certificates on a samsung tv proxy, and test secure and unsecure network traffic? no testing by proxy is not supported on samsung tvs tvhtv#proxy#network traffic#security certificate q27 can i test a samsung tv application on other hardware running tizen, such as a raspberry pi? no to test samsung tv applications, the device must have access to the tizen and samsung product apis the samsung product api is only available on samsung devices tvhtv#samsung product api#hardware
FAQ game, smarttv
docother features q&a the following questions are related to various tv application features faq search form search q1 what is multitasking? multitasking allows you to save the application state when the user launches another application or tv channel, and restore it when the application is resumed to be published on samsung apps tv, your application must implement multitasking for more information, see multitasking noteapplications for the following model groups do not require multitasking 15_standard2 15_entry 15_bd all 2014 and older model groups tvhtv#multitasking q2 can i implement in-app purchases? yes to offer in-app purchases, you can implement samsung checkout in your application it allows any user with a samsung account to register a payment method and use it to make payments on the tv in addition, samsung checkout provides a comprehensive global monetization platform, which allows you to integrate various business models and promotional campaigns into your services for more information, see samsung checkout tv#samsung checkout#monetization#in-app purchase q3 can i implement accessibility text-to-speech support in my application? samsung smart tvs support the accessibility toolkit atk as part of the web engine if the user has activated the voice guide feature, the text-to-speech tts engine can read html elements on the application screen since 2016 models, the voice guide also supports various roles and descriptions based on the wai-aria web accessibility initiative - accessible rich internet applications standard for web content accessibility for information on implementing voice guide support, see text to speech tvhtv#text to speech#accessibility q4 can i implement voice control in my application? no voice control is supported only for tv features, such as opening the search panel or adjusting the volume level it is not supported within applications tvhtv#voice control q5 what are the standard application screen resolutions for samsung tvs? the standard screen resolution for samsung smart tv applications is 1920x1080 px for uhd models, and 1280x720 px for fhd models for information on implementing your application to fit tv screens, see managing screen resolution tvhtv#screen resolution q6 how do i enable and disable the screensaver? you can use the appcommon api to enable and disable the screensaver for more information, see setting screensaver tvhtv#screensaver q7 when my application is resumed, the "gettime " method retrieves the wrong time how do i fix this? when an application is hidden, javascript execution is paused, which can affect time calculations to avoid problems, retrieve the time from a server for more information, see special multitasking scenarios tvhtv#gettime#multitasking q8 how is memory usage monitored to ensure system stability? since 2017 model groups, samsung tvs have a stability-monitoring feature that automatically terminates processes to free up system memory applications installed through the tizen studio for testing can use a maximum 120 mb of memory tvhtv#system memory q9 how do i allow my application to be automatically updated on the tv? since 2015 models, you can enable or disable the auto update feature for your application, which automatically updates it during regularly-scheduled updates on 2015 and 2016 tv models, you can also enable or disable the force update feature for your application, which automatically updates the application when a new version is available, even outside regularly-scheduled updates these features are configured in the "config xml" file for implementation details, see meta data tvhtv#automatic update#config xml q10 can i create an overlay application that runs on top of and interacts with another application? no overlay applications are not supported on samsung tvs tvhtv#overlay q11 how do i implement picture-in-picture functionality in my application? picture-in-picture pip allows you to display tv source video, such as a tv channel or hdmi input, through a cutout in your application screen you can implement it using the tvwindow api tvhtv#picture in picture q12 can i hide my application and move to the tv live signal screen instead of to the smart hub? yes to hide the application and move directly to the tv live signal screen, use the launch method of the application api to launch the "org tizen tv-viewer" application tvhtv#live tv signal q13 can i implement switching between the tv and connected external audio devices, and adjust their volume? no detecting the attached audio devices is not supported the user must select the active audio device from the tv menu by default, the remote control volume keys adjust only the tv volume, but you can use the tvaudiocontrol api to control the volume level in your application tvhtv#audio device#tvaudiocontrol api#volume q14 what is the single sign-on sso feature and how do i implement it? the sso feature allows users to save login information to their samsung account on the device to enable sso in your application, you must add the following code to your "config xml" file <login itemtype="boolean">y</login> for information on implementing the sso feature, see sso api tv#single sign on#config xml q15 what is multi link screen mls ? mls is a feature on 2014 and 2015 tv models that allows the user to divide the tv screen into 2 parts, showing the tv broadcast signal in 1 part and a running application in the other part this feature is enabled by default if you want to disable it for your tizen application, add the following line to your "config xml" file <tizen metadata key='http //samsung com/tv/metadata/multiscreen support' value='false' /> tv#multi link screen q16 are ticker applications supported? the ticker feature, which allowed an application to run as an overlay, is no longer supported do not use ticker elements in your "config xml" file since 2015 tv models, you can implement similar pip picture in picture functionality, to show the tv source through a cut-out in the application screen tvhtv#picture in picture#ticker q17 what is the "live signal"? the live signal is the broadcast received by the tv, such as through cable or satellite reception tvhtv#live signal q18 can i implement a screen capture feature in my application? no screen capture is not supported in samsung tv applications tvhtv#screen capture q19 is parental control supported? samsung tvs do not include a built-in parental control solution you must implement your own in the application tvhtv#parental control q20 what are the tv broadcast "servicename", "channelname", and "sourceid" properties? in general, the servicename property represents a tv broadcast service, which can have multiple channels defined by channelname properties the encoding used for these properties depends on the broadcaster the sourceid property uniquely identifies a source for scheduled tv programming tvhtv#tv broadcast#servicename#channelname#sourceid q21 in the "config xml" file, do i need to set the "devel api version" metadata key to the latest api version? the value of the "'http //samsung com/tv/metadata/devel api version" key within the tizen metadata element defines the api version used in the application for compatibility reasons, it is not required to be the latest api version; you can specify the minimum version needed to use all application features tvhtv#metadata#api version q22 can i enable the "background-support" attribute in the "tizen setting" element of the "config xml" file to keep the application running even when it is in the background? no since 2015 tv models, applications are automatically paused when they are hidden for compatibility reasons, in the "config xml" file, the background-support attribute must be set to "disable" do not modify it tvhtv#background support#config xml q23 why are the css styles in my application not working? make sure that your application is loading the css file check that your html code is valid and that your stylesheet link element is in the following format <link href="css/style css" rel="stylesheet" type="text/css" /> tvhtv#css q24 are family hub applications compatible with samsung tvs? the family hub platform is not fully compatible with that of samsung smart tvs to enable a family hub application to run on a samsung tv, you must modify the application to meet tv application specifications tv#family hub q25 can i develop applications for samsung professional displays? for information on developing applications for samsung professional display solutions, such as digital signage and hotel tvs, see samsung d forum b2b developers tvhtv#professional display q26 why am i unable to access the samsung d forum site content? the samsung d forum content has been migrated to the samsung developers smart tv site tvhtv#samsung d forum
FAQ game, smarttv
docother features q&a the following questions are related to various tv application features faq search form search q1 what is multitasking? multitasking allows you to save the application state when the user launches another application or tv channel, and restore it when the application is resumed to be published on samsung apps tv, your application must implement multitasking for more information, see multitasking noteapplications for the following model groups do not require multitasking 15_standard2 15_entry 15_bd all 2014 and older model groups tvhtv#multitasking q2 can i implement in-app purchases? yes to offer in-app purchases, you can implement samsung checkout in your application it allows any user with a samsung account to register a payment method and use it to make payments on the tv in addition, samsung checkout provides a comprehensive global monetization platform, which allows you to integrate various business models and promotional campaigns into your services for more information, see samsung checkout tv#samsung checkout#monetization#in-app purchase q3 can i implement accessibility text-to-speech support in my application? samsung smart tvs support the accessibility toolkit atk as part of the web engine if the user has activated the voice guide feature, the text-to-speech tts engine can read html elements on the application screen since 2016 models, the voice guide also supports various roles and descriptions based on the wai-aria web accessibility initiative - accessible rich internet applications standard for web content accessibility for information on implementing voice guide support, see text to speech tvhtv#text to speech#accessibility q4 can i implement voice control in my application? no voice control is supported only for tv features, such as opening the search panel or adjusting the volume level it is not supported within applications tvhtv#voice control q5 what are the standard application screen resolutions for samsung tvs? the standard screen resolution for samsung smart tv applications is 1920x1080 px for uhd models, and 1280x720 px for fhd models for information on implementing your application to fit tv screens, see managing screen resolution tvhtv#screen resolution q6 how do i enable and disable the screensaver? you can use the appcommon api to enable and disable the screensaver for more information, see setting screensaver tvhtv#screensaver q7 when my application is resumed, the "gettime " method retrieves the wrong time how do i fix this? when an application is hidden, javascript execution is paused, which can affect time calculations to avoid problems, retrieve the time from a server for more information, see special multitasking scenarios tvhtv#gettime#multitasking q8 how is memory usage monitored to ensure system stability? since 2017 model groups, samsung tvs have a stability-monitoring feature that automatically terminates processes to free up system memory applications installed through the tizen studio for testing can use a maximum 120 mb of memory tvhtv#system memory q9 how do i allow my application to be automatically updated on the tv? since 2015 models, you can enable or disable the auto update feature for your application, which automatically updates it during regularly-scheduled updates on 2015 and 2016 tv models, you can also enable or disable the force update feature for your application, which automatically updates the application when a new version is available, even outside regularly-scheduled updates these features are configured in the "config xml" file for implementation details, see meta data tvhtv#automatic update#config xml q10 can i create an overlay application that runs on top of and interacts with another application? no overlay applications are not supported on samsung tvs tvhtv#overlay q11 how do i implement picture-in-picture functionality in my application? picture-in-picture pip allows you to display tv source video, such as a tv channel or hdmi input, through a cutout in your application screen you can implement it using the tvwindow api tvhtv#picture in picture q12 can i hide my application and move to the tv live signal screen instead of to the smart hub? yes to hide the application and move directly to the tv live signal screen, use the launch method of the application api to launch the "org tizen tv-viewer" application tvhtv#live tv signal q13 can i implement switching between the tv and connected external audio devices, and adjust their volume? no detecting the attached audio devices is not supported the user must select the active audio device from the tv menu by default, the remote control volume keys adjust only the tv volume, but you can use the tvaudiocontrol api to control the volume level in your application tvhtv#audio device#tvaudiocontrol api#volume q14 what is the single sign-on sso feature and how do i implement it? the sso feature allows users to save login information to their samsung account on the device to enable sso in your application, you must add the following code to your "config xml" file <login itemtype="boolean">y</login> for information on implementing the sso feature, see sso api tv#single sign on#config xml q15 what is multi link screen mls ? mls is a feature on 2014 and 2015 tv models that allows the user to divide the tv screen into 2 parts, showing the tv broadcast signal in 1 part and a running application in the other part this feature is enabled by default if you want to disable it for your tizen application, add the following line to your "config xml" file <tizen metadata key='http //samsung com/tv/metadata/multiscreen support' value='false' /> tv#multi link screen q16 are ticker applications supported? the ticker feature, which allowed an application to run as an overlay, is no longer supported do not use ticker elements in your "config xml" file since 2015 tv models, you can implement similar pip picture in picture functionality, to show the tv source through a cut-out in the application screen tvhtv#picture in picture#ticker q17 what is the "live signal"? the live signal is the broadcast received by the tv, such as through cable or satellite reception tvhtv#live signal q18 can i implement a screen capture feature in my application? no screen capture is not supported in samsung tv applications tvhtv#screen capture q19 is parental control supported? samsung tvs do not include a built-in parental control solution you must implement your own in the application tvhtv#parental control q20 what are the tv broadcast "servicename", "channelname", and "sourceid" properties? in general, the servicename property represents a tv broadcast service, which can have multiple channels defined by channelname properties the encoding used for these properties depends on the broadcaster the sourceid property uniquely identifies a source for scheduled tv programming tvhtv#tv broadcast#servicename#channelname#sourceid q21 in the "config xml" file, do i need to set the "devel api version" metadata key to the latest api version? the value of the "'http //samsung com/tv/metadata/devel api version" key within the tizen metadata element defines the api version used in the application for compatibility reasons, it is not required to be the latest api version; you can specify the minimum version needed to use all application features tvhtv#metadata#api version q22 can i enable the "background-support" attribute in the "tizen setting" element of the "config xml" file to keep the application running even when it is in the background? no since 2015 tv models, applications are automatically paused when they are hidden for compatibility reasons, in the "config xml" file, the background-support attribute must be set to "disable" do not modify it tvhtv#background support#config xml q23 why are the css styles in my application not working? make sure that your application is loading the css file check that your html code is valid and that your stylesheet link element is in the following format <link href="css/style css" rel="stylesheet" type="text/css" /> tvhtv#css q24 are family hub applications compatible with samsung tvs? the family hub platform is not fully compatible with that of samsung smart tvs to enable a family hub application to run on a samsung tv, you must modify the application to meet tv application specifications tv#family hub q25 can i develop applications for samsung professional displays? for information on developing applications for samsung professional display solutions, such as digital signage and hotel tvs, see samsung d forum b2b developers tvhtv#professional display q26 why am i unable to access the samsung d forum site content? the samsung d forum content has been migrated to the samsung developers smart tv site tvhtv#samsung d forum
We use cookies to improve your experience on our website and to show you relevant advertising. Manage you settings for our cookies below.
These cookies are essential as they enable you to move around the website. This category cannot be disabled.
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.
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.
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.
You have successfully updated your cookie preferences.