Echo Show Video Skill Certification Guidelines

The following guidelines detail the user experience requirements to certify your skill against. Review these guidelines carefully to ensure that your Echo Show video skill meets the certification requirements. The guidelines include a Certification Checklist of the individual test cases that Amazon reviews your skill against for skill launch quality.

Prerequisites and Notes

As part of the capability discovery payload, you declare the capabilities of your skill, such as channel change, quick play, and search. Your skill then needs to pass certification for those capabilities, following the guidelines listed. As you are creating your skill, list the capabilities that you plan to support in the testing instructions field.

The Certification Checklist provides a full list of supported utterances. Make sure you test your skill with all of the supported utterances before you consider your integration to be complete. Additionally, for any video provider hoping to support "play by title" and "search by title" utterances for video-on-demand content, you must complete catalog integration with Amazon. If you have not already integrated your catalog with Amazon, contact your Amazon Fire TV Solution Architect, and have them work on the integration process.

When you test your skill on an Echo Show device, make sure you target your skill through any of the following methods:

  • Explicitly target your skill: You can explicitly target your skill in your utterances by saying, "Alexa, play X on <provider>" or "Alexa, show me comedies on <provider>."

  • Launch your skill from Video Home: You can find your skill in Video Home by saying either "Alexa, show me videos" or "Alexa, go to video home," and then tapping your skill icon.

  • Launch your skill by means of voice: You can also open your skill by voice by saying "Alexa, open <provider>."

Overall

Your skill must meet the following overall requirements to pass certification.

Latency

  • Required: Your skill’s end-to-end latency should be comparable to or better than currently-live video skills on Echo Show.

Web Player

Your web player must meet the following requirements to pass certification.

Closed Captions

  • Required: Echo Show devices have a setting in which a user can toggle closed captions on and off across all video experiences. To create a unified experience across all players, video providers must adhere to this setting; if the user toggles the device setting On, the player should also toggle closed captions to appear within the video session. If the user toggles closed captions On in the player, the player needs to broadcast that so that the user can toggle the device setting. For more information about how to broadcast closed captions capabilities and touch events, see Echo Show Video Skill API Reference.

Error Handling

  • Required: If the player has trouble during playback, the player should handle the error and display an error message so that users are aware of what is happening and broadcast that error by means of the JavaScript Library so that Alexa is aware of the player issues for future voice interactions. For more information about how to broadcast errors, see Echo Show Video Skill API Reference.

Continuous Play for TV Series VOD

  • Recommended: If a user is currently watching a TV series, continuous play is recommended and supported. Once a new episode is playing, you must broadcast the capabilities of that next episode. If it is a single episode, you must honor the user’s request and close the session.

Play Video

If your skill supports the Play capability, you must meet the following requirements to pass certification.

Play by Title

  • Required: When the user asks to play a title (e.g., "Alexa, play 'The Good Place.'"), and the content is available for playback, you must return that content in your response. Note that you may see multiple entities in the directive you receive. This may be because Alexa identified multiple shows that match the title the user asked for. You should select the best one to play for the user.

  • Required: When the user asks to play a title by season and episode (e.g., "Alexa, play 'The Good Place,' Season 2 Episode 2."), and the content is available for playback, you must return that episode’s content identifier in your response.

  • Required: When the user asks to play a title by season, (e.g., "Alexa, play 'The Good Place,' Season 3."), and the content is available for playback, you should apply logic and return an episode within that season that makes the most sense for that user.

  • Recommendation: If it is unclear which episode of a TV series a user wants, send the last watched episode, if not completed. If the last watched episode is completed, send the next unwatched episode after that.

Play by Franchise

  • Required: For certain utterances, it is not actually clear to Alexa which content the user wants. For example, a user might say, "Alexa, watch Star Wars." In such a scenario, Alexa does not know if the user meant Star Wars: Episode 1, Star Wars: Episode 2, or even Star Wars: The Clone Wars. Such scenarios, which do not fit neatly into the season/episode model, are handled by "Play by Franchise." When a user conducts a play-by-franchise request, you receive the franchise that the user requested (in this case, Star Wars) in the directive, but the directive does not contain a catalog ID. For these directives, the expectation is that you conduct a search within your catalog for this content, and then return the mediaIdentifier for the top result from your search. Do not ignore the directive.

Play by Non-Title

  • Required: Alexa also supports non-title requests such as, "Alexa, play a comedy on <video provider>," or "Alexa, watch the Huskies games on <video provider>." For these requests, you should conduct a search within your catalog to identify video content that matches the request.

  • Recommended: Please leverage any personalization algorithms you may have to bias the result to the user.

If your skill supports the Search capability, you must meet the following requirements to pass certification.

Search by Title

  • Required: When users ask to search for a title (e.g., "Alexa, show me 'The Good Place.'"), and the content is available for playback, you must return that content in your response. Note that you may see multiple entities in the directive you receive. This may be because Alexa identified multiple shows that match the title the user asked for.

  • Required: When the user asks to search for a title by season and episode (e.g., "Alexa, find 'The Good Place,' Season 2 Episode 2."), and the content is available for playback, you must return that episode’s content identifier in your response.

  • Required: When the user asks to search for a title by season, (e.g., "Alexa, find 'The Good Place,' Season 3."), and the content is available for playback, you should return an episode list within that season.

  • Required: When the user asks to search for a TV series and does not specify an episode or season (e.g., "Alexa, show me 'The Good Place.'"), and the content is available for playback, you should return a list of available seasons of that TV series. If only one season is available, you should return a list of all available episodes.

  • Recommendation: You should send back related video content to the user in any search request. This helps the user discover more content on the device.

Search by Franchise

  • Required: For certain utterances, it is not actually clear which content the user wants. For example, a user might say, "Alexa, find Star Wars." In such a scenario, Alexa does not know if the user meant Star Wars: Episode 1, Star Wars: Episode 2, or even Star Wars: The Clone Wars. Such scenarios, which do not fit neatly into the season/episode model, are handled by "Search by Franchise." When a user conducts a search by franchise request, you receive the franchise that the user requested (in this case, Star Wars) in the directive, but the directive does not contain a catalog ID. For these directives, the expectation is that you conduct a search within your catalog for this content, and then return the mediaIdentifier for the top result from your search. Do not ignore the directive.

  • Recommendation: You should send back related video content to the user in any search request. This helps the user discover more content on the device.

Search by Non-Title

  • Required: Alexa also supports non-title requests such as "Alexa, find a comedy on <video provider>" or "Alexa, find football on <video provider>." For these requests, the expectation is that you conduct a search within your catalog and return a list of titles that matches the search request.

  • Recommended: Please leverage any personalization algorithms you may have to bias the result to the user.

Search Artwork

  • Required: Artwork returned to the user should be applicable to the title. The artwork should make it easier for the user to identify the content you are recommending from his or her search.

Search Recommendations

  • Required: If you cannot find any results matching the user’s request and return zero results in your response, you receive a second SearchDisplayableItems request with the SortType = Recommended. You can then return a set of recommended videos to the user in your response. Alexa tells the user that there are no search results, but that Alexa recommends this content to the user.

Channel Change

If your skill supports the Channel Navigation capability, you must meet the following requirements to pass certification.

Channel Navigation

  • Required: When the user says "Alexa, tune to CNN," and the content is available for playback, you must return that channel for playback.

Transport Controls

If the content that is actively playing in your web player supports any of these transport control capabilities, you must meet the following requirements to pass certification.

Pause

  • Required: During playback, when a user says "Alexa, pause," you get an event through the JavaScript bridge. This should result in the same action as if the user had pressed the Pause button on your player.

Play/Resume

  • Required: During playback, if the user pauses the video and then says, "Alexa, pause" or "Alexa, resume," you get an event through the JavaScript bridge. This should result in the same action as if the user had pressed the Play button on your player.

Next

  • Required: While watching content, a user could say "Alexa, next." This command should take the user to the next episode. If that is not possible, then it should take the user to the next related video content that you choose to show the viewer (or whatever is next in the playlist you choose to use). Keep the action you take aligned with what action you take for Previous.

Previous

  • Required: While watching content, a user could say "Alexa, previous." This command should take the user to the previous episode. If that is not possible, then it should take the user to whatever was earlier in the playlist you choose to use. Keep the action you take aligned with what action you take Next.

Fast Forward X Seconds/Minutes/Hours

  • Required: While watching content, a user could say "Alexa, fast forward 5 minutes." You receive this directive through the JavaScript bridge. This directive includes an offset value in milliseconds. A negative value indicates rewind, and a positive value indicates fast forward. You must fulfill the user’s request by going forward by the specified offset.

Rewind X Seconds/Minutes/Hours

  • Required: While watching content, a user could say "Alexa, rewind 5 minutes." You receive this directive through the JavaScript bridge. This directive includes an offset value in milliseconds. A negative value indicates rewind, and a positive value indicates fast forward. You must fulfill the user’s request by going back by the specified offset.

Category-Based Landing Page

If your skill supports the Category-Based Landing Page capability, you must meet the following requirements to pass certification.

Categories

  • Required: All categories returned should return artwork.

  • Required: The minimum of three categories should be returned for your landing page.

  • Required: Category selection by voice and touch should always return titles for that category. At this point, you should have worked with your Amazon contact to determine which categories to support at launch. If you have a category that is generating an error, contact your Amazon point of contact (POC) to escalate.

  • Recommended: Artwork should be the artwork for the first title that you return for that category.

  • Recommended: The artwork should have no text on it, as the category name appears on top of the art.

Hero Title

  • Required: The background hero image should not have any text.

Sample Utterance List

The following table shows the sample utterances you can use to test the certification criteria.

Category Feature Utterance
Channel Nav Network Name watch
Channel Nav Network Name go to
Channel Nav Network Name tune to
Channel Nav Network Name turn on
Channel Nav Network Name change the channel to
Channel Nav Network Name change to
Channel Nav Network Name switch to
Channel Nav Number watch channel
Channel Nav Number go to channel
Channel Nav Number tune to channel
Channel Nav Number turn on channel
Channel Nav Number change the channel to channel
Channel Nav Number change to channel
Channel Nav Number switch to channel
Play franchise watch
Play franchise play
Play title watch
Play title play
Play team watch game
Play team play game
Play team watch the
Play team play the
Play season + episode watch season <number> episode <number></number></number>
Play season + episode play season <number> episode <number></number></number>
Play season watch season <number></number>
Play season play season <number></number>
Play sport watch
Play sport play
Play sport watch games
Play sport play games
Play sport watch match
Play sport play match
Play league watch games
Play league play games
Play league watch
Play league play
Play genre watch
Play genre play
Play genre watch movies
Play genre play movies
Play genre watch tv shows
Play genre play tv shows
Play genre watch shows
Play genre play shows
Play actor watch movies
Play actor watch tv shows
Play actor watch shows
Play actor play movies
Play actor play tv shows
Play actor play shows
Play actor watch shows with
Play actor watch movies with
Play actor watch tv shows with
Play actor play shows with
Play actor play movies with
Play actor play tv shows with
Search franchise seach for
Search franchise show me
Search franchise find
Search title search for
Search title show me
Search title find
Search sport show me
Search sport search for
Search sport find
Search sport show me games
Search sport search for games
Search sport find games
Search sport show me matches
Search sport search for matches
Search sport find matches
Search league show me
Search league search for
Search league find
Search league show me games
Search league search for games
Search league find games
Search league show me matches
Search league search for matches
Search league find matches
Search team show me games
Search team search for games
Search team find games
Search team show me
Search team search for
Search team find
Search genre show me
Search genre search for
Search genre find
Search genre show me movies
Search genre search for movies
Search genre find movies
Search genre show me tv shows
Search genre search for tv shows
Search genre find tv shows
Search actor show me
Search actor search for
Search actor find
Search actor show me movies
Search actor search for movies
Search actor find movies
Search actor show me tv shows
Search actor search for tv shows
Search actor find tv shows
Search actor show me movies with
Search actor search for movies with
Search actor find movies with
Search actor show me tv shows with
Search actor search for movies with
Search actor find movies with
Search season + episode show me season <number> episode <number></number></number>
Search season + episode search for season <number> episode <number></number></number>
Search season + episode find season <number> episode <number></number></number>
Search season show me season <number></number>
Search season search for season <number></number>
Search season find season <number></number>
Search CharacterName show me movies
Search CharacterName search for movies
Search CharacterName find movies
Search CharacterName show me
Search CharacterName search for
Search CharacterName find
Transport Controls Pause/resume pause
Transport Controls Pause/resume resume
Transport Controls Pause/resume play
Transport Controls Pause/resume watch
Transport Controls Pause/resume unpause
Transport Controls Seek rewind <duration in seconds, minutes, hours>
Transport Controls Seek fast forward <duration in seconds, minutes, hours>
Transport Controls Seek skip back <duration in seconds, minutes, hours>
Transport Controls Seek skip forward <duration in seconds, minutes, hours>
Transport Controls Seek skip ahead <duration in seconds, minutes, hours>
Transport Controls Skip skip back
Transport Controls Skip skip ahead
Transport Controls Skip skip forward
Transport Controls Skip rewind
Transport Controls Skip fast forward
Transport Controls Skip jump back
Transport Controls Skip jump ahead
Transport Controls Skip jump forward
Transport Controls Next/Previous next video
Transport Controls Next/Previous next episode
Transport Controls Next/Previous next movie
Transport Controls Next/Previous next show
Transport Controls Next/Previous next tv show
Transport Controls Next/Previous next
Transport Controls Next/Previous previous video
Transport Controls Next/Previous previous episode
Transport Controls Next/Previous previous movie
Transport Controls Next/Previous previous show
Transport Controls Next/Previous previous tv show
Transport Controls Next/Previous previous show
Transport Controls Restart restart this
Transport Controls Restart restart
Transport Controls Restart start from the beginning
Transport Controls Restart start this over
Transport Controls Restart start over
Transport Controls Restart start this movie over
Transport Controls Restart start this show over
Transport Controls Restart restart movie
Transport Controls Restart restart show
Transport Controls Restart go back to the beginning
Transport Controls Restart play from the start
Transport Controls Restart watch from the beginning
Transport Controls Restart play that from the beginning