Introduction to Emulator
webOS TV emulator emulates webOS TV on your computer enabling you to test and debug apps on your computer. It runs on the Oracle VM VirtualBox to emulate webOS TV and emulates LG Smart+ TV remote control unit. Supported platform version for each emulator is as below.
|Emulator version||Supported webOS TV Version|
This article provides below:
- Emulator Limitations and Differences
- Installing Emulator
- Starting and Exiting Emulator
- Getting Familiar with Emulator UI
- User Input & Preloaded Apps
- APIs Supported on the Emulator
To learn about the main function of webOS TV emulator, see Using webOS TV Emulator.
The following describes what limitations webOS TV emulator has compared to webOS TV.
- The webOS TV platform UI is limitedly supported: launching/exiting Home UI is supported only.
- The TV tuner is not supported.
- Magic remote control is limitedly supported. The acceleration sensor is not supported.
- Supported codecs and containers are listed in Supported Media and DRM Formats.
- LG Content Store (LG Store) is not supported.
- Multi-sound works with multiple audio elements in the emulator. However, in real TV, you can only use one audio element in an app. See Playing Multi-sound for details.
The webOS TV emulator is automatically installed on your computer when you install the webOS TV SDK.
Using network installer, you can choose one or more versions of webOS TV emulator to install. For each emulator version, about 1.2 GB of hard disk space is required. To download the installer, visit Installation.
- Microsoft® Windows 7 (32-bit and 64-bit)
- Mac OS X 10.8 Mountain Lion, 10.9 Mavericks and 10.10 Yosemite (64-bit)
- Ubuntu 10.04, 12.04 / Ubuntu Mint 13 (Maya) (32-bit and 64-bit)
Starting the emulator activates the virtual machine and launches the main screen. Then, the remote control unit is launched.
Starting the emulator
- Windows: Select the shortcut menu in Start > webOS TV SDK or click the shortcut icon in Desktop.
- Mac OS: Select Finder > Favorites > Applications > webOS_TV_SDK and double-click the shortcut icon.
- Linux: Search the emulator by keyword "webOS" in Dash home and click the shortcut icon.
Exiting the emulator
- Press in the remote control unit emulator or click and select Exit.
- When confirmation popup window appears, click OK.
This is the screenshot of webOS TV emulator launched on the computer.
|①||Main Window||Displays emulator actions. This is in part of VirtualBox and has the same resolution as the LG Smart TV screen (1920 x 1080 Full HD). It can be resized or changed to full-screen mode.|
|②||Remote Control Unit Emulator||Emulates the remote control unit. The skin of the remote control unit can be changed. See Changing Remote Control Unit Skin.|
|③||Emulator Menu||Provides emulator main functions. Click , then sub menus appear: App Manager, Skin, Take Screenshot, Help, About and Exit.|
The user inputs of webOS TV emulator are similar to those of the webOS TV, using an HID keyboard, a mouse, and remote control unit emulator.
- Use a mouse to scroll up and down the page and navigate with the cursor.
- Use an HID keyboard to enter text in an app.
- The following keys are supported in remote control unit emulator.
- Power, Home, Back, OK, Left, Right, Volume, Mute
- Press Home key in remote control unit emulator for starting and exiting Home UI.
- Press Command key in the Mac OS computer, Windows key in the Windows computer, and Super key in the Linux computer for starting and exiting Home UI.
This figure shows the Home UI containing preloaded apps in webOS TV emulator v3.0.0.
- Web Browser: The same version of the web browser with a real device
- Welcome: An app showing the welcome message
- Bare App: Blank non-enyo web app
- BareMoon 2: Blank enyo moonstone app
- Enyo 2 Sampler: A comprehensive tour of Enyo and its libraries
To see which APIs are supported on each emulator version, go to API and check each subsection.