GetPlayableItems, GetPlayableItemsMetadata, GetDisplayableItems, GetDisplayableItemsMetadata, GetBrowseNodeItems, and GetNextPage. A comprehensive reference for this content is available in Requests and Responses Reference.
Your Lambda will need to interact with a backend service to retrieve the information. For example, when Alexa sends directives for your Lambda to process, the directives might involve retrieving information about specific media. You would need to write code that performs lookups for the media in your backend service and returns that information back to Alexa in the right JSON format.
Discovery
Through the discovery process, your skill is able to declare its capabilities to Alexa. These capabilities may be static for all users of your skill or change based on the user’s subscription level with your service. Either way, your response to this directive establishes what a user can do with your skill.Search
TheGetDisplayableItems directive expects a collection of items to be returned in your Lambda’s response. The response should contain identifiers for your content. A separate directive, GetDisplayableItemsMetadata, detailed in the following section, is made to retrieve metadata to play the content. The GetDisplayableItems and GetDisplayableItemsMetadata directives are separated into two requests to optimize latency.
GetDisplayableItems
When a user makes a search request such as “Alexa, show me <Title of Video Content>,” Alexa sends a GetDisplayableItems directive to your Lambda, like this:
GetDisplayableItemsResponse response back to Alexa containing the requested media, like this:
GetDisplayableItemsResponse response, which contains the right content for the request, Alexa sends another directive called GetDisplayableItemsMetadata. The purpose of GetDisplayableItemsMetadata is to get information about the resolved content (such as images, titles, and other metadata) in order to populate the device’s screen. The following example is a GetDisplayableItemsMetadata directive:
GetDisplayableItemsMetadata directive, you should provide a GetDisplayableItemsMetadataResponse response that provides metadata about the requested items. This metadata will often populate search results templates on the device.
Landing Page
When a user opens your landing page (by saying “Alexa, open ACME video” or by saying “Video Home” and then selecting your video skill), Alexa sends twoGetDisplayableItems directives:
-
The first
GetDisplayableItemsdirective is to retrieve categories for the landing page by setting theitemTypeproperty toCATEGORYand including asortTypeofRECOMMENDED. -
The second
GetDisplayableItemsdirective obtains the featured video for the landing page where the request sets theitemTypetoVIDEOinstead.
GetDisplayableItemsResponse) for both directives, Alexa sends one GetDisplayableItemsMetadata call with a list combined of Category IDs and Video ID. The response includes metadata about the video as well as the categories. For the required fields for each itemType, see GetDisplayableItems and GetDisplayableItemsMetadata.
The following example is metadata for an itemType whose value is CATEGORY.
Quick Play
Quick play scenarios (where users make requests such as “Alexa, play the movie [X]”) use theGetPlayableItems and GetPlayableItemsMetadata directives, which are closely similar to GetDisplayableItems and GetDisplayableItemsMetadata. The only difference is that the metadata returned for playback varies slightly from that which is used for search. For more information, see GetPlayableItems and GetPlayableItemsMetadata).
Channel Navigation
Channel navigation utterances prompt Alexa to also sendGetPlayableItems and GetPlayableItemsMetadata directives. The only difference is that the metadata returned for channel navigation varies slightly from that which is used for search/play. For more information, see GetPlayableItems.

