Using the Smart TV Emulator with VirtualBox & Troubleshooting
This guide explains usage of Virtual Box with the Smart TV Emulator
This Guide assumes that you have already installed the Smart TV SDK on your computer. If you have no installed the SDK, please refer to SDK 4.5 Installation Guide for Windows / Mac OS X / Linux
The Smart TV Emulator has been ported to the Linux Ubuntu operating system. To ensure that this port can be used on multiple platforms, it has been bundled as a Virtual Machine that is run in the Virtual Box virtualization tool. Virtual Box is a free and open-source tool that provides many tools for working with the guest (virtual) and host operating system.
The Emulator can be started in two ways:
- Started standalone via Virtual Box
- Started in the Smart TV App Editor IDE
To start the Emulator as standalone, first start Virtual Box. Then select the Emulator Virtual Machine and click “Start”:
To start the Emulator through the IDE, click the “Samsung Smart TV SDK” menu and select “Run Samsung Smart TV Emulator” or “Run Current Project in Samsung Smart TV Emulator” (if a Smart TV project is loaded with its top-level folder selected).
Click the red “Power” button to shutdown the Emulator and choose “OK”.
Additionally, the Emulator can be closed by closing the entire window. Virtual Box will prompt you with 3 choices.
“Send the Shutdown Signal” is the best way to gracefully close the entire Emulator.
“Save the Machine State” will restore the Emulator in the current state the next time it is started.
“Power Off The Machine” is the same as pulling the power plug out of a computer. You should NOT use this option as it prevents the virtual machine from properly shutting down.
In some computers which do not support hardware virtualization, the emulator may show following error when launched:
Virtual machines with more than one CPU cannot be launched in the computers which do not support hardware virtualization. Currently Samsung SmartTV Emulator virtual machine has 3 CPUs which is necessary to make AIR application work in the emulator.
How to Solve this Problem
It is possible to change number of CPUs while importing the machine as shown in following import virtual appliance dialog:
After that, the emulator will launched and all other applications except Adobe AIR apps can be tested in emulator.
Verify that the Emulator Virtual Machine is properly setup with the Shared Folder named “Apps” (case sensitive).
Right-click the Virtual Machine and select “Settings...“
On the Shared Folder tab, verify that the Shared Folder is set to a folder called “Apps” and that auto-mount is set to “Yes”:
Adobe AIR in the Smart TV Emulator requires that the Virtual Machine be configured for 3 processors (see picture below). By default, the Smart TV Emulator is configured this way.
However, PCs do not support multi-processor Virtual Machines (see the topic VirtualBox Error on Launching Emulator). In this case, the Smart TV Emulator should be limited to 1 processor and Adobe AIR will not be supported.
The Smart TV Emulator supports several USB devices such as gamepads and MIDI piano keyboards. If such a device is connected to the PC but it is not recognized by the Smart TV Emulator, please make sure it is added to the USB filter list:
- Start Oracle VM VirtualBox Manager
- Right-click on the Smart TV Emulator and choose Settings->USB
- Click the green “+” icon to add the USB device to the filter list (see picture below)
When displaying the SmartHub GUI, the Open App, Stop, and Refresh buttons will be disabled. Please launch an app in SmartHub by clicking the icon and close the app using the Exit key on the remote control (as done on a real TV). This behavior is designed to make Emulator’s behavior more similar to the real DTV. The list of apps in the SmartHub GUI will be refreshed only when the Emulator is restarted.