開発者コンソール

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


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

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

SearchAndDisplayResultsディレクティブの発話

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

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

Search for breaking bad

such nach? <VideoName> such/zeig/find film? <VideoName> auf <AppName>

zeig mir film? <VideoName> auf <DeviceBrand>

such trailer von <VideoName>

trouve / cherche / montre <VideoName> sur <AppName>

trouve / cherche / montre <VideoName> sur <AppName>

trova / cerca / mostra / dammi + VideoName (+ da/su ServiceName)?

muestra juego de tronos

enséña me el efecto mariposa

<VideoName>を探して<VideoName>を<AppName>で探して

procurar/buscar/mostrar <VideoName> no/na <AppName>

 

<VideoName> खोजो/ढूँढो <AppName> पे/पर/में <VideoName> दिखा/खोज दो मुझे <VideoName> दिखाओ/खोजो/ढूँढो मुझे <AppName> पे/पर/में <VideoName> दिखाओ/खोजो/ढूँढो मुझे <VideoName> को <AppName> पे

पर में दिखाओ/खोजो/ढूँढो खोजो <VideoName>

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

1.0

メディアタイプで検索

Search movies

find <MediaType>

such/zeig/empfiehl <MediaType>

Cherche <mediatype>

recherche <mediatype>

cherche <mediatype>

cerca <mediatype>

trova mi un <mediatye>

busca películas

enséña me las películas

busca películas en netflix

<MediaType>を探して

<AppName>で<MediaType>を探して

<ChannelName>を検索

procurar <MediaType>

<VideoName> movie दिखाओ/ढूँढो

<AppName> पे/पर/में <MediaType> को खोजो

<ChannelName> को खोजो/ढूँढो

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

1.0

俳優で検索

Search for sean connery

Search for sean connery movies

such <ActorNameName> filme

zeig filme mit <ActorNameName>

cherche des films avec <ActorName>

recherche des films avec <ActorName>

cherche des films avec <ActorName>

cerca film con <ActorName>

trova un film con <ActorName>

busca películas con antonio banderas

<ActorNameName>が出ている<MediaType>を探して

procurar por <ActorName>

<ActorName> के/का/की/वाला movies दिखाओ/ढूँढो

<ActorName> के/का/की/वाला <GenreName> movies दिखाओ/खोजो/ढूँढो

<ActorName> के/का/की/वाला <GenreName> movie <VideoName> दिखाओ/खोजो/ढूँढो

दिखाओ/खोजो <ActorName> के/का/की/वाला <GenreName> movies

該当する俳優が出演しているメディアのリストがユーザーに表示されます。

1.0

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

Search breaking bad season two

spiel <VideoName> <Season> <Season_Numer>

spiel <VideoName>

<Season> <Season_Numer> auf <AppName>

cherche la saison <number> de <title>

recherche la saison <number> de <title>

cherche la saison <number> de <title>

cerca la stagione due di <VideoName>

trova la stagione due di <VideoName>

enséña me la segunda temporada de friends

procurar <VideoName> temporada <SeasonNumber>

breaking bad season दो ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना

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

1.0

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

Search for breaking bad episode five

spiel die <Episode_Number> <Episode> von <VideoName>

spiel <VideoName> <Episode_Number>

spiel von <VideoName> <Episode> <Episode_Number>

cherche l'épisode <number> de <title>

recherche la saison <number> de <title>

cherche la saison <number> de <title>

cerca <VideoName> Episodio cinque

trova <VideoName> Episodio cinque

busca el capítulo final de los serrano*

procurar por <title> episódio <EpisodeNumber>

breaking bad episode पाँच के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना

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

1.0

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

Search for breaking bad season two episode five

spiel <Season> <Season_Numer> <Episode> <Episode_Number> von <VideoName>

spiel <VideoName> <Season> <Season_Numer> <Episode> <Episode_Number>

spiel die <VideoName> <Season> <Season_Numer> <Episode>

<Episode_Number> auf <AppName> ab

cherche la saison <SeasonNumber> de <VideoName>

cherche l'épisode <EpisodeNumber> de <VideoName>

cherche l'épisode <EpisodeNumber> de la saison <SeasonNumber> de <VideoName>

cherche la saison <SeasonNumber> de <VideoName>

cherche l'épisode <EpisodeNumber> de <VideoName>

cherche l'épisode <EpisodeNumber> de la saison <SeasonNumber> de <VideoName>

recherche/cherche la saison <SeasonNumber> de <VideoName>

recherche/cherchel'épisode <EpisodeNumber> de <VideoName>

recherche/cherchel'épisode <EpisodeNumber> de la saison <SeasonNumber> de <VideoName>

recherche/cherchela saison <SeasonNumber> de <VideoName>

recherche/cherchel'épisode <EpisodeNumber> de <VideoName>

recherche/cherchel'épisode <EpisodeNumber> de la saison <SeasonNumber> de <VideoName>

cerca <VideoName> episodio <EpisodeNumber>

trova <VideoName> episodio <EpisodeNumber>

cerca <VideoName> stagione <SeasonNumber>

trova <VideoName> stagione <SeasonNumber>

cerca <VideoName> stagione <SeasonNumber> episodio <EpisodeNumber>

trova <VideoName> stagione <SeasonNumber> episodio <EpisodeNumber>

busca el segundo episodio de la primera temporada de anabel*

<title> シーズン<SeasonNumber> エピソード<EpisodeNumber> を探して

procurar por <VideoName>episódio <EpisodeNumber>procurar por

<VideoName>temporada <SeasonNumber>procurar por <VideoNumber>temporada

breaking bad season दो episode five के लिये ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना

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

1.0

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

Search for star trek

such nach? <VideoName> such/zeig/find film? <VideoName> auf <AppName>

zeig mir film? <VideoName> auf <DeviceBrand>

such trailer von <VideoName>

cherche star trek

recherche <VideoName>

cherche <VideoName>

cerca <VideoName>

trova <VideoName>

busca shrek

procurar<VideoName>

start trek के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना

検索結果として、該当するシリーズのリストがユーザーに表示されます。

1.0

キャラクター名で検索

Search for james bond

Not supported

cherche un film avec <charactername>

recherche un film avec <charactername>

cherche un film avec <charactername>

cerca un film con <CharacterName>

trova un film con <CharacterName>

busca películas de la pantera negra

<CharacterNameName>が主人公の<MediaType>を探して

not supported

<CharacterName> movie दिखाओ/खोजो <CharacterName> के/का/की/वाला movie <VideoName> दिखाओ/खोजो/ढूँढो

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

1.0

監督名で検索

Search for quentin tarantino

such nach <MediaType> mit <ActorName>

such <ActorName> <MediaType>

zeig <MediaType> mit <ActorName>

cherche un film de quentin tarantino

recherche un film de <DirectorName>

cherche un film de <DirectorName>

cerca <DirectorName>

busca las películas de alejandro lozano

not supported

quentin tarantino के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना

検索結果として、該当する監督が制作したメディアのリストがユーザーに表示されます。

1.0

制作会社で検索

Search for disney

suche nach <ProductionCompany> filmenzeige mir <ProductionCompany> filme

cherche des films de disney

recherche des films de disney

cherche des films de disney

cerca disney

busca películas de disney

<ProductionCompany>を検索

Procurar/procura/procure por <ProductionCompany>

disney के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना

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

1.0

ジャンル名で検索

Search for comedy

zeig <GenreNameName> filme auf <AppName>

such nach <GenreName> <MediaType>

cherche une comédie

recherche un/une <GenreName>

cherche un/une <GenreName>

cerca <GenreName>

trova <GenreName>

busca comedias románticas

<GenreNameName>の<MediaType>を見つけて

procurar por <GenreName>

<GenreName> movies दिखाओ/ढूँढो

<ActorName> के/का/की/वाला <GenreName> movies दिखाओ/खोजो/ढूँढो

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

1.0

スポーツのチームで検索

Search seahawks

Not supported

Not supported

not supported

busca el partido del real madrid

<Sport>の<Event>を見つけて<SportTeam>の<Event>を見つけて

procurar por<SportTeam>

<Sport/League/Seam> games दिखाओ/खोजो/ढूँढो

<Sport> के <Event> को दिखाओ/खोजो <Sport> के <Event> को दिखाओ/खोजो

検索結果として、該当するスポーツチームのリストがユーザーに表示されます。

1.0

スポーツの種類で検索

Search for soccer

such <Sport> <Event>

find <Sport> <Event>

Not supported

Not supported

cerca <Sport>

trova <Sport>

enséña nos un vídeo de fútbol

<Sport>の<Event>を見つけて<SportTeam>の<Event>を見つけて

procurar por <Sport>

<Sport/League/Seam> games दिखाओ/खोजो/ढूँढो

<Sport> के <Event> को दिखाओ/खोजो

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

1.0

スポーツのリーグで検索

Search for n. b. a. league

Not supported

cherche <league>

recherche <league>

cherche <league>

not supported

busca el partido de la

n. b. a.

<Sport>の<Event>を見つけて<SportTeam>の<Event>を見つけて

procurar por <League>

<Sport/League/Seam> games दिखाओ/खोजो/ढूँढो

<Sport> के <Event> को दिखाओ/खोजो

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

1.0

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

Search for soccer game

such <Sport> <Event>

find <Sport> <Event>

Not supported

Not supported

cerca partite di <SportName>

trova partite di calcio

busca el partido de fútbol

<Sport>の<Event>を見つけて<SportTeam>の<Event>を見つけて

procurar por <SportName>

<Sport/League/Seam> games दिखाओ/खोजो/ढूँढो

<Sport> के <Event> को दिखाओ/खोजो

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

1.0

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

Launch netflix app

starte <AppName>

spiel/öffne <AppName> app

starte <AppName> auf <DeviceBrand>

lance <AppName>

pars <AppName>

lancia <AppName>

apri <AppName>

lanza la app de netflix

lanza netflix

abrir <AppName>

netflix launch करो/करना/कीजिए/करिएगा

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

1.0

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

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

starte <AppName>

spiel/öffne <AppName> app

starte AppName auf <DeviceBrand>

lance <AppName>

pars <AppName>

apri <special character AppName>

lanza i. b. e. x. treinta y cinco

abrir <special character AppName>

facebook app launch करो/करना/कीजिए/करिएगा

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

1.0

アプリを起動

Launch app

starte <AppName>

spiel/öffne <AppName> app

starte AppName auf <DeviceBrand>

lance <AppName>

pars <AppName>

apri <AppName>

lanza la app de hulu

lanza youtube

abrir<AppName>

app launch करो/करना/कीजिए/करिएगा

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

1.0

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インターフェースを参照してください。

エラーレスポンス

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