How to setup Android TV virtual device for Streamit TV App Installation ?

Android TV virtual device for Streamit TV App Installation Guide

This guide explains how to create an Android TV Virtual Device (AVD) for installing and testing the Streamit TV App.

Prerequisites

Android Studio installed.
Flutter SDK installed.
Streamit-laravel-flutter-tv-app project downloaded.

Important

Starting with Streamit TV App v4.0.2 (Flutter 3.35+), only x86_64-based Android TV and Google TV emulator images are supported.

Legacy Android TV emulator images using the x86 architecture are no longer supported and may cause application startup failures or unexpected runtime behavior.

Step 1: Open Android Studio Device Manager

Launch Android Studio and click:

More Actions → Virtual Device Manager

Step 2: Create a New Android TV Virtual Device

Inside Device Manager:

1. Click the + (Add Device) button.

2. Select the TV category.

3. Choose Television (1080p).

4. Click Next.

Step 3: Select a Supported x86_64 System Image

Choose one of the following system images:

Recommended

Android TV Intel x86.64 Atom System Image

Alternative

Google TV Intel x86.64 Atom System Image

Verify the following before proceeding:

Property	Value
ABI	x86_64
Services	Google APIs
API Level	36.0 or later

Do not select the following unsupported images:

Android TV Intel x86 Atom System Image

Google TV Intel x86 Atom System Image

After selecting a supported system image, click Finish.

Step 4: Download the System Image (If Required)

If the selected system image is not installed, Android Studio will prompt you to download it.

1. Click the download icon beside the system image.

2. Accept the license agreement.

3. Wait for the installation to complete.

4. Click Finish.

Step 5: Launch the Android TV Emulator

After the virtual device has been created:

1. Return to Device Manager.

2. Locate the newly created TV emulator.

3. Click the Play button.

Wait for the Android TV home screen to load completely.

Verify Emulator Configuration

Before running the application, confirm the emulator meets the following requirements:

Setting	Required Value
Device Type	Android TV / Google TV
ABI	x86_64
Services	Google APIs
API Level	36.0 or later

Access Device Manager

After configuration, you can access the Device Manager:

1. Click on the “Device Manager” button in the top right of Android Studio.

2. This will open the device management panel where you can start, stop, or manage your virtual devices.

3. From here, you can launch your newly created Android TV virtual device.

4. After starting the Android TV virtual device, run Streamit TV App.

Using D-Pad Navigation

Android TV applications rely on D-pad navigation rather than touch input:

1. Click on the “Extended Controls” button in the top right of Running Devices Menu Bar in Android Studio.

2. It will open up a D-PAD Controls.

When testing your app in the emulator, use the arrow keys on your keyboard to simulate D-pad movement.
Press Enter/Return to simulate the center “OK” button.
Use Escape or Back keys to simulate the back button.

Run Streamit TV App

Verify that Flutter detects the emulator:
flutter devices

Run the application:

flutter run

The Streamit TV App should now launch successfully on the Android TV emulator.

Troubleshooting

Application Does Not Launch

Verify that:

The emulator uses the x86_64 ABI.
You are not using an Android TV x86 system image.
Android Emulator is updated to the latest version.
Flutter SDK is updated.

Emulator Is Not Detected

Run:
flutter doctor

and ensure Android Studio, Android SDK, and Android Emulator are configured correctly.