開発者コンソール

Alexa.RemoteVideoPlayerインターフェース: SearchAndDisplayResults


Alexa.RemoteVideoPlayerインターフェース: SearchAndDisplayResults

メディアを検索するための発話(「{X}を探して」など)をユーザーが行うと、Alexa.RemoteVideoPlayerインターフェースはSearchAndDisplayResultsディレクティブをLambdaに送信します。アプリではこのディレクティブに対して、メディアを直接再生するのではなくユーザーに検索結果ページを表示するように、ロジックを構築する必要があります。

SearchAndDisplayResultsディレクティブの発話

ユーザーが以下の発話を行うと、AlexaはLambdaにSearchAndDisplayResultsディレクティブを送信します。

機能 サンプル発話 想定されるレスポンス
<タイトル>を検索

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 करो

タイトルに一致する検索結果のリストがユーザーに表示されます。

メディアタイプで検索

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 करो

指定したメディアタイプに一致する検索結果のリストがユーザーに表示されます。

俳優で検索

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 करो

俳優が出演している検索結果のリストがユーザーに表示されます。

シーズン番号で<タイトル>を検索

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 ढूंढो

一致するシーズンのすべてのエピソードがユーザーに表示されます。

エピソード番号で<タイトル>を検索

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 ढूंढो

ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。

シーズン番号とエピソード番号で<タイトル>を検索

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 ढूंढो

ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。

シリーズの<タイトル>で検索

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}

シリーズに一致する検索結果のリストがユーザーに表示されます。

キャラクター名で検索

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 करो

キャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。

監督名で検索

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 करो

リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。

制作会社で検索

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 दिखाओ

制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。

ジャンル名で検索

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}

リクエストされたジャンルからメディアの検索結果のリストが(ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて)ユーザーに表示されます。

スポーツのチームで検索

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} की

スポーツのチームに一致する検索結果のリストがユーザーに表示されます。

スポーツの種類で検索

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}

スポーツの種類に一致する検索結果のリストが(ユーザーへのおすすめになるべく基づいて)ユーザーに表示されます。

スポーツのリーグで検索

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 दिखाओ

スポーツのリーグに一致する検索結果のリストが(ユーザーへのおすすめになるべく基づいて)ユーザーに表示されます。

スポーツのイベントで検索

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} ढूंढो

スポーツのイベントに一致する検索結果のリストが(ユーザーへのおすすめになるべく基づいて)ユーザーに表示されます。

<パートナー>アプリを起動

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 करो

リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスには、異なるカテゴリーに分類される可能性のあるメディアが表示されるホームページテンプレートがあります。

特殊文字のタイトルを起動

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}

リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスには、異なるカテゴリーに分類される可能性のあるメディアが表示されるホームページテンプレートがあります。

アプリを起動

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 करो

リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスには、異なるカテゴリーに分類される可能性のあるメディアが表示されるホームページテンプレートがあります。

SearchAndDisplayResultsディレクティブの処理

SearchAndDisplayResultsディレクティブには、メディアを検索し、アプリに適した方法で検索結果を表示するための命令が含まれています。SearchAndDisplayResultsディレクティブには、検索対象を指定するエンティティの配列が含まれます

SearchAndDisplayResultsディレクティブは、マルチモーダル実装用ビデオスキルのGetDisplayableItemsと似ています)。

SearchAndDisplayResultsの例

以下は、SearchAndDisplayResultsディレクティブの例です。これは、ユーザーが「アレクサ、UWハスキーズの試合を見せて」とリクエストした場合に、Alexaからレスポンスとして送信されるディレクティブです。

{
    "directive": {
        "endpoint": {
            "cookie": {},
            "endpointId": "<ターゲットエンドポイントの識別子>",
            "scope": {
                "token": "<OAuth2ベアラートークン>",
                "type": "BearerToken"
            }
        },
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "5b77aa06-3bc6-4ab1-8e10-a7f41c208a0a",
            "name": "SearchAndDisplayResults",
            "namespace": "Alexa.RemoteVideoPlayer",
            "payloadVersion": "3"
        },
        "payload": {
            "displayMode": "VUI",
            "entities": [
                {
                    "externalIds": {
                        "gracenote": 100
                    },
                    "type": "Event",
                    "uri": "entity://provider/event/games",
                    "value": "games"
                },
                {
                    "externaIds": {
                        "gracenote": "ST0000000666661"
                    },
                    "type": "SportsTeam",
                    "uri": "entity://provider/sportsteam/someURI",
                    "value": "UWハスキーズ"
                }
            ],
            "searchText": [
                {
                    "transcribed": "UWハスキーズの試合"
                }
            ],
            "timeWindow": {
                "end": "2016-09-07T23:59:00+00:00",
                "start": "2016-09-01T00:00:00+00:00"
            }
        }
    }
}

以下のセクションでは、さまざまなタイプのリクエストに対してSearchAndDisplayResultsディレクティブを処理するためのガイダンスを提供します。

タイトルで検索

SearchAndPlayディレクティブのタイトルで再生と同じロジックを使用しますが、再生する代わりにユーザーに検索結果を表示します。

タイトル、エピソード、シーズンで検索

SearchAndPlayディレクティブのタイトル、エピソード、シーズンで再生と同じロジックを使用しますが、再生する代わりにユーザーに検索結果を表示します。

シリーズで検索

SearchAndPlayディレクティブのシリーズで再生と同じロジックを使用しますが、再生する代わりにユーザーに検索結果を表示します。

ジャンル、スポーツ、チーム、リーグ、その他のあいまいな検索ディレクティブでの検索

SearchAndPlayディレクティブのジャンル、スポーツ、チーム、リーグ、その他あいまいな再生ディレクティブで再生と同じロジックを使用しますが、再生する代わりにユーザーに検索結果を表示します。

あいまいな再生リクエストの処理

SearchAndPlayディレクティブのあいまいな再生リクエストの処理と同じロジックを使用しますが、再生する代わりにユーザーに検索結果を表示します。

アートワーク

ユーザーに表示する検索結果のリストには、タイトルに適用可能な関連するアートワークを含めます。アートワークを使用すると、検索結果でおすすめのコンテンツをユーザーが識別しやすくなります。

searchTextの使用

手順と推奨事項については、searchTextオブジェクトを参照してください。

コンテンツが見つからない場合の処理

SearchAndPlayディレクティブのコンテンツが見つからない場合の処理と同じロジックを使用します。詳細については、エラー処理を参照してください。

ユーザーエクスペリエンスには、「ボイスクリフ」が含まれないようにしてください。 ボイスクリフとは、ユーザーがリモコンを使わざるを得なくなるような音声エクスペリエンスのことです。

上記の想定されるエクスペリエンスに加えて、検索の発話に関する一般的な要件を以下に示します。

ペイロードの説明

以下のフィールドがサポートされています。
フィールド 説明 データ型
entities
タイトル、シリーズ、俳優、チーム、メディアタイプなど、再生するエンティティオブジェクトの配列です。 配列
displayMode
ファーフィールドリクエスト(VUI)なのか、ニアフィールドリクエスト(GUI)なのかを識別します。 列挙値「VUI」または「GUI」
timeWindow
ユーザーが再生したいコンテンツのタイムウィンドウを指定します。たとえば、先週のエピソードを再生したい場合、タイムウィンドウには前の週を指定します。 startendの時間を含むオブジェクト
end

タイムウィンドウの終了時刻。

例: 2016-09-07T23:59:00+00:002018-01-24T02:30:00Z

ISO 8601形式の文字列
start

タイムウィンドウの開始時刻。

例: 2016-09-07T23:59:00+00:002018-01-24T02:30:00Z

ISO 8601形式の文字列

レスポンスの例

SearchAndDisplayResultsディレクティブが正常に完了した場合、LambdaはAlexa.Responseメッセージで応答する必要があります。

{
    "context": {
        "properties": []
    },
    "event": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "1d8749ce-2805-4781-bb34-c5c59ce71f6a",
            "name": "Response",
            "namespace": "Alexa",
            "payloadVersion": "3"
        },
        "payload": {}
    }
}

payloadの内容は不要です。

インターフェース機能に対するサポートの宣言

ビデオスキルがAlexa.RemoteVideoPlayerインターフェースをサポートしていることを示すには、Alexa.Discoveryインターフェースを介して送信されたDiscoverディレクティブへのレスポンスで、そのサポートを明示する必要があります。詳細については、Discoveryインターフェースを参照してください。

エラーレスポンス

何らかの理由でユーザーのリクエストを完了できない場合は、エラーレスポンスを返す必要があります。詳細については、エラー処理を参照してください。