Content Launcher Certification for Catalog and Voice Customer Experience
Open Beta Documentation Amazon offers this technical
documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback
and iterates on the features. For the most current feature information, see the Release
Notes.
This page describes the certification test cases for all catalog integrated apps.
Requirements for launching content through the remote
Changing from unauthenticated to authenticated state
Use the Account Login API to notify Fire TV that the app is in a logged-in state.
Expected result:
- The app should send the login status
true, indicating entitlement after login. - The app tile will be listed under “Watch Now" on the content detail page.
Changing from authenticated to unauthenticated state
Use the Account Login API to notify Fire TV that the app is in a logged-out state.
Expected result:
- Your app should send login status
falseafter logout. - The app tile will be listed under “Subscribe" on the content detail page.
Handling playback in authenticated state
Make your content able to launch from the Fire TV Home screen once the user has logged in.
Expected result:
- Your app is listed under "Watch Now" or "Watch Free" on the content detail page on the Fire TV Home screen.
- Clicking the app tile on the content details page should launch your app and start content playback immediately, without requiring the user to re-authenticate or navigate to the content detail page within the app.
Handling playback in unauthenticated state
Your app should show a sign-in or sign-out page when launched from the Fire TV Home screen if the user is logged out.
Expected result:
- Your app is listed under "Subscribe" on the content detail page on the Fire TV Home screen.
- Clicking the Subscribe button should launch your app and display the sign-up or sign-in screen.
- Your app should start playing the selected content without requiring further navigation once the user successfully signs in or subscribes.
Requirements for watch utterances
Imnplement watch or play utterances in the Content Launcher API.
| Feature | Sample utterances | Expected response |
|---|---|---|
| Watch [title] | "Watch Breaking Bad" | The requested media plays. If there are multiple matches for the content, the user is prompted to choose. |
| Watch by actor | "Watch Sean Connery" | Media with that actor plays using an algorithm that selects the best match for the user. |
| Watch by genre name | "Watch comedy" | Media from the requested genre plays, using an algorithm that selects recommended media. Another options is to give the user a list of results. |
| Watch by franchise [title] | “Watch Star Trek" | Either the top recommended result for the requested franchise plays, or give the user a list of matching franchises. |
| Watch by media type | "Watch a movie" | Either media matching the non-title request plays using an algorithm that selects recommended media. Another options is to give the user a list of results. |
| Watch [title] with season number | “Watch Breaking Bad season two" | Unless an the episode was completed, the last watched episode in the series plays. If that episode was completed, the next unwatched episode plays. |
| Watch [title] with episode number | “Watch Breaking Bad episode five" | The correct season is identified by the user's last-watched episode. Unless an the episode was completed, the last watched episode in the series plays. The next episode plays if the last-watched episode was completed. |
| Watch [title] with season and episode number | "Watch Breaking Bad season two, episode five" | The content for the requested season and episode plays. |
| Watch by character name | "Watch James Bond" | Either media matching the character name plays through an algorithm that selects recommended media. Another option is to give the user a list of media results. |
| Watch by sports team | “Watch Seahawks" | Either media matching the sports team plays through an algorithm that selects recommended media. Another option is to give the user a list of media results. |
| Watch by sports type | “Watch soccer" | Either media matching the sports type plays through an algorithm that selects recommended media. Another option is to give the user a list of results. |
| Watch by sports league | "Watch N. B. A. league" | Either media matching the sports league plays through an algorithm that selects recommended media. Another option is to give the user a list of results. |
| Watch by sports event | “Watch soccer game" | Either media matching the sports event plays through an algorithm that selects recommended media. Another option is to give the user a list of results. |
Requirements for search utterances (in-app search)
Support the search/find utterances below by implementing the Content Launcher API.
| Feature | Sample utterances | Expected response |
|---|---|---|
| Search for [title] | "Search for Breaking Bad" | The user is given a list of matches for the title. |
| Search by actor | "Search for Sean Connery" | THe user is given a list of matches featuring the actor. |
| Search by genre name | "Search for comedy" | The user is given a list of matching results for media from the requested genre. This is personalized through an algorithm that selects recommended media. |
| Search [title] with episode number | "Search for Breaking Bad episode five" | A list of available episodes in the season the user recently watched appears. For example, if the user is currently on Season 2, a list of episodes from Season 2 appears. |
| Search [title] with season and episode number | "Search for Breaking Bad, season two, episode five" | A list of available episodes for the season the user requested appears, including the episode the user asked for. |
| Search [title] with season number | "Search Breaking Bad, season two" | The user is presented with all episodes for the matching season. |
| Search by franchise [title] | “Watch Star Trek" | The user is given a list of matching results for the franchise. |
| Search by media type | "Search for a movie" | The user is given a list of matches for the desired media type. |
| Search for by character name | "Search for James Bond" | The user is given a list of matching results for media featuring the character's name. |
| Search by director name | "Search for Quentin Tarantino" | The user is given a list of matching results for media produced by that director. |
| Search by production company | "Search for Disney" | The user is given a list of matching results for media from that production company. |
| Search for by sports team | "Search Seahawks" | The user is given a list of matching results for that sports team. |
| Search for by sports type | "Search for soccer" | The user is given a list of matching results for that type of sport. Ideally, it should be based on recommendations for that user. |
| Search for by sports league | "Search for N. B. A. league" | The user is given a list of matching results for that sports league. Ideally this is based on recommendations for that user. |
| Search for by sports event | Search for soccer game" | The user is given a list of matching results for that sports event. Ideally this is based on recommendations for that user. |
Requirements for transport control utterances
Alexa supports the following Transport Control utterances.
| Feature | Sample utterances | Expected response |
|---|---|---|
| Pause | "Pause" | The media pauses, similar to if you pressed the Pause button on your web player or remote control. |
| Play | "Play" | The media plays, similar to if you pressed the Play button on your web player or remote control. |
| Stop | "Stop" | The media stops, similar to if you pressed the Stop button on your web player or remote control. |
| Resume | "Resume" | The media resumes play, similar to if you pressed the Play button on your web player or remote control. |
| Start over | "Start over" | The media starts over, adjusting the seek position back to the beginning of the media. |
| Fast Forward | "Fast Forward" | The media fast-forwards 10 seconds. |
| Rewind | “Rewind" | The media rewinds 10 seconds. |
| Previous | "Previous" | The previous episode plays. If this isn't possible, the user is taken to whatever was earlier in the current playlist. |
| Next | "Next" | The next episode plays. If this isn't possible, the user is taken to whatever is next in the current playlist. |
| Fast Forward [duration] | "Fast Forward thirty seconds" | The media fast-forwards for the requested duration. |
| Rewind [duration] | "Rewind forty seconds" | The media rewinds for the requested duration. |
Note: The W3C Media Player API does not support the Next and Previous commands. Implement Next and Previous with the Vega Media Controls API.
Last updated: Sep 30, 2025
