Developer Console

Implementing Search (Fire TV)

Implementing search in Amazon Fire TV requires you to understand some key differences with text search and voice search.

Text Search in Apps

Text search within an app refers to any specific text-search features you have specifically coded within your app. Text search for your app is not available by default on Amazon Fire TV.

Amazon Fire TV provides a global text search available from the Fire TV home screen. The global text search returns results from the Amazon Catalog. In order for your media to appear in global text search results, you must integrate your app's media into the Amazon Catalog.

Voice Search

Amazon Fire TV also provides voice capabilities through the voice-enabled remote control. In addition to the Alexa voice capabilities on Fire TV, users can also use natural language to search for TV shows, movies, and other media.

Regardless of where users are in Fire TV, when they press the microphone button on a voice-enabled remote and say the TV show or Alexa actions they want, this action initiates a global search using the Alexa cloud service instead of the Leanback library.

Media requests through voice always return content from the Amazon Catalog. If you want your app's media to appear in these results, you must integrate your app's media into the Amazon Catalog.

If the user already has your app installed, your app's content can appear directly in the catalog results. If a user doesn't have your app, a "More Ways to Watch" option appears for users to get your app and view the content. (Note that catalog integration is only recommended as an option for apps whose content is the same for all customers.)

Avoiding Speech Recognition Errors from Leanback

Because Alexa is used for voice interactivity on Amazon Fire TV instead of the Leanback library, you must disable any speech recognition with the Leanback library’s SearchFragment class for your Fire TV app. If you don't disable speech recognition, your app will potentially return errors when users perform searches.

In Leanback's SearchFragment class, the startActivityForResult method looks for the speech recognizer. Since Fire TV does not support this speech recognizer, this action produces an error. To avoid the error, override the onCreate() method and comment out the speech recognition callback so that the method does not run. Here's an example:

setSpeechRecognitionCallback(() -> {
    if (DEBUG) Log.v(TAG, "recognizeSpeech");
    try {
        //startActivityForResult(getRecognizerIntent(), REQUEST_SPEECH);
    catch (ActivityNotFoundException e) {
        Log.e(TAG, "Cannot find activity for speech recognizer", e);

Here the startActivityForResult method is simply commented out, so the speech recognition feature will not run and no error will result.

Alexa Skills and Apps

You cannot create an Alexa-powered voice search specific to your app, returning media results from your app only. You can access any Alexa skill on Fire TV, but the skills are voice-only experiences. The voice skills do not interact with native apps on Fire TV. As such, there are no ways for an Alexa skill you create to control your app.

Last updated: Oct 29, 2020