Samsung TV Simulator is a light-weight tool that provides many settings and features for testing Samsung Web applications on a computer. You can use the simulator features to debug your applications.
TV Emulator
The Samsung TV Simulator simulates the runtime environment of Samsung TV Web applications and other Samsung display device Web applications. You can test your applications on the simulator and save significant development and testing time. The simulator is useful when quick prototype development is required. It is suitable for UI development or testing application features which use basic Samsung Product APIs or Tizen APIs.
To use the simulator, the Samsung TV SDK must be installed.
You can launch an application in the simulator in the following ways:
Using the Tizen Studio In the "Project Explorer" view, right-click an application project and select "Run as > Tizen Web Simulator Application (Samsung TV)"
Figure 1. Launching an application from the Tizen Studio
Installing a ".wgt" file in the simulator To run the simulator and install the application separately:
Figure 2. Installing a ".wgt" file using the context menu
The simulator provides various features to help you test and debug your applications:
Standard Web technologies The simulator supports standard Web technologies, such as HTML5, JS, and CSS. It also simulates some Samsung Product APIs, but the APIs which have strict dependencies on device hardware or core TV-specific modules are not supported.
If your application is highly dependent on device hardware or TV-specific APIs, testing on the simulator is not recommended. Checking security rules using the simulator is not recommended.
Note Some API functions return dummy values when tested on the simulator.
Some API functions return dummy values when tested on the simulator.
Web Inspector You can use the Web Inspector to debug applications. To launch the Web Inspector, right-click the simulator and select "Web Inspector".
Figure 4. Web Inspector
Multiple scaling levels You can test how an application appears at different screen scales. Right-click the simulator, select "Scale Screen", and select the scale you want.
Figure 5. Scaling levels
Full-screen mode You can view the application at the maximum possible size of your computer monitor. Right-click the simulator and select "Full Screen".
Figure 6. Full-screen mode
Multiple remote control types You can simulate multiple types of remote controls. Right-click the simulator, select "Change Remote Control", and select the type you want.
Figure 7. Remote control types
TV model configuration You can simulate different device configurations. Right-click the simulator and select "Configuration Settings".
Figure 8. Device model configuration
Portrait orientation support You can test your application on a simulated screen in portrait orientation. The behavior of this feature depends on the screen-orientation parameter value in the application's "config.xml" file. If screen-orientation is set to portrait or landscape, the simulator switches to the respective orientation when the application is launched. If it is set to auto-rotation, you can switch the orientation by right-clicking the simulator and selecting "Change Orientation".
screen-orientation
portrait
landscape
auto-rotation
Figure 9. Simulator in portrait mode
Application uninstallation You can remove applications which were installed on the simulator during testing. Right-click the simulator and select "Uninstall Applications".
Figure 10. Uninstalling applications
Note Applications can be uninstalled only when no applications are running. If an application is running, the "Uninstall Applications" menu item is disabled.
Applications can be uninstalled only when no applications are running. If an application is running, the "Uninstall Applications" menu item is disabled.
Unlike Samsung devices, the simulator does not actually run the Samsung device platform. The simulator is a WebKit-based application that simulates Samsung Product APIs using a JavaScript backend. As a result, the simulator does not support any features that have strict dependencies on device hardware or core Tizen modules.
The following features are not supported by the TV simulator:
Note Always perform your final application testing on a target device.
Always perform your final application testing on a target device.
The simulator has the following known issues:
The following video provides a visual overview of the simulator features.