Vielen Dank für deinen Besuch. Diese Seite ist nur in Englisch verfügbar.

Alexa.RemoteVideoPlayer Interface: SearchAndDisplayResults (VSK Fire TV)

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

cherches breaking bad

trouves breaking bad

cherches breaking bad

trouves breaking bad

cerca breaking bad

<House, The Office, Sneaky Pete>

busca breaking bad

busca breaking bad

búscame breaking bad

{title} を探して

{title} を検索して

procurar por {title}

buscar por {title}

{title} search करो

{title} ke liye search करो

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

Search by Media Type

Search movies

Suche nach <type>

<filme, videos, film>

cherches des films

trouves des films

cherches des films

trouves des films

cerca dei film

busca películas

busca películas

busca pelís

{media type} を探して

{media type} を検索して

procurar por filmes

buscar por filmes

{media type} search करो

{media type} ke liye search करो

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

Search by Actor

Search for sean connery

Search for sean connery movies

Suche nach <actor>

<Ann Blyth, Axel Deller, John Oliver>

cherches sean connery

trouves sean connery

cherches sean connery

trouves sean connery

cerca sean connery

<Gianni Franco, Sonia Scotti, Stefano Sani>

busca sean connery

busca sean connery

busca a sean connery

{actor} を探して

{actor} を検索して

procurar por {actor}

buscar por {actor}

{actor name} search करो

{actor name} ke liye search करो

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>

cherches la saison 2 de breaking bad

cherches la deuxième saison de breaking bad

cherches la saison 2 de breaking bad

cherches la deuxième saison de breaking bad

cerca la seconda stagione di breaking bad

cerca la stagione due di breaking bad

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

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

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

procurar a {ordinal number} temporada de {title}

procure a {ordinal number} temporada de {title}

{title} season two search करो

{title} season two ढूंढो

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>

cherches l' épisode 5 de breaking bad

cherches le cinquième épisode de breaking bad

cherches l' épisode 5 de breaking bad

cherches le cinquième épisode de breaking bad

cerca il quinto episodio di breaking bad

cerca l'episodio cinque di breaking bad

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

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

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

procurar o {ordinal number} episódio de {title}

procure o {ordinal number} episódio de {title}

{title} episode five search करो

{title} fifth episode ढूंढो

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

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

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

cherches l' épisode 5 de la saison 2 de breaking bad

cherches l' épisode 5 de la deuxième saison de breaking bad

cherches l' épisode 5 de la saison 2 de breaking bad

cherches l' épisode 5 de la deuxième saison de breaking bad

cerca il quinto episodio della stagione due di breaking bad

cerca l'episodio cinque della stagione due di breaking bad

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

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

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

procurar o {ordinal number} episódio da {ordinal number} temporada de {title}

procure o {ordinal number} episódio da {ordinal number} temporada de {title}

{title} season two episode five search करो

{title} season two fifth episode ढूंढो

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>

cherches star trek

trouves star trek

cherches star trek

trouves star trek

cerca star trek

<Superman, cars, Scream>

busca star trek

busca star trek

búscame star trek

{franchise} を探して

{franchise} を探して

procurar por {title}

buscar por {title}

{franchise title} search करो

{franchise title} ढूंढो search {franchise title}

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>

cherches james bond

trouves james bond

cherches james bond

trouves james bond

ccerca james bond

<Superman>

busca james bond

busca james bond

busca a james bond

{character} を探して

{character} を探して

procurar por {character name}

buscar por {character name}

{character name} की picture दिखाओ

{character name} की movie search करो

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>

cherches quentin tarantino

trouves quentin tarantino

cherches xavier dolan

trouves xavier dolan

cerca quentin tarantino

busca quentin tarantino

busca quentin tarantino

busca a quentin tarantino

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

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

procurar por {director name}

buscar por {director name}

{director name} search करो

{director name} ke liye search करो

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>

cherches disney

trouves disney

cherches disney

cerca disney

busca disney

busca disney

búscame disney

{company} を探して

{company} を探して

procurar por {production company}

buscar por {production company}

{production company} की filmein search करो

{production company} की filmein दिखाओ

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>

cherches une comédie

trouves une comédie

cherches une comédie

trouves une comédie

cerca una commedia

<Commedia>

busca comedia

busca comedia

busca comedias

{genre} を探して

{genre} を探して

procurar por {genre name}

buscar por {genre name}

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>

cherches les bleus

trouves les bleus

cherches les canadiens

trouves les canadiens

cerca juventus

<Aberdeen, ac milan>

busca el Madrid

busca el América

búscame el América

{sports team} を探して

{sports team} を探して

procurar por {sports team}

buscar por {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>

cherches du foot/football

trouves du foot/football

cherches du hockey

cerca calcio

busca fútbol

busca fútbol

búscame fútbol

{sports type} を探して

{sports type} を探して

procurar por {sports type}

buscar por {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>

cherches la n.b.a.

trouves la n.b.a.

cherches la l. n. h.

trouves la l. n. h.

cerca l'n.b.a.

cerca la n.b.a.

busca la n. b. a.

busca la n. b. a.

búscame la n. b. a.

{sports league} を探して

{sports league} を探して

procurar por {sports league}

buscar por {sports league}

{sports league} ढूंढो

{sports league} matches दिखाओ

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>

cherches un match de foot/football

trouves un match de foot/football

cherches un match de hockey

trouves un match de hockey

cerca una partita di calcio

cerca partite

busca partidos de fútbol

busca partidos de fútbol

búscame partidos de fútbol

{sports event} を探して

{sports event} を探して

procurar por {sports event}

buscar por {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

Starte <partner app>

<partner app> starten

lances netflix

ouvres netflix

lances netflix

ouvres netflix

apri (l'app di) Netflix

avvia Netflix

abre Netflix

abre Netflix

{app} 開いて

{app} 見せて

Alexa, abrir o app/aplicativo do/da/de {partner}

Alexa, ir para o app/aplicativo do/da/de {partner}

launch {app}

{app} launch करो

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

lances a. t. et t. u- verse

ouvres a. t. et t. u- verse

abre (la app de) Movistar + (plus)

abrir {special character title}

ir para {special character title}

Launch {special character title} app

Launch {special character title}

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

lances l' application

ouvres l' application

lances l'appli

ouvres l'appli

apri (l')app

avvia (l')app

abre (la) app

abre (la) app

アプリを開いて

アプリを起動して

abrir {app}

ir para {app}

launch app

app launch करो

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.