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

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

SearchAndDisplayResultsディレクティブの発話
SearchAndDisplayResultsディレクティブの例
ペイロードの定義
- エンティティタイプ
- エクスペリエンスタイプ
SearchAndDisplayResultsディレクティブの処理
レスポンスの例
インターフェース機能に対するサポートの宣言

SearchAndDisplayResultsディレクティブの発話

ユーザーが以下の発話を行うと、AlexaはSearchAndDisplayResultsディレクティブをアプリ（アプリのみの統合の場合）またはLambda（クラウド側の統合の場合）に送信します。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	Search for breaking bad	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	Search for sean connery	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	Search for comedy	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	Search for star trek	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	Search movies	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	Search breaking bad season two	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	Search for breaking bad episode five	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	Search for breaking bad season two episode five	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	Search for james bond	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	Search for quentin tarantino	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	Search for disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	Search seahawks	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	Search for soccer	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	Search for n. b. a. league	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	Search for soccer game	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	Launch netflix app	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	Launch a. t. and t. u-verse app	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	trouve / cherche / montre [VideoName] sur [AppName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	recherche des films avec [ActorName] cherche des films avec [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	recherche un/une [GenreName] cherche un/une [GenreName]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	recherche [VideoName] cherche [VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	recherche [mediatype] cherche [mediatype]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	recherche la saison [number] de [title] cherche la saison [number] de [title]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	recherche la saison [number] de [title] cherche la saison [number] de [title]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	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]	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	recherche un film avec [charactername] cherche un film avec [charactername]	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	recherche un film de [DirectorName] cherche un film de [DirectorName]	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	recherche des films de disney cherche des films de disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	Not supported	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	Not supported	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	recherche [league] cherche [league]	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	Not supported	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	pars [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	pars [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	trouve / cherche / montre [VideoName] sur [AppName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	cherche des films avec [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	cherche une comédie	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	cherche star trek	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	Cherche [mediatype]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	cherche la saison [number] de [title]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	cherche l'épisode [number] de [title]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	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]	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	cherche un film avec [charactername]	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	cherche un film de quentin tarantino	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	cherche des films de disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	Not supported	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	Not supported	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	cherche [league]	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	Not supported	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	lance [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	lance [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	such nach? [VideoName] such/zeig/find film? [VideoName] auf [AppName] zeig mir film? [VideoName] auf [DeviceBrand] such trailer von [VideoName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	such [ActorNameName] filme zeig filme mit [ActorNameName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	zeig [GenreNameName] filme auf [AppName] such nach [GenreName] [MediaType]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	such nach? [VideoName] such/zeig/find film? [VideoName] auf [AppName] zeig mir film? [VideoName] auf [DeviceBrand] such trailer von [VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	find [MediaType] such/zeig/empfiehl [MediaType]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	spiel [VideoName] [Season] [Season_Numer] spiel [VideoName] [Season] [Season_Numer] auf [AppName]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	spiel die [Episode_Number] [Episode] von [VideoName] spiel [VideoName] [Episode_Number] spiel von [VideoName] [Episode] [Episode_Number]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	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	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	Not supported	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	such nach [MediaType] mit [ActorName] such [ActorName] [MediaType] zeig [MediaType] mit [ActorName]	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	suche nach [ProductionCompany] filmenzeige mir [ProductionCompany] filme	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能		リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	such [Sport] [Event] find [Sport] [Event]	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	Not supported	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	such [Sport] [Event] find [Sport] [Event]	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	starte [AppName] spiel/öffne [AppName] app starte [AppName] auf [DeviceBrand]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	starte [AppName] spiel/öffne [AppName] app starte AppName auf [DeviceBrand]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	[VideoName] खोजो/ढूँढो [AppName] पे/पर/में [VideoName] दिखा/खोज दो मुझे [VideoName] दिखाओ/खोजो/ढूँढो मुझे [AppName] पे/पर/में [VideoName] दिखाओ/खोजो/ढूँढो मुझे [VideoName] को [AppName] पे पर में दिखाओ/खोजो/ढूँढो खोजो [VideoName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	[ActorName] के/का/की/वाला movies दिखाओ/ढूँढो [ActorName] के/का/की/वाला [GenreName] movies दिखाओ/खोजो/ढूँढो [ActorName] के/का/की/वाला [GenreName] movie [VideoName] दिखाओ/खोजो/ढूँढो दिखाओ/खोजो [ActorName] के/का/की/वाला [GenreName] movies	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	[GenreName] movies दिखाओ/ढूँढो [ActorName] के/का/की/वाला [GenreName] movies दिखाओ/खोजो/ढूँढो	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	start trek के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	[VideoName] movie दिखाओ/ढूँढो [AppName] पे/पर/में [MediaType] को खोजो [ChannelName] को खोजो/ढूँढो	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	breaking bad season दो ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	breaking bad episode पाँच के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	breaking bad season दो episode five के लिये ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	[CharacterName] movie दिखाओ/खोजो [CharacterName] के/का/की/वाला movie [VideoName] दिखाओ/खोजो/ढूँढो	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	quentin tarantino के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	disney के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	netflix launch करो/करना/कीजिए/करिएगा	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	facebook app launch करो/करना/कीजिए/करिएगा	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	trova / cerca / mostra / dammi + VideoName (+ da/su ServiceName)?	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	cerca film con [ActorName] trova un film con [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	cerca [GenreName] trova [GenreName]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	cerca [VideoName] trova [VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	cerca [mediatype] trova mi un [mediatye]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	cerca la stagione due di [VideoName] trova la stagione due di [VideoName]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	cerca [VideoName] Episodio cinque trova [VideoName] Episodio cinque	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	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]	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	cerca un film con [CharacterName] trova un film con [CharacterName]	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	cerca [DirectorName]	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	cerca disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	not supported	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	cerca [Sport] trova [Sport]	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	not supported	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	cerca partite di [SportName] trova partite di calcio	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	lancia [AppName] apri [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	apri [special character AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	[VideoName]を探して[VideoName]を＜AppName]で探して	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	[ActorNameName]が出ている[MediaType]を探して	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	[GenreNameName]の[MediaType]を見つけて	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須		指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	[MediaType]を探して [AppName]で[MediaType]を探して [ChannelName]を検索	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能		一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能		ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	[title] シーズン[SeasonNumber] エピソード[EpisodeNumber] を探して	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	[CharacterNameName]が主人公の[MediaType]を探して	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能		リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	[ProductionCompany]を検索	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須		リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須		リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	procurar/buscar/mostrar [VideoName] no/na [AppName]	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	procurar por [ActorName]	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	procurar por [GenreName]	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	procurar[VideoName]	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	procurar [MediaType]	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	procurar [VideoName] temporada [SeasonNumber]	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	procurar por [title] episódio [EpisodeNumber]	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	procurar por [VideoName]episódio [EpisodeNumber]procurar por [VideoName]temporada [SeasonNumber]procurar por [VideoNumber]temporada	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	not supported	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	not supported	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	Procurar/procura/procure por [ProductionCompany]	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	procurar por[SportTeam]	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	procurar por [Sport]	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	procurar por [League]	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	procurar por [SportName]	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	abrir [AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	abrir [special character AppName]	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

機能	サンプル発話	想定されるレスポンス
＜タイトル＞を検索認定に必須	muestra juego de tronos enséña me el efecto mariposa	指定されたタイトルに一致する検索結果のリストがユーザーに表示されます。
俳優で検索認定に必須	busca películas con antonio banderas	リクエストされた俳優が出演している検索結果のリストがユーザーに表示されます。
ジャンル名で検索認定に必須	busca comedias románticas	リクエストされたジャンルからメディアの検索結果のリストが（ユーザーへのおすすめメディアを選び出すアルゴリズムによってパーソナライズされて）ユーザーに表示されます。
シリーズの＜タイトル＞で検索認定に必須	busca shrek	指定されたシリーズに一致する検索結果のリストがユーザーに表示されます。
メディアタイプで検索省略可能	busca películas enséña me las películas busca películas en netflix	指定されたメディアタイプに一致する検索結果のリストがユーザーに表示されます。
シーズン番号で＜タイトル＞を検索省略可能	enséña me la segunda temporada de friends	一致するシーズンのすべてのエピソードがユーザーに表示されます。
エピソード番号で＜タイトル＞を検索省略可能	busca el capítulo final de los serrano^*	ユーザーが最近視聴したシーズンの視聴可能なエピソードのリストが表示されます。たとえば、ユーザーがシーズン2を視聴中の場合、シーズン2のエピソードのリストが表示されます。
シーズン番号とエピソード番号で＜タイトル＞を検索省略可能	busca el segundo episodio de la primera temporada de anabel^*	ユーザーがリクエストしたシーズンの視聴可能なエピソードのリストが表示されます。これには、ユーザーが具体的にリクエストしたエピソードも含まれます。
キャラクター名で検索省略可能	busca películas de la pantera negra	リクエストされたキャラクターが出演しているメディアの検索結果のリストがユーザーに表示されます。
監督名で検索省略可能	busca las películas de alejandro lozano	リクエストされた監督が制作したメディアの検索結果のリストがユーザーに表示されます。
制作会社で検索省略可能	busca películas de disney	リクエストされた制作会社で制作されたメディアの検索結果のリストがユーザーに表示されます。
スポーツのチームで検索省略可能	busca el partido del real madrid	リクエストされたスポーツチームに一致する検索結果のリストがユーザーに表示されます。
スポーツの種類で検索省略可能	enséña nos un vídeo de fútbol	リクエストされたスポーツの種類に一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのリーグで検索省略可能	busca el partido de la n. b. a.	リクエストされたスポーツリーグに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
スポーツのイベントで検索省略可能	busca el partido de fútbol	リクエストされたスポーツイベントに一致する検索結果のリストが（ユーザーへのおすすめになるべく基づいて）ユーザーに表示されます。
＜パートナー＞アプリを起動認定に必須	lanza la app de netflix lanza netflix	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。
特殊文字のタイトルを起動認定に必須	lanza i. b. e. x. treinta y cinco	リクエストされたアプリが起動し、再生可能なメディアのリストが表示されます。マルチモーダルデバイスのホームページテンプレートには、異なるカテゴリーにメディアが分類されて表示される可能性があります。

SearchAndDisplayResultsディレクティブの例

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

アプリのみの統合
クラウド側の統合

EXTRA_DIRECTIVE_NAMESPACE: Alexa.RemoteVideoPlayer
EXTRA_DIRECTIVE_NAME: SearchAndDisplayResults
EXTRA_DIRECTIVE_PAYLOAD_VERSION: 3
EXTRA_DIRECTIVE_PAYLOAD: payload

payloadの内容は以下のとおりです。

{
    "payload": {
        "experience": {
            "mode": "VOICE_OPTIMIZED",
             },
        "entities": [
            {
                    "externalIds": {
                        "＜キー名＞": "＜イベントの外部ID＞"
                    },
                    "type": "Event",
                    "uri": "entity://provider/event/games",
                    "value": "games"
                },
            {
                "externaIds": {
                    "＜キー名＞": "＜スポーツチームのID＞"
                },
                "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"
        }
    }
}

{
    "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": {
            "experience": {
                "mode": "VOICE_OPTIMIZED",
                 },            
            "entities": [
                {
                    "externalIds": {
                        "＜キー名＞": "＜イベントの外部ID＞"
                    },
                    "type": "Event",
                    "uri": "entity://provider/event/games",
                    "value": "games"
                },
                {
                    "externaIds": {
                        "＜キー名＞": "＜スポーツチームのID＞"
                    },
                    "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"
            }
        }
    }
}

ペイロードの定義

以下のフィールドがサポートされています。
フィールド	説明	データ型
`entities` 省略可能	タイトル、シリーズ、俳優、チーム、メディアタイプなど、再生するエンティティオブジェクトの配列です。エンティティタイプと値の詳細については、エンティティタイプを参照してください。	配列
`experience` （省略可能）	検索結果の表示を最適化するオブジェクトです。`experience`オブジェクトを使用すると、ユーザーが検索に使用したデバイスに基づいて、検索結果の表示方法を変更できます。`experience`オブジェクトとその値の詳細については、エクスペリエンスタイプを参照してください。	`mode`を含むオブジェクト
`searchText` 省略可能	ユーザーの検索クエリをテキストに変換したものが`transcribed`フィールドの文字列値として格納されます。詳細については、実際のユーザーリクエストの表示を参照してください。	`transcribe`を含むオブジェクト
`transcribed` 省略可能	ユーザーの発話をテキストに変換したものを提供します。詳細については、searchTextオブジェクトを参照してください。例：`h.d. 人気のコメディTV番組`	文字列
`timeWindow` 省略可能	ユーザーが再生したいコンテンツのタイムウィンドウを指定します。たとえば、先週のエピソードを再生したい場合、タイムウィンドウには前の週を指定します。	`start`と`end`の時間を含むオブジェクト
`end` 省略可能	タイムウィンドウの終了時刻。例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601形式の文字列
`start` 省略可能	タイムウィンドウの開始時刻。例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601形式の文字列

エンティティタイプ

entitiesオブジェクトは、オブジェクトのリストで構成されています。それぞれのオブジェクトには、タイプ（type）や値のほか、外部IDなどのその他のデータが含まれます。type値として使用できる値は、 Actor、App、Channel、Character、Director、Episode、Event、Franchise、Genre、League、MediaType、ProductionCompany、Season、Sport、SportsTeam、Video、Popularity、Recency、VideoResolutionです。以下のセクションでは、各エンティティタイプのペイロードの詳細について説明します。

Actor

Actorは、ビデオメディアコンテンツに出演している俳優を表します。たとえば、俳優の「ケイシー・アフレック」の場合は、以下のようなフィールドが含まれます。

Actorペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `ASIN`	このエンティティの外部ASINです。	文字列	`B01LTHZVKG`
└─ `imdb`	俳優のIMDB識別子です。	文字列	`tt4034228`
`uri`	俳優／女優へのURIマッピングです。	URI	`entity://provider/actor/caseyaffleck`
`value`	俳優の名前です。	文字列	`ケイシー・アフレック`

App

Appは、ユーザーが発話で指定した明示的なアプリ名を表します。たとえば、「Amazonプライム・ビデオの『マンチェスター・バイ・ザ・シー』」の場合は、以下のようなフィールドが含まれます。

Appペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `ENTITY_ID`	アプリのリストに含まれるアプリ識別子です。	文字列	`amzn1.alexa-ask-target.app.72095`
`value`	アプリの名前です。	文字列	`Amazonプライム・ビデオ`

Channel

Channelは、テレビチャンネルの識別データを表します。たとえば、「PBS」には以下のようなフィールドが含まれます。

Channelペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`entityMetadata`	チャンネルに関連付けられたメタデータのマップです。	オブジェクト	—
└─ `channelNumber`	チャンネル番号です。	整数	`1234`
└─ `channelCallSign`	チャンネルのコールサインです。	文字列	`KBTC`
`uri`	チャンネルのURIです。	URI	`entity://provider/channel/1234`
`value`	チャンネルの名前です。	文字列	`PBS`

Character

Characterは、ビデオメディアコンテンツのキャラクターを表します。

Characterペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `ASIN`	このエンティティのASIN（Amazon Standard Identification Number）です。	文字列	`B00DT55P3K`
└─ `imdb`	キャラクターのIMDB識別子です。	文字列	`character id`
`uri`	キャラクターへのURIマッピングです。	URI	`entity://provider/character/snowwhite`
`value`	キャラクターの名前です。	文字列	`白雪姫`

Director

Directorは、ビデオメディアコンテンツの監督名を表します。たとえば、「ケネス・ロナーガン」の場合は、以下のようなフィールドが含まれます。

Directorペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`uri`	監督へのURIマッピングです。	URI	`entity://provider/director/kennethlonergan`
`value`	監督の名前です。	文字列	`ケネス・ロナーガン`

Episode

Episodeは、TV番組などの連続コンテンツのエピソード番号を表します。たとえば、「トランスペアレント」第8話のエピソード番号は「8」になります。

Episodeペイロードのフィールド	説明	型	例
`value`	エピソード番号です。	整数	`8`

Event

Eventは、イベントタイプへの参照です。これには、スポーツ、音楽、その他のタイプのイベントが含まれます。たとえば、「フットボールの試合」を検索する場合、「試合」というイベントエンティティと「フットボール」というスポーツエンティティが検索されます。

Eventペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	イベントのIMDB識別子です。	文字列	`tt4034228`
`uri`	イベントへのURIマッピングです。	URI	`entity://amazon/events/games`
`value`	イベントタイプの名前です。	文字列	`試合`

Franchise

Franchiseは、映画やTV番組など、複数のビデオエンティティを表すビデオエンティティです。たとえば、「宇宙大戦争」というSFシリーズの場合、映画シリーズのほか、アニメと実写のTV番組もあります。このエンティティタイプを使用すると、たとえばユーザーが「『宇宙大戦争』の映画を探して」とリクエストした場合、1つのタイトルだけでなく、MediaTypeがMOVIEである「宇宙大戦争」の全コンテンツを検索できます。

Franchiseペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`uri`	シリーズへのURIマッピングです。	イベントへのURIマッピングです。	`entity://amazon/franchise/intergalacticwars`
`value`	ジャンルの名前です。	文字列	`宇宙大戦争`

Genre

Genreは、アクション、ドラマ、コメディといった、ビデオメディアコンテンツのジャンルを表します。たとえば、アクションのジャンルの場合は、以下のようなフィールドが含まれます。

Genreペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	外部IMDB識別子です。	文字列	`tt4034228`
`uri`	ジャンルへのURIマッピングです。	URI	`entity://provider/genre/action`
`value`	ジャンルの名前です。	文字列	`アクション`

League

Leagueは、スポーツリーグのカテゴリー情報を表します。たとえば、NCAAというリーグの場合は、以下のようなフィールドが含まれます。

Leagueペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	リーグのIMDB識別子です。	文字列	`tt4034228`
`uri`	リーグへのURIマッピングです。	URI	`entity://amazon/league/ncaa`
`value`	リーグの名前です。	文字列	`NCAA`

MediaType

MediaTypeは、特定のコンテンツのメディアタイプカテゴリーを表します。たとえば、「マンチェスター・バイ・ザ・シー」という映画の場合、MediaTypeはMOVIEになります。

MediaTypeペイロードのフィールド	説明	型	例
`value`	メディアタイプです。有効な値は、`MOVIE`、`VIDEO`、`TV_SHOW`です。	列挙型	`MOVIE`

ProductionCompany

ProductionCompanyは、ビデオメディアコンテンツの制作会社名を表します（例：Marvels、Disney）。

ProductionCompanyペイロードのフィールド	説明	型	例
`value`	制作会社の名前です。	文字列	`Marvel`

Season

Seasonは、TV番組などの連続コンテンツのシーズン番号を表します。たとえば、「トランスペアレント」シーズン2のシーズン番号は「2」になります。

Seasonペイロードのフィールド	説明	型	例
`value`	シーズン番号です。	整数	`2`

Sport

Sportは、スポーツのカテゴリー情報を表します。たとえば、フットボールの場合は、以下のようなフィールドが含まれます。

Sportペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	スポーツのIMDB識別子です。	文字列	`tt4034228`
`uri`	スポーツへのURIマッピングです。	URI	`entity://amazon/sport/football`
`value`	スポーツの名前です。	文字列	`フットボール`

SportsTeam

SportsTeamは、プロスポーツチームのカテゴリー情報を表します。たとえば、「ワシントン大学ハスキーズ」というスポーツチームの場合は、以下のようなフィールドが含まれます。

SportsTeamペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
└─ `imdb`	このチームのIMDB識別子です。	文字列	`tt4034228`
`uri`	スポーツチームへのURIマッピングです。	URI	`entity://amazon/sportsteam/huskies`
`value`	スポーツチームの名前です。	文字列	`ワシントン大学ハスキーズ`

Video

Videoは、ビデオコンテンツの識別データを表します。たとえば、「マンチェスター・バイ・ザ・シー」という映画の場合は、以下のようなフィールドが含まれます。

Videoペイロードのフィールド	説明	型	例
`externalIds`	このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。	オブジェクト	—
`ASIN`	このエンティティの外部ASINです。	文字列	`B01LTHZVKG`
└─ `imdb`	IMDB識別子です。	文字列	`tt4034228`
`userConfirmations`	アイテムのユーザー確認に関する情報を含むオブジェクトです。	オブジェクト
└─ `entitlementVoiceActivation`	視聴期間または視聴権限の音声有効化に成功したかどうかをパートナーに通知するフラグです。有効な値 - `CONFIRMED`（省略可能）。	列挙型（デフォルトポリシー：認識されない値は無視）	`CONFIRMED`
`uri`	ビデオへのURIマッピングです。	URI	`entity://provider/movie/manchesterbythesea`
`value`	ビデオの名前です。	文字列	`マンチェスター・バイ・ザ・シー`

Popularity

Popularityは、ユーザーが人気コンテンツを求めているかどうかを示します。

Popularityペイロードのフィールド	説明	型	例
`value`	ユーザーが人気コンテンツを検索したことをプロバイダーに示します。	文字列	`TRUE`

このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例（関連する値のみ抜粋）は次のようになります。```json "entities": [..{ "value": "TRUE", "type": "Popularity" } ..], ```

Recency

Recencyの解決済みの値は、ユーザーが新しいコンテンツを求めているか、古いコンテンツを求めているかを示します。

Recencyペイロードのフィールド	説明	型	例
`value`	ユーザーが新しいコンテンツと古いコンテンツのどちらを検索するかを示します。有効な値は、`NEW`、`OLD`のいずれかです。	列挙型	`NEW`

このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例（関連する値のみ抜粋）は次のようになります。```json "entities": [..{ "value": "NEW", "type": "Recency" } ..], ```

VideoResolution

VideoResolutionは、リクエストされたビデオ解像度を次のいずれかの規格で表します。

SD (480p)
HD (720p-1080p)
4k (2160p)
8k (4320p)

VideoResolutionペイロードのフィールド	説明	型	例
`value`	ビデオ解像度です。有効な値は、`SD`、`HD`、`4k`、`8k`です。	列挙型	`HD`

このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例（関連する値のみ抜粋）は次のようになります。```json "entities": [..{ "value": "4k", "type": "VideoResolution" } ..], ```

エクスペリエンスタイプ

experienceオブジェクトを使用すると、検索に使用されたデバイスに基づいて、検索結果の表示を最適化できます。たとえば、ユーザーがFire TVリモコンを使用して検索した場合、ユーザーはリモコンを使用して結果を閲覧できるため、experienceオブジェクトによって多数の検索結果が表示されます。一方、Fire TVとペアリングされたEchoを使用して検索リクエストが行われた場合は、experienceオブジェクトによって表示される結果の数と表示方法が制限され、ユーザーはリモコンを使用せずに結果を確認できます。

experienceオブジェクトは、検索結果の表示方法を決定するmodeオブジェクトで構成されています。modeオブジェクトは、 VOICE_OPTIMIZEDとDEFAULTの2つの値を取ります。

VOICE_OPTIMIZED：音声専用デバイス向けに最適化された表示方法です。リモコンを使用せずに音声で操作できる検索結果のリストが表示されます。
DEFAULT：検索に使用されたデバイスに関係なく、すべての検索結果をリスト形式で表示する、デフォルトの表示方法です。

上位互換性を確保するため、modeで不明な値を受け取った場合は、失敗とするのではなく、DEFAULTにフォールバックするようにしてください。

SearchAndDisplayResultsディレクティブの処理

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

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

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

タイトルで検索

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

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

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

シリーズで検索

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

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

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

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

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

アートワーク

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

実際のユーザーのリクエストの表示

searchTextオブジェクトに関する説明および推奨事項については、実際のユーザーのリクエストの表示を参照してください。

アプリでディレクティブが正常に処理された場合、BroadcastReceiverクラスは、次のように、成功ステータスを含む成功のインテントを返送します。

if (response != null && sendResponse) {
  Intent success = new Intent().putExtra(VSKIntentConstants.EXTRA_DIRECTIVE_STATUS, didSucceed);
  try {
    response.send(context, 0, success);
  } catch(PendingIntent.CanceledException e) {
    // 応答に時間がかかりすぎているため、ログにエラーを出力します
  }
}

詳細については、手順7： BroadcastReceiverを追加するを参照してください。また、具体的なコードの例については、サンプルアプリのAlexaDirectiveReceiverクラスを参照してください。

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の内容は不要です。Fire TV対応アプリのビデオスキルでは、Alexaへのレスポンスは最小限で、空のpayloadが返されます。これは、必要な命令をADM経由でFire TV対応アプリに送信しているためです。

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

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

アプリのみの統合
クラウド側の統合

RemoteVideoPlayerインターフェースからのSearchAndDisplayディレクティブをアプリで受け取るには、機能を宣言する際にこのインターフェースのサポートを明示する必要があります。アプリのみの統合での機能の宣言の詳細については、以下を参照してください。

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