開発者コンソール

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


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

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

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": {
        "entities": [
            {
                "externalIds": {
                    "gracenote": 100
                },
                "type": "Event",
                "uri": "entity://provider/event/games",
                "value": "games"
            },
            {
                "externaIds": {
                    "gracenote": "SP0000000666661"
                },
                "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": {
            "entities": [
                {
                    "externalIds": {
                        "gracenote": 100
                    },
                    "type": "Event",
                    "uri": "entity://provider/event/games",
                    "value": "games"
                },
                {
                    "externaIds": {
                        "gracenote": "SP0000000666661"
                    },
                    "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
省略可能
タイトル、シリーズ、俳優、チーム、メディアタイプなど、再生するエンティティオブジェクトの配列です。エンティティタイプと値の詳細については、エンティティタイプを参照してください。 配列
searchText
省略可能
ユーザーの検索クエリをテキストに変換したものがtranscribedフィールドの文字列値として格納されます。詳細については、実際のユーザーのリクエストの表示を参照してください。

transcribeを含むオブジェクト
transcribed
省略可能
ユーザーの発話をテキストに変換したものを提供します。詳細については、searchTextオブジェクトを参照してください。

例:h.d. 人気のコメディTV番組

文字列
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形式の文字列

エンティティタイプ

entitiesオブジェクトは、オブジェクトのリストで構成されています。それぞれのオブジェクトには、タイプ(type)や値のほか、外部IDなどのその他のデータが含まれます。type値として使用できる値は、 ActorAppChannelCharacterDirectorEpisodeEventFranchiseGenreLeagueMediaTypeProductionCompanySeasonSportSportsTeamVideoPopularityRecencyVideoResolutionです。以下のセクションでは、各エンティティタイプのペイロードの詳細について説明します。

Actor

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

Actorペイロードのフィールド 説明
externalIds このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。 オブジェクト
└─ ASIN このエンティティの外部ASINです。 文字列 B01M3X9T06
└─ gracenote 俳優のGracenote IDです。 文字列 SP0000000666661
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です。 オブジェクト
└─ gracenote 外部Gracenote IDです。 文字列 SP0000000666661
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
└─ gracenote キャラクターのGracenote IDです。 文字列 ST0000000123456
uri キャラクターへのURIマッピングです。 URI entity://provider/character/snowwhite
value キャラクターの名前です。 文字列 白雪姫

Director

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

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

Episode

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

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

Event

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

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

Franchise

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

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

Genre

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

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

League

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

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

MediaType

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

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

ProductionCompany

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

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

Season

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

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

Sport

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

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

SportsTeam

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

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

Video

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

Videoペイロードのフィールド 説明
externalIds このエンティティの外部識別子のマップです。キーはプロバイダー、値はIDです。 オブジェクト
ASIN このエンティティの外部ASINです。 文字列 B01M3X9T06
└─ gracenote Gracenote IDです。 文字列 MV0000000666661
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 ユーザーが新しいコンテンツと古いコンテンツのどちらを検索するかを示します。有効な値は、NEWOLDのいずれかです。 列挙型 NEW
このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例(関連する値のみ抜粋)は次のようになります。```json "entities": [..{ "value": "NEW", "type": "Recency" } ..], ```

VideoResolution

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

  • SD (480p)
  • HD (720p-1080p)
  • 4k (2160p)
  • 8k (4320p)
VideoResolutionペイロードのフィールド 説明
value ビデオ解像度です。有効な値は、SDHD4k8kです。 列挙型 HD
このエンティティタイプには、「externalIds」は含まれていません。レスポンスの例(関連する値のみ抜粋)は次のようになります。```json "entities": [..{ "value": "4k", "type": "VideoResolution" } ..], ```

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