- System Requirements
- Google TV AVDs
- Running Google TV emulation
- TV and media control keys
- The emulator and openGL
The Android emulator for SDK Tools revision 12 and higher supports Google TV emulation, as part of the emulator's x86 platform emulation. Google TV emulation runs automatically for an Android Virtual Device (AVD) that targets the Google TV system image.
To run Google TV emulation, you need the Google TV add-on.
- Android SDK system requirements for Google TV application development, as documented in the topic Setting Up a Development Environment.
- The Google TV add-on. To learn about the add-on, please read the topic Google TV Add-On.
- Virtual Machine (VM) acceleration. To configure VM acceleration, system's CPU must support one of the following virtualization extensions technologies:
- Intel Virtualization Technology (VT, VT-x, vmx) extensions
- AMD Virtualization (AMD-V, SVM) extensions (only supported for Linux)
Google TV AVDs
In general, AVD files for Google TV devices use the same settings as AVDs for other devices that run Android.
To learn more about AVDs, please read the topic Managing Virtual Devices.
The following settings are best for emulating the Google TV platform:
- AVD target of GoogleTV Addon (Google, Inc.) - API Level 13.
- Screen resolution of 720p or 1080p.
The CPU type is automatically set to Intel Atom (x86) and can't be changed.
The default settings for the Hardware: section are sufficient for most applications.
You only need to set the SD Card size when you are testing local media storage. Larger SD card sizes cause the emulator to run progressively slower.
When you enable Snapshot, the emulation state is saved when you shut down the emulator and restored when you re-start with the same AVD. This can significantly improve startup time.
Running Google TV emulation
Prerequisite: Virtual Machine acceleration should be enabled on your system for Google TV emulation to work smoothly. For more information on how enable this for your OS, see Configuring Virtual Machine Acceleration.
Emulation for Google TV starts automatically when you execute the
with an AVD based on the Google TV target.
emulator program has the same name as previous versions of the Android
emulator. Starting with Android SDK Tools, revision 12,
emulator runs either
the x86 emulator (
emulator-x86) or ARM emulator (
emulator-arm) based on
the AVD you specify.
To run the emulator from the command line, enter the following:
$ emulator -avd <GoogleTV_avd_name> <other_flags>
<GoogleTV_avd_name> is the name of the AVD you want to run, and
any other flags you want.
The emulator screen appears. The display is a TV screen, including the TV's physical bezel. In the lower right-hand corner, the four standard Android buttons appear. These only appear in the emulator, and they're provided to help you navigate in Android apps.
You can also run the emulator from the Android SDK and AVD Manager, by clicking Start on the righthand side of the window. In Eclipse, the emulator starts automatically when you set up a run configuration to use an AVD as the target device.
Live TV emulation
Google TV emulation supports live TV. You can't use an actual TV signal, but live TV applications and features still work. Emulation uses the same process as a Google TV device; you choose an actual TV provider from a list that is based on a ZIP code you enter. You can also choose generic video if you aren't interested in working with live TV emulation.
When you choose a TV provider, the emulator populates the Channel
Listing content provider, so you can use emulation to test your access to the provider. You can also
emulate tuning to a particular channel with the
and the URI for the channel, as described
in the section "Programmatic
channel control" in the topic Features
Specific to Google TV.
To set up live TV:
- To run the Live TV Player, click the TV icon in the bottom navigation bar.
- In the No paired devices found dialog, click Video input.
- The Video input dialog appears. To use live TV emulation, click Emulator video source.
- The Add new device dialog appears. In it, you see an emulation of a video signal. Click Next to continue.
You see a text box entitled Enter your ZIP code. Enter a ZIP code.
Note: You can enter any ZIP code you wish. Use a ZIP code whose TV providers you're familiar with. Google TV uses the ZIP code to display local TV providers. You will choose a specific provider in a subsequent step.
- Below the text box, Google TV displays the city and state corresponding to the ZIP code you entered. Click Set to continue.
- The Provider dialog displays. On the lefthand side, you see a list of local TV providers. On the righthand side, you see an emulated TV signal.
- Use the keyboard arrow keys to scroll through the list of local providers. Click the provider you want.
- The Premium channels dialog appears. If you want to emulate receiving these channels, click Yes, otherwise click No.
- The emulator switches to "live TV" mode. You may see a color test pattern and an error message. You can ignore this.
- To leave Live TV Player, click the Home icon in the lower righthand corner of the screen.
Notice that steps 3 through 10 repeat a user's experience in adding a new TV signal device to a Google TV hardware device.
Note: Remember that leaving Live TV Player and going to Home switches the focus to Home's main activity, but Live TV Player remains paused in memory. In the emulator, this may degrade performance. To unload Live TV Player entirely, click and hold the Back icon in the lower righthand corner of the screen. This emulates a long press of the Back button on the Google TV keyboard.
To change these settings once you've done the setup, open the Settings application and select Video input.
TV and media control keys
Android SDK Tools revision 14 includes support for the TV and media control buttons that appear on the bezel of the Google TV emulator screen. These buttons emulate certain keys on Google TV device keyboards that are usually not available on a regular computer keyboard. Figure 1 shows the emulator screen and the buttons. Table 1 is a key to the function of each button:
Figure 1. Google TV emulator screen with tv and media control buttons
|1||Channel down||Click to select a channel number one less than the current channel.|
|2||Channel up||Click to select a channel number one more than the current channel.|
|3||TV||Turn on Live TV (Launch the built-in Live TV application)|
|4||PiP||Toggle Picture-in-Picture (PiP) mode|
|5||Previous||Skip to the previous track, chapter, or section|
|6||Rewind||Move the time marker backwards through the media stream, at a speed faster than that for normal playback.|
|7||Play||Start (or resume) playing the media stream forward from the current position of the time marker.|
|8||Pause||Pause playing the media stream. Leave the time marker at the current position.|
|9||Stop||Stop playing the media stream. Move the time marker to the beginning of the stream|
|10||Forward||Move the time marker forwards through the media stream, at a speed faster than that for normal playback.|
|11||Next||Skip to the next track, chapter, or section|
|12||Favorites||Display the Favorites links|
|A||Android keys||Standard Android device keys (Home, Menu, Back, Search)|
Table 1. Emulator screen buttons
The emulator and OpenGL
When you use the emulator, you may not see the same performance in graphics that you see with a hardware device.