Echo Show Video Skill Feature Guide

This guide describes the features for video skills on Echo Show that you can build and those that are built-in.

Features That You Can Build

Skill Enablement

For users to access video content on Echo Show devices, they must enable a video provider’s skill.

You have to choose whether account linking is required for your users to enable your skill. When you require account linking, the user needs to log in or authenticate with you to access content. Alexa Skills Kit (ASK) uses OAuth 2.0 to enable account linking. You provide an authorization URL that Alexa surfaces as a web view for users to log in. For information about OAuth 2.0, see Understand Account Linking.

You can add to your login page an option for users to start a new subscription or create an account. If you do this, you should ensure that this upsell is not made available on iOS.

The user can disable a video provider’s skill at any time in the Alexa app.

Alexa prompts users to enable a video provider’s skill in the following ways:

  • On device:
    • When the user says “Alexa, open <video provider>.”
    • When the user explicitly targets the video provider in a search, play, or channel navigation utterance. For example, “Alexa, play <title> on <video provider>.”
    • When the user taps on the video provider’s icon in the Video Home page of the Echo Show.
    • In the Alexa app, when the user goes through the skill enablement process. They can access the skill enablement process either through the Music, Video & Books section or in the Alexa Skills Store. If account linking is required, the app prompts the user to log in. If account linking is not required, the app asks the user to confirm they want to enable the skill.

Play Video

Users can play content from a provider by title or non-title (genre, actor, media type, etc.) by either being explicit or implicit (not specifically targeting the provider). Playback takes place on a web player you control. If a user has your skill enabled on an Echo Show device, Alexa makes a call to your AWS Lambda with a play request in the following scenarios:

  • Explicit title and non-title requests, when the content is available in your catalog. For example, “Alexa, play 'Man in the High Castle' on Prime Video.”
  • Implicit title and non-title requests, when the user is active on your experience, provided the content is available in your catalog. For example, “Alexa, play 'Man in the High Castle.'”
  • Title requests for content that is exclusively available in your catalog.
  • When more than one video provider can play the requested title, Alexa disambiguates between providers. For example, “I can play that on <video provider 1> or <video provider 2>, which would you like?” Alexa makes a call to your AWS Lambda when the user chooses your skill because of the disambiguation prompt.

Playback Controls

Users can use both voice and touch to control playback. The following table shows all the playback controls Alexa supports on Echo Show devices.

  Playback Control User Experience
1 Pause / Stop Pauses playback
2 Play / Resume Plays or resumes playback
3 Fast Forward Fast forwards 10 seconds
4 Rewind Rewinds 10 seconds
5 Fast Forward by Duration Fast forwards by the specified amount
6 Rewind by Duration Rewinds by the specified amount
7 Next Video provider decides the title that is played
8 Previous Video provider decides the title that is played
9 Closed Captions On/Off Turns closed captions on and off

Channel Navigation

Users can navigate to the different channels that a video provider offers with explicit or implicit (not specifically targeting the provider) utterances. Users can navigate to a linear channel you offer, even if your offering includes only one channel. Playback takes place on a web player you control. If a user has your skill enabled on an Echo Show device, Alexa makes a call to your AWS Lambda with a channel navigation request in the following scenarios:

  • Explicit requests for channels when the content is available in your catalog. For example, “Alexa, tune to <channel> on <video provider>.”
  • Implicit requests for channels when the user is active on your experience, if the content is available in your catalog. For example, “Alexa, tune to <channel>.”
  • When more than one video provider can tune to a channel, Alexa disambiguates between providers. For example, “I can play that on <video provider 1> or <video provider 2>. Which would you like?” Alexa makes a call to your AWS Lambda when the user chooses your skill because of the disambiguation prompt.

Users can search for content from a video provider. Users can search for titles or non-titles (media type, genre, actor, etc.) either by being explicit or implicit (not specifically targeting the provider). If a user has your skill enabled on an Echo Show device, Alexa makes a call to your AWS Lambda with a search request in the following scenarios:

  • Explicit title and non-title requests, when the content is available in your catalog. For example, “Alexa, show me TV shows on <video provider>.”
  • Implicit title and non-title requests, when the user is active on your experience, if the content is available in your catalog. For example, “Alexa, find 'Man in the High Castle.'”
  • Title requests for content that is exclusively available in your catalog.
  • When more than one video provider offers the requested title or non-title, Alexa disambiguates between providers. For example, “I can find that on <video provider 1> or <video provider 2>, which would you like?” Alexa makes a call to your AWS Lambda when the user chooses your skill as a result of the disambiguation prompt.

Additional considerations for search:

  • For each search query you receive, you must return a list of titles (with their respective metadata), and in the order in which those titles should be displayed to users. The titles you return are rendered in a Search Results template, which you can customize with your logo. For an example of this template, see Echo Show Video Skill API Reference.
  • Users can select search results by means of voice and touch. The search results template also offers numbered results, so that the user can ask Alexa to “Play number 3” from the list of results.
  • Alexa does not show results that combine titles from multiple video providers. If more than one video provider can offer search results in one category (i.e., “Alexa, show me movies.”), Alexa disambiguates across providers and shows search results from the provider that the user chooses.

Video Provider’s Landing Page

Users can access this landing page with utterances such as “Alexa, open <video provider>” or when the user taps on the video provider’s icon in the Video Home page.

  • This landing page uses a voice- and touch-optimized template that you can configure with your logo, a hero title, and a list of categories of your choosing. For an example of this template, see Echo Show Video Skill API Reference.
  • This landing page also includes a More Categories section that the user can access by voice or touch. More Categories display tiles of video categories that you provide. Examples of categories you can provide include Recently Added, Watch List, Trending Now, Because you watch title, seasonal content, etc. For an example of this template, see Echo Show Video Skill API Reference.
  • When the user selects a category, Alexa displays individual titles included in that category, in the same template Alexa uses for Search Results. For an example of this template, see Echo Show Video Skill API Reference.

Features That Require No Work

Video Home

This is an Echo Show landing page where the user can see a list of available video providers that can stream content to the device. Users bring up the Video Home page when they say utterances such as “Alexa, show me videos” or “Alexa, go to Video Home.” The Video Home page has a tile for each video provider, which responds to both voice and touch interactions. If the user selects a video provider’s skill that he or she has enabled, Alexa launches that provider’s landing page. If the user selects a disabled skill, Alexa kicks off the skill-enablement process.

PIN Protected Playback

Users can set a personal identification number (PIN) to restrict playback of content from any video provider. Users can use this PIN to set parental controls. If the user sets a PIN for any video provider, Alexa prompts the user to enter a PIN every time he or she wants to access content from that provider.