Ti ringraziamo per la visita. Questa pagina è per il momento disponibile solo in inglese.

Alexa.RemoteVideoPlayer Interface: SearchAndDisplayResults (VSK FTV)

When users say utterances to find media, such as "Search for [X]," the Alexa.RemoteVideoPlayer interface sends SearchAndDisplayResults directives to your Lambda. For this directive, your app's logic should take users to search results pages rather than going directly to media playback.

Utterances for SearchAndDisplayResults Directives

Alexa sends a SearchAndDisplayResults directive to your Lambda when users say the following utterances.

Feature Sample Utterances Expected Response
Search for <title>

Search for Breaking Bad

Find The Big Bang Theory

Suche nach <title>

Nach <title> suchen

<Breaking Bad>

Cherche Breaking Bad

Trouve Breaking Bad

Trouve-moi Breaking Bad

Cherche/trouve breaking bad

cerca breaking bad

<House, The Office, Sneaky Pete>

busca breaking bad

busca breaking bad

búscame breaking bad

búsca me breaking bad

{title} 探して

{title} を検索して

A list of matches for the title is presented to the user.

Search by Media Type

Search movies

Suche nach <type>

<filme, videos, film>

Cherche des films

Trouve des films

Trouve-moi des films

Cherche/trouve des films

cerca dei film

busca películas

busca películas

busca pelís

búscame películas

búscame pelís

búsca me películas

búsca me pelís

{media type} 探して

{media type} を検索して

A list of matches for the desired media type is presented to the user.

Search by Actor

Search for sean connery

Search for movies with Tom Hanks.

Suche nach <actor>

<Ann Blyth, Axel Deller, John Oliver>

Cherche Sean Connery

Cherche/trouve sean connery

cerca sean connery

<Gianni Franco, Sonia Scotti, Stefano Sani>

busca sean connery

busca sean connery

busca a sean connery

búscale a sean connery

búsca le a sean connery

{actor} 探して

{actor} を検索して

{actor}の{media type} を探して

{actor}の{media type} を検索して

{actor}が出てる{media type} 探して

{actor}が出てる{media type} を検索して

*{media type}:映画/ドラマ/やつ/もの/の

A list of matches featuring the actor is presented to the user.

Search <title> with season number

Search breaking bad season two

Suche nach <title> Staffel <number>

Suche nach der <number>. Staffel von <title> <Breaking Bad>

Cherche la saison 2 de Breaking Bad

Cherche la deuxième saison de Breaking Bad

Trouve la saison 2 de Breaking Bad

Trouve la deuxième saison de Breaking Bad

Trouve-moi la saison 2 de Breaking Bad

Trouve-moi la deuxième saison de Breaking Bad

Cherche/trouve la deuxième saison/saison 2 de breaking bad

cerca la seconda stagione di breaking bad

cerca la stagione due di breaking bad

<House, The Office, Sneaky Pete>

busca la temporada 2 de breaking bad

busca la segunda temporada de breaking bad

busca la temporada 2 de breaking bad

busca la segunda temporada de breaking bad

búscame la temporada 2 de breaking bad

búscame la segunda temporada de breaking bad

búsca me la temporada 2 de breaking bad

búsca me la segunda temporada de breaking bad

{title} シーズン{season number} 探して

{title} シーズン{season number} を探して

{title} シーズン{season number} を検索して

All episodes for the matching season are presented to the user.

Search <title> with episode number

Search for breaking bad episode five

Suche nach <title> Folge <number>

Suche nach <title> Episode <number>

Suche nach der <number>. Folge von <title>

Suche nach der <Number>. Episode von <title>

<Breaking Bad>

Cherche l'épisode 5 de Breaking Bad

Cherche le cinquième épisode de Breaking Bad

Cherche/trouve le/la cinquième épisode/épisode 5 de breaking bad

cerca il quinto episodio di breaking bad

cerca l'episodio cinque di breaking bad

<House, The Office, Sneaky Pete>

busca el episodio 5 de breaking bad

busca el capítulo 5 de breaking bad

busca el episodio 5 de breaking bad

busca el capítulo 5 de breaking bad

búscame el episodio 5 de breaking bad

búscame el capítulo 5 de breaking bad

búsca me el episodio 5 de breaking bad

búsca me el capítulo 5 de breaking bad

{title} エピソード{episode number} 探して

{title} エピソード{episode number} を探して

{title} エピソード{episode number} を検索して

A list of available episodes within the season the user recently watched appears. For example, if the user's viewing progress is within 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

Find 'The Big Bang Theory' Season 1 episode 4.

Suche nach <title> Staffel <season number> Folge <episode number>

Suche nach <title> Staffel <season number> Episode <episode number>

Suche nach der <episode number>. Folge von <title> in Staffel <season number>

Suche nach der <episode number>. Episode von <title> in Staffel <season number>

<Breaking Bad>

Cherche l'épisode 5 de la saison 2 de Breaking Bad

Cheche l'épisode 5 de la deuxième saison de Breaking Bad

Cherche le cinquième épisode de la saison 2 de Breaking Bad

Cherche l'épisode 5 de la deuxième saison de Breaking Bad

Cherche/trouve le/la cinquième épisode/épisode 5 de la deuxième saison/saison 2 de breaking bad

cerca il quinto episodio della stagione due di breaking bad

cerca l'episodio cinque della stagione due di breaking bad

<House, The Office, Sneaky Pete>

busca el episodio 5 de la temporada 2 de breaking bad

busca el episodio 5 de la segunda temporada de breaking bad

busca el episodio 5 de la temporada 2 de breaking bad

busca el episodio 5 de la segunda temporada de breaking bad

búscame el episodio 5 de la temporada 2 de breaking bad

búscame el episodio 5 de la segunda temporada de breaking bad

búsca me el episodio 5 de la temporada 2 de breaking bad

búsca me el episodio 5 de la segunda temporada de breaking bad

{title} シーズン{season number} エピソード{episode number} 探して

{title} シーズン{season number} エピソード{episode number} を探して

{title} シーズン{season number} エピソード{episode number} を検索して

A list of available episodes for the season the user requested appears, including the episode the user specifically asked for.

Search by franchise <title>

Search for star trek

Suche nach <title>

Zeige mir <title>

<Star Wars, James Bond, Batman, Star Trek>

Cherche Star Trek

Trouve Star Trek

Cherche/trouve star treck

cerca star trek

<Superman, cars, Scream>

busca star trek

busca star trek

búscame star trek

búsca me star trek

{franchise} 探して

{franchise} を探して

{franchise} を検索して

The user is presented with a list of matching results for the franchise.

Search by Character Name

Search for james bond

Suche nach <actor>

Suche nach einem Film mit <actor>

<James Bond>

Cherche James Bond

Trouve James Bond

Cherche/trouve james bond

cerca james bond

<Superman>

busca james bond

busca james bond

busca a james bond

busca james bond

búscame james bond

búsca me james bond

{character} 探して

{character} を探して

{character} を検索して

{character}の{media type} 探して

{character}の{media type} を探して

{character}の{media type} を検索して

{character}が出てる{media type} 探して

{character}が出てる{media type} を探して

{character}が出てる{media type} を検索して

*{media type}:映画/ドラマ/やつ/もの/の

The user is presented with a list of matching results for media featuring the character name.

Search by director name

Search for quentin tarantino

Suche nach einem Film von <director>

Suche nach <director>

Cherche Quentin Tarantino

Trouve Quentin Tarantino

Cherche/trouve xavier dolan

cerca quentin tarantino

busca quentin tarantino

busca quentin tarantino

busca a quentin tarantino

búscame quentin tarantino

búscame a quentin tarantino

búsca me quentin tarantino

búsca me a quentin tarantino

{director name}監督の{media type}探して

{director name}監督の{media type}を探して

{director name}監督の{media type}を検索して

{director name}が監督してる{media type}探して

{director name}が監督してる{media type}を探して

{director name}が監督してる{media type}を検索して

The user is presented with a list of matching results for media produced by the requested director.

Search by production company

Search for disney

Suche nach Filmen von <name>

Suche nach einem Film von <name>

Cherche Disney

Trouve Disney

Cherche/trouve disney

cerca disney

busca disney

busca disney

búscame disney

búsca me disney

{company} 探して

{company} を探して

{company} を検索して

The user is presented with a list of matching results for media from the production company.

Search by genre name

Search for comedy

Search comedy movies with Tom Hanks.

Suche nach <genre>

Suche eine <genre>

<Familie, Architektur, Landestypisch>

Cherche une comédie

Trouve une comédie

Cherche des comédies

Trouve des comédies

Cherche/trouve des comédies

cerca una commedia

<Commedia>

busca comedia

busca comedia

busca comedias

búscame comedias

búsca me comedias

{genre} 探して

{genre} を探して

{genre} を検索して

The user is presented with a list of matching results for media from the requested genre (personalized through an algorithm that selects recommended media for the user).

Search by sports team

Search seahawks

Suche nach <sports team>

<Erster. FC Heidenheim, Erster FC Heidenheim, Erster FC Kaiserslautern>

Cherche les Bleus

Cherche/trouve le/les Canadiens

cerca juventus

<Aberdeen, ac milan>

busca el Madrid

busca el América

búscame el América

búsca me el América

{sports team} 探して

{sports team} を探して

{sports team} を検索して

The user is presented with a list of matching results for the sports team.

Search by sports type

Search for soccer

Suche nach <sports type>

Cherche du foot/football

Trouve du foot/football

Cherche/trouve du hockey

cerca calcio

busca fútbol

busca fútbol

búscame fútbol

búscame el útbol

busca el fútbol

búsca me fútbol

búsca me el fútbol

{sports type} 探して

{sports type} を探して

{sports type} を検索して

The user is presented with a list of matching results for the sports type (preferably based on recommendations for the user).

Search by sports league

Search for n. b. a. league

Suche nach <sports league>

<Erste Baseball Bundesliga, Zweite Baseball Bundesliga, Zweite Bundesliga>

Cherche la n.b.a.

Trouve la n.b.a.

Cherche/trouve la LNH/NHL/ligue nationale

cerca l'n.b.a.

cerca la n.b.a.

<America's Cup>

busca la n. b. a.

busca la n. b. a.

búscame la n. b. a.

búsca me la n. b. a.

{sports league} 探して

{sports league} を探して

{sports league} を検索して

The user is presented with a list of matching results for the sports league (preferably based on recommendations for the user).

Search by sports event

Search for soccer game

Suche nach <sports event>

Suche <sports event>

Cherche un match de foot/football

Trouve un match de foot/football

Cherche/trouve des matchs/parties/games de hockey

cerca una partita di calcio

cerca partite

<gli europei>

busca partidos de fútbol

busca partidos de fútbol

búscame partidos de fútbol

búsca me partidos de fútbol

{sports event} 探して

{sports event} を探して

{sports event} を検索して

The user is presented with a list of matching results for the sports event (preferably based on recommendations for the user).

Launch <partner> app

Launch Netflix app

Open Amazon video

Starte <partner app>

<partner app> starten

Öffne <partner app>

<partner app> öffnen

<partner app> aufrufen

Ruf <partner app> auf

<youview, netflix, zattoo, hulu>

Lance Netflix

Ouvre Netflix

lance/ouvre/pars Netflix

lance/ouvre/pars l'appli/l'app/l'application (de) Netflix

apri (l'app di) Netflix

avvia Netflix

<Netflix>

abre (la app de) Netflix

abre (la app de) Netflix

{app} 開いて

{app} 見せて

{app} 起動

{app} 起動して

{app} に行って

{app} に戻って

The requested app launches and shows a list of available media to play. Multimodal devices have a homepage template that gets populated with media potentially grouped in different categories.

Launch special character title

Launch a. t. and t. u-verse app

Starte a, t, und t. u-verse

A. t. und t. u.verse starten

Lance a.t. et t. u-verse

Ouvre a.t. et t. u-verse

no translation yet

abre (la app de) Movistar + (plus)

no translation yet

no translation yet

no translation yet

The requested app launches and shows a list of available media to play. Multimodal devices have a homepage template that gets populated with media potentially grouped in different categories.

Launch app

Launch app

App starten

Starte App

App öffnen

Öffne die App

Lance l'application

Ouvre l'application

Lance l'appli

Ouvre l'appli

lance/ouvre/pars l'appli/l'app/l'application

apri (l')app

avvia (l')app

abre (la) app

abre (la) app

アプリを開いて

アプリを起動して

The requested app launches and shows a list of available media to play. Multimodal devices have a homepage template that gets populated with media potentially grouped in different categories.

Handling SearchAndDisplayResults Directives

SearchAndDisplayResults directives contain instructions to search for media and then display the results of a search in a way that is appropriate for your application. The SearchAndDisplayResults directive contains an array of entities that specifies what to search for.

(The SearchAndDisplayResults directive is similar to GetDisplayableItems in the video skills for multimodal implementations.)

The following sections provide guidance for handling SearchAndDisplayResults directives for different types of requests.

Search by Title

Use the same logic as Play by Title in SearchAndPlay directives but show the user search results instead of going into playback.

Search by Title, Episode, and Season

Use the same logic as Play by Title, Episode, and Season in SearchAndPlay directives but show the user search results instead of going into playback.

Search by Franchise

Use the same logic as Play by Franchise in SearchAndPlay directives but show the user search results instead of going into playback.

Search by Genre, Sport, Team, League, and Other Ambiguous Search Directives

Use the same logic as Play by Genre, Sport, Team, League, and Other Ambiguous Play Directives in SearchAndPlay directives but show the user search results instead of going into playback.

Handling Ambiguous Play Requests

Use the same logic as Handling Ambiguous Play Requests in SearchAndPlay directives but show the user search results instead of going into playback.

Artwork

In your list of results that you present to the user, include relevant artwork applicable to the titles. The artwork should make it easier for the user to identify the content you are recommending in the search.

Handling Content Not Found

Use the same logic as Handling Content Not Found in SearchAndPlay directives. See Error Handling for more details.

Avoid user experiences that involve "voice cliffs." A voice cliff is a voice experience that leads to the user having to pick up the remote control.

In addition to the expected experiences listed above, the following are general requirements for search utterances:

SearchAndDisplayResults Example

The following is an example SearchAndDisplayResults directive. This is a directive Alexa might send in response to a user's request to search for "Manchester by the Sea."

{
    "directive": {
        "endpoint": {
            "scope": {
                "type": "BearerToken",
                "token": "access-token-from-skill"
            },
            "endpointId": "appliance-001",
            "cookie": {}
        },
        "header": {
            "messageId": "abc-123-def-456",
             "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "name": "SearchAndDisplayResults",
            "namespace": "Alexa.RemoteVideoPlayer",
            "payloadVersion": "3"
        },
        "payload": {
            "entities": [
                   {
                    "externaIds": {
                        "gracenote": "ST0000000666661"
                    },
                    "name": "Manchester by the Sea",
                    "type": "Video"
                }
            ],
            "timeWindow": {
                "end": "2016-09-07T23:59:00+00:00",
                "start": "2016-09-01T00:00:00+00:00"
            }
        }
    }
}

Payload Descriptions

Payload Descriptions
Field Description Data Type
entities
An array of entity objects to play, such as a Title, Franchise, Actor, Team or Media Type. See [entity types here](../video-skills-fire-tv-apps/entity-types-for-video-content.html). array
timeWindow
Provides the time window for the content the customer wants to play. For example if a customer wants to play an episode from last week, time window would indicate the preceding week. Object containing start and end times.
end

The end time of the time window.

Examples: 2016-09-07T23:59:00+00:00, 2018-01-24T02:30:00Z

A string in ISO 8601 format.
start

The start time of the time window.

Examples: 2016-09-07T23:59:00+00:00, 2018-01-24T02:30:00Z

A string in ISO 8601 format.

Response Example

When a SearchAndDisplayResults directive successfully completes, your Lambda should respond with an Alexa.Response message.

{
    "context": {
        "properties": []
    },
    "event": {
        "endpoint": {
            "scope": {
                "type": "DirectedUserId",
                "directedUserId": "access-token-from-Amazon"
            },
            "endpointId": "videoDevice-001"
        },
        "header": {
            "messageId": "abc-123-def-456",
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "name": "Response",
            "namespace": "Alexa",
            "payloadVersion": "3"
        },
        "payload": {}
    }
}

No payload content is required.

Declaring Capability Support for this Interface

To indicate that your video skill supports the Alexa.RemoteVideoPlayer interface, you must indicate support for it in your response to the Discover directive sent through the Alexa.Discovery interface. More details are provided in Alexa.Discovery.

Error Response

If you cannot complete the customer request for some reason, reply with an error. See Error Handling for more details.