SearchAndDisplayResultsディレクティブ


SearchAndDisplayResultsディレクティブ

SearchAndDisplayResultsディレクティブは、ユーザーが「Xを検索して」などのメディアを検索する音声コマンドを発した場合にAlexaから送信されます。アプリではこのディレクティブに対し、メディアを直接再生するのではなく、ユーザーに検索結果ページを表示するようロジックを構築する必要があります。

SearchAndDisplayResultsディレクティブの発話

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

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

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} を検索して

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

メディアタイプで検索

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} を検索して

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

俳優で検索

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}:映画/ドラマ/やつ/もの/の

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

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

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} を検索して

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

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

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} を検索して

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

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

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} を検索して

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

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

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} を検索して

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

キャラクター名で検索

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}:映画/ドラマ/やつ/もの/の

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

監督名で検索

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}を検索して

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

制作会社で検索

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} を検索して

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

ジャンル名で検索

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} を検索して

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

スポーツのチームで検索

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} を検索して

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

スポーツの種類で検索

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} を検索して

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

スポーツのリーグで検索

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} を検索して

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

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

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} を検索して

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

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

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} に戻って

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

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

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

翻訳はまだありません

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

アプリを起動

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

アプリを開いて

アプリを起動して

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

SearchAndDisplayResultsディレクティブの処理

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

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

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

タイトルで検索

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

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

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

シリーズで検索

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

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

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

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

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

アートワーク

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

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

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

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

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

SearchAndDisplayResultsの例

以下は、SearchAndDisplayResultsディレクティブの例です。これは、ユーザーが『マンチェスター・バイ・ザ・シー』の検索をリクエストした場合に、Alexaからレスポンスとして送信されるディレクティブです。

{
    "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"
            }
        }
    }
}
ペイロードの説明
フィールド 説明 データ型
entities
タイトル、シリーズ、俳優、チーム、メディアタイプなど、再生するエンティティオブジェクトの配列です。詳細については、[ビデオコンテンツのエンティティタイプ](../video-skills-fire-tv-apps/entity-types-for-video-content.html)を参照してください。 配列
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": {
        "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": {}
    }
}

payloadコンテンツは不要です。

エラーレスポンス

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