開発者コンソール

GetPlayableItemsディレクティブ


GetPlayableItemsディレクティブ

VideoNameActorNameGenreNameなどの条件を使用して映画やテレビ番組、録画などを再生するようユーザーがAlexaに依頼すると、GetPlayableItemsディレクティブがVideoContentProvider APIからLambdaに送信されます。

下図のように、LambdaからはレスポンスとしてGetPlayableItemsResponseを返す必要があります。

GetPlayableItemsディレクティブとLambdaのGetPlayableItemsResponse

GetPlayableItemsの発話

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

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

Watch breaking bad

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

Watch sean connery

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

Watch comedy

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

シリーズの<タイトル>で再生
認定に必須

Watch star trek

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

Watch a movie

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

Watch breaking bad season two

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

Watch breaking bad episode five

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

Watch breaking bad season two episode five

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

Watch james bond

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

Watch seahawks

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

Watch soccer

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

Watch n. b. a. league

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

Watch soccer game

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

mets / joue / lance / pars [VideoName] sur [AppName]

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

regarde un film avec [actor]

mets un film avec [actor]

joue un film avec [actor]

pars un film avec [actor]

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

regarder un [GenreName]

regarder une [GenreName]

mets un [GenreName]

mets une [GenreName]

joue un [GenreName]

joue une [GenreName

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

シリーズの<タイトル>で再生
認定に必須

regarde [title]

mets [title]

joue [title]

pars [title]

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

regarde un film

mets un film

joue un film

pars un film

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

regarde la saison [x] de [title]

mets la saison [x] de [title]

joue la saison

[x] de [title]

pars la saison [x] de [title]

regarde [title] saison [x]

mets [title] saison [x]

joue [title] saison [x]

pars [title] saison [x]

joue la saison [x] de [title]

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

regarde l'épisode [x] de [title]

mets l'épisode [x] de [title]

joue l'épisode [x] de [title]

pars l'épisode [x] de [title]

joue [title] épisode [x]

mets [title] épisode [x]

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

Same as fr-FR

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

Not supported

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

Regarde le [team]

Regarde le match de [team]

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

Not supported

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

Mets [league]

Joue [league]

Regarde [league]

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

Not supported

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

mets / joue / lance [VideoName] sur [AppName]

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

regarde un film avec [actor]

mets un film avec [actor]

joue un film avec [actor]

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

regarder un [GenreName]

regarder une [GenreName]

mets un [GenreName]

mets une [GenreName]

joue un [GenreName]

joue une [GenreName

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

シリーズの<タイトル>で再生
認定に必須

Regarde [title]

Mets [title]

Joue [title]

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

regarde un film

mets un film

joue un film

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

Regarde la saison [x] de [title]

Mets la saison [x] de [title]

Regarde [title] saison [x]

Mets [title] saison [x]

Joue [title] saison [x]

Joue la saison [x] de [title]

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

Regarde l'épisode [x] de [title]

Mets l'épisode [x] de [title]

Joue l'épisode [x] de [title]

Joue [title] épisode [x]

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

Regarde l'épisode [x] de la saison [x] de [title]

Joue l'épisode [x] de la saison [x] de [title]

Mets l'épisode [x] de la saison [x] de [title]

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

Not supported

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

Regarde le [team]

Regarde le match de [team]

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

Not supported

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

Mets [league]

Joue [league]

Regarde [league]

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

Not supported

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

ich möchte [VideoName] gucken

spiel [VideoName]

spiel watchlist ab von [VideoName]

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

spiel [VideoName] (mit [ActorName]) auf [AppName]

streame einen film mit [ActorName] auf [AppName]

streame einen [ActorName] film auf [AppName]

streame eine serie mit [ActorName] auf [AppName]

streame eine [ActorName] serie auf [AppName]

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

spiel eine [GenreName] [MediaType] auf [DeviceType] ab

spiel eine [GenreName] [MediaType] auf [AppName] ab

[GenreName] [MediaType] schauen

spiel einen [GenreName] [MediaType]

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

シリーズの<タイトル>で再生
認定に必須

ich möchte [VideoName] gucken

spiel [VideoName]

spiel watchlist ab von [VideoName]?

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

spiel einen [MediaType]

spiel [MediaType] aus der/meiner watchlist

streame den [MediaType] [VideoName] auf [AppName]/[Device] spiel trailer von [VideoName]

spiel die neueste folge von [VideoName]

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

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]

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

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

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

spiel [SportsTeam] [Event] auf [AppName]

[SportsTeam] [Event] anschauen/ansehen

das [SportsTeam] [Event] auf [AppName] anschauen/ansehen

spiel das [SportsTeam] [Event] auf meinem [Device]

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

spiel das [Sport] [Event] auf meinem [Device]

das [Sport] [Event] ansehen

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

spiel [SportsTeam] [Event] auf [AppName]

[SportsTeam] [Event] anschauen

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

spiel das [Sport] [Event] auf meinem [Device]

das [Sport] [Event] ansehen

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

[VideoName] चलाओ/बजाओ/लगाओ/play/देखो [AppName] पे/पर/में [VideoName] चलाओ/बजाओ/लगाओ/play

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

[ActorName] का/की/के movies को चलाओ/बजाओ/लगाओ/play/देखो [ActorName] का/की/के movies चलाओ/बजाओ/लगाओ/play/देखो [ActorName] का/की/के [GenreName] को चलाओ/बजाओ/लगाओ/play/देखो [ActorName] का/की/के [GenreName] चलाओ/बजाओ/लगाओ/play/देखो [ActorName] का/की/के [VideoName] को चलाओ/बजाओ/लगाओ/play/देखो [ActorName] का/की/के [VideoName] चलाओ/बजाओ/लगाओ/play/देखो

[ActorName] का/की/के/वाला [GenreName] की [VideoName] को चलाओ/बजाओ/लगाओ/play/देखो [ActorName] का/की/के/वाला [GenreName] की [VideoName] चलाओ/बजाओ/लगाओ/play/देखो

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

[GenreName] [VideoName] को चलाओ/बजाओ/लगाओ/play/देखो [GenreName] [VideoName] चलाओ/बजाओ/लगाओ/play/देखो

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

シリーズの<タイトル>で再生
認定に必須

star trek देखो/देखना/देखिए

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

[VideoName] movies चलाओ/बजाओ/लगाओ/play/देखो

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

[VideoName] का/की/के [SeasonNumber] को चलाओ/बजाओ/लगाओ/play/देखो [VideoName] का/की/के [SeasonNumber] चलाओ/बजाओ/लगाओ/play/देखो [VideoName] का/की/के [SeasonNumber] को चलाओ/बजाओ/लगाओ/play/देखो [VideoName] का/की/के [SeasonNumber] [SeasonNumber] चलाओ/बजाओ/लगाओ/play/देखो

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

[VideoName] का/की/के [EpisodeNumber] को चलाओ/बजाओ/लगाओ/play/देखो [VideoName] का/की/के [EpisodeNumber] चलाओ/बजाओ/लगाओ/play/देखो

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

[VideoName] season one episode one चलाओ/बजाओ/लगाओ/play करो

[VideoName] season एक का episode एक चलाओ/बजाओ/लगाओ/play करो

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

[CharacterName] का/की/के/वाला movies चलाओ/बजाओ/लगाओ/play/देखो [CharacterName] का/की/के/वाला movies को चलाओ/बजाओ/लगाओ/play/देखो Watch [CharacterName] movie [VideoName]

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

[Sport/League/Seam] games चलाओ/बजाओ/लगाओ/play/देखो [Sport/League/Seam] के games को चलाओ/बजाओ/लगाओ/play/देखो

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

[Sport/League/Seam] games चलाओ/बजाओ/लगाओ/play/देखो [Sport/League/Seam] के games को चलाओ/बजाओ/लगाओ/play/देखो

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

[Sport/League/Seam] games चलाओ/बजाओ/लगाओ/play/देखो

[Sport/League/Seam] के games को चलाओ/बजाओ/लगाओ/play/देखो

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

[Sport/League/Seam] games चलाओ/बजाओ/लगाओ/play/देखो [Sport/League/Seam] के games को चलाओ/बजाओ/लगाओ/play/देखो

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

metti / trasmetti / riproduci / fammi guardare / fammi vedere + [VideoName] (+ da/su [DeviceName])

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

guarda un film con [ActorName]

metti un film con [ActorName]

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

guarda una [GenreName]

fammi vedere una commedia

mostra mi una commedia

metti una commedia

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

シリーズの<タイトル>で再生
認定に必須

guarda star trek

fammi vedere star trek

mostra star trek

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

guarda un film

metti un fim

trasmetti un film

riproduci un film

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

guarda [VideoName] stagione due

metti [VideoName] stagione due

riproduci [VideoName] stagione due

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

guarda [VideoName] episodio cinque

metti [VideoName] episodio cinque

riproduci [VideoName] episodio cinque

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

guarda [VideoName] stagione due episodio cinque

metti [VideoName] stagione due episodio cinque

riproduci [VideoName] stagione due episodio cinque

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

guarda [CharacterName]

fammi vedere un film con james bond

mostrami un film di james bond

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

riproduci la partita del [SportsTeam]

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

not supported

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

trasmetti la partita della [League]

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

not supported

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

[VideoName]を再生して [VideoName]を[AppName]で再生して [AppName]で[VideoName][MediaType]を再生して

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

[ActorNameName]が出ている[MediaType]を再生

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

[AppName]で[GenreNameName][MediaType]を再生[AppName]で[GenreNameName]を再生

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

シリーズの<タイトル>で再生
認定に必須

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

[VideoName]を再生して [VideoName]を<AppName]で再生して [AppName]で[VideoName][MediaType]を再生して

[MediaType]を再生して

[ActorNameName]が出ている[MediaType]を再生

[Anaphor][MediaType]を流して

[AppName]で[GenreNameName][MediaType]を再生

[AppName]で[VideoName][MediaType]を再生して

[ChannelName]の[MediaType]を再生

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

[VideoName]の[Season][Season_Number]の

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

[Episode_Number][Episode]を再生

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

[Episode_Number][Episode]を再生

[VideoName]の[Season][Season_Number]の

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

[SportsTeam]の[Event]を[AppName]で見せて

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

[SportsTeam]の[Event]を[AppName]で見せて

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

[SportsTeam]の[Event]を[AppName]で見せて

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

[SportsTeam]の[Event]を[AppName]で見せて

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

tocar/assistir/reproduzir [VideoName] no/na [AppName]

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

assistir [ator]

colocar [ator]

coloque filmes com [ator]

encontre filmes com [ator]

me mostre filmes com [ator]

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

assitir [GenreName]

assistir programas de [GenreName]

programas de [GenreName]

colocar [GenreName]

por favor reproduzir [GenreName]

reproduzir programas de [GenreName]

colocar um programa de [GenreName]

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

シリーズの<タイトル>で再生
認定に必須

assitir jornada nas estrelas

colocar jornada nas estrelas

reproduzir jornada nas estrelas

você pode passsar jornada nas estrelas

por favor reproduzir jornada nas estrelas

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

assistir um filme

colocar um filme

nós podemos assistir um filme

ver um filme

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

assistir [title] temporada [x]

colocar [title] temporada [x]

reproduzir [title] temporada [x]

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

assistir [title] episódio [x]

colocar [title] episódio [x]

reproduzir [title] episódio [x]

reproduzir o [title] episódio [x]

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

assistir [title] temporada [x] episódio [x]

colocar [title] temporada [x] episódio [x]

reproduzir [title] temporada [x] episódio [x]

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

Not Supported

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

assisitr [SportTeam]

assitir o/a [SportTeam]

colocar no/na [SportTeam]

colocar o jogo do/da [SportTeam]

me mostre o jogo do/da [SportTeam]

mostre o jogo do/da [SportTeam]

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

assistir [Sport]

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

assistir [League]

colocar [League]

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

not supported

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

機能 サンプル発話 想定されるレスポンス
<タイトル>を再生
認定に必須

pon interstellar

reproduce interstellar

ver interstellar

リクエストされたメディアが再生されます。一致するコンテンツが複数ある場合、ユーザーは目的のメディアを選択するように求められます。

俳優で再生
認定に必須

pon salma hayek

reproduce salma hayek

リクエストされた俳優が出演しているメディアが(ユーザーへのベストマッチを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

ジャンル名で再生
認定に必須

pon comedia en netflix (Not supported without AppName)

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

シリーズの<タイトル>で再生
認定に必須

pon star wars

reproduce star wars

リクエストされたシリーズの検索結果から最上位のおすすめが再生されるか、一致するシリーズのリストがユーザーに表示されます。

メディアタイプで再生
省略可能

pon la película*

reproduce la película*

Note: Not supported in es-ES or es-US

タイトル以外のリクエストに一致するメディアが(ユーザーへのおすすめビデオを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

シーズン番号で<タイトル>を再生
省略可能

empieza la segunda temporada de los rompecorazones

comienza la segunda temporada de los rompecorazones

reproduce la segunda temporada de los rompecorazones

シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

エピソード番号で<タイトル>を再生
省略可能

pon el capítulo final de los serrano

ユーザーが最後に再生したエピソードから、適切なシーズンが特定されます。シリーズの最後に再生したエピソードが再生途中の場合は、そのエピソードが再生されます。再生が完了している場合は、次の未再生エピソードが再生されます。

シーズン番号とエピソード番号で<タイトル>を再生
省略可能

pon el segundo episodio de la primera temporada de anabel

reproduce el cuarto episodio de la temporada tres de águila roja

リクエストされたシーズンとエピソードに対応するコンテンツが再生されます。

キャラクター名で再生
省略可能

reproduce algo con james bond

リクエストされたキャラクター名に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツのチームで再生
省略可能

ver el partido del real madrid

リクエストされたスポーツチームに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、メディアの検索結果リストがユーザーに表示されます。

スポーツの種類で再生
省略可能

reproduce el partido de fútbol en mi televisor

ver el partido de fútbol en mi tele

ver el partido de fútbol

リクエストされたスポーツの種類に一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのリーグで再生
省略可能

pon el partido de la a. c. b. en mi tele

ver el partido de la a. c. b. en mi televisor

リクエストされたスポーツリーグに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

スポーツのイベントで再生
省略可能

ver el partido de fútbol

リクエストされたスポーツイベントに一致するメディアが(ユーザーへのおすすめメディアを選び出すアルゴリズムによって)再生されるか、検索結果リストがユーザーに表示されます。

GetPlayableItemsディレクティブの処理

Alexaは、ユーザーの発話を解析してインテントを判断し、それをGetPlayableItemsディレクティブとしてパッケージ化します。しかし、ユーザーが何を再生したいのかがはっきりとはわからない場合もあります。そこでAlexaは、再生するアイテムを検索できるよう、リクエストされたコンテンツをLambdaに送信します。

Lambdaから送信するレスポンスには、再生可能なコンテンツを特定する基本的な情報を含める必要があります。そのレスポンスに応じて、Alexaは次のことを行います。

  • Lambdaからレスポンスで返されたアイテムが1つだけの場合は、再生を開始するためにGetPlayableItemsMetadataディレクティブを送信します。
  • Lambdaからレスポンスで返されたアイテムが複数ある場合は、検索結果を表示するためにGetDisplayableItemsMetadataディレクティブを送信します。

GetPlayableItemsディレクティブは、header名を除けばGetDisplayableItemsと同じです。GetPlayableItemsディレクティブが使用されるのは、デバイスでコンテンツを再生するようユーザーから依頼された場合です。再生用のディレクティブと検索用のディレクティブとが分かれているため、よりユーザーのインテントに沿った処理を行うことが可能になります。 

各種のシナリオで検索を実行する方法についての一般的な指針は次のとおりです。

ビデオ名 (例:「『インターステラー』を再生して」)

「『インターステラー』を再生して」のように、ユーザーの発話にビデオ名が含まれていた場合、Alexaから送信されるGetPlayableItemsディレクティブには、カタログ内で見つかった関連性の高いビデオ名がすべて含まれます。また、このディレクティブのexternalIdsフィールドには、カタログIDも含まれています。videoNamesと共に送信されるIDに基づいてコンテンツを選定し、再生できるアイテムを選択して返すようにしてください。

ジャンル/俳優 (例:「コメディ映画を再生して」、「トム・クルーズのアクション映画を再生して」)

ビデオ名がなく、ジャンルや俳優といったその他のスロットがある場合は、GetPlayableItemsディレクティブがAlexaから送信されます。このような場合は、ディレクティブで送信されたエンティティを使用して検索を実行する必要があります。

たとえば、「アクション映画を再生して」という発話の場合、{mediaType: MOVIE, genreName: コメディ}GetPlayableItemsディレクティブで送信されます。この情報を基に検索を実行し、コメディ映画の識別子を返すことができます。 

「トム・クルーズのアクション映画を再生して」という発話の場合も同様に、{mediaType: MOVIE, genreName: アクション, actorName: トム・クルーズ}GetPlayableItemsディレクティブで送信されるので、この条件に一致する映画の識別子を検索して返すことができます。

識別子をレスポンスで返すと、追加のメタデータを取得するためのGetPlayableItemsMetadataディレクティブがAlexaから送信されます。

GetPlayableItemsの例

GetPlayableItemsディレクティブの例を次に示します。この例では、メディアのタイトル(「マンチェスター・バイ・ザ・シー」)がユーザーから明示的に指定されています。

{
    "directive": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "9f4803ec-4c94-4fdf-89c2-d502d5e52bb4",
            "name": "GetPlayableItems",
            "namespace": "Alexa.VideoContentProvider",
            "payloadVersion": "3"
        },
        "endpoint": {
            "scope": {
                "type": "BearerToken",
                "token": "access-token-from-skill"
            },
            "endpointId": "videoDevice-001",
            "cookie": {

            }
        },
        "payload": {
            "entities": [
                {
                    "type": "Video",
                    "value": "マンチェスター・バイ・ザ・シー",
                    "externalIds": {
                        "gracenote": "MV000000099001"
                    }
                }
            ],
            "contentType": "RECORDING",
            "locale": "ja-JP",
            "minResultLimit": 8,
            "maxResultLimit": 25,
            "timeWindow": {
                "start": "2016-09-01T00:00:00+00:00",
                "end": "2016-09-07T23:59:00+00:00"
            }
        }
    }
}

ペイロードの説明

次の表は、GetPlayableItemsディレクティブのpayloadについて説明しています。

ペイロードの説明
フィールド 説明 データ型
entities
(必須)

検索するエンティティオブジェクトのリスト。通常、異なるエンティティタイプ間の関係は、AND演算と解釈されます。たとえば、{genreName = "コメディ," actorName ="トム・ハンクス"}を含むリクエストの場合、検索結果にはトム・ハンクスが出演するコメディの映画またはテレビ番組が含まれることになります。

一方、{videoName = "インターステラー," VideoName = "宇宙戦争"}など、同じタイプの複数のエンティティがリクエストに含まれる場合は、OR演算と見なし、ディレクティブ内のすべてのエンティティを検索することができます。不確かな場合は、そのタイプ(このケースではvideoName)の先頭のエンティティを最も関連性が高いものと見なします。

さらに、{mediaType = "MOVIE', genreName = "コメディ," actorName ="トム・ハンクス," actorName = "トム・ハンクス}というリクエストを考えてみましょう。これは、トム・ハンクスという名前の俳優が複数存在すると考えられます。このような場合は、リクエスト内のすべての俳優を含む映画を検索したうえで、コメディのジャンルでフィルタリングして、すべての検索結果を返すことができます。

現時点では、一致するエンティティが複数ある場合にユーザーが何を再生したいかを知る方法がAlexaにはないため、エンティティのランク付けは行われません。

type: Channelを持つentitiesには、 テレビチャンネルの識別データが格納されます。以下に例を示します。

 {
  "type": "Channel",
  "value": "PBS",
  "externalIds": {
      "gracenote": "MV000000099001"
  },
  "entityMetadata": {
      "channelCallSign": "KBTC",
      "channelNumber": "123"
  }
} 

リスト
type
(必須)

ビデオコンテンツのエンティティタイプ。ビデオコンテンツのエンティティタイプの一覧については、エンティティタイプを参照してください。



例: MediaTypevideoActorGenreFranchiseSeasonEpisode

文字列
value
(必須)

エンティティの値。チャンネルの場合は、チャンネル名。



例: インターステラーPBS

文字列
externalIds
(省略可能)
このエンティティの外部識別子のマップ。keyはプロバイダー、valueidです。

例:key = gtivalue = SH000000012

オブジェクト
Gracenote
省略可能

外部Gracenote IDです。



例: SP0000000666661

文字列
contentType
省略可能

contentTypeは、検索するコンテンツのカテゴリーを指定します。エンティティのMediaTypeとは異なることに注意してください。MediaTypeでは、検索するメディアのタイプ(映画、テレビ番組など)を指定します。そのため、録画した映画を閲覧する場合は、「録画した映画を見せて」などと発話します。このとき、mediaTypeはMOVIEに、contentTypeはRECORDINGに設定されます。同様に、ライブTVのコンテンツを閲覧する場合は、「今放送中の番組を見せて」などと発話します。このとき、contentTypeはLIVEに設定されます。



例: RECORDINGLIVEON_DEMAND

列挙型
locale
(必須)

ユーザーのロケール。検索結果に対応する表示可能な情報を取得するために必要となります。ロケールの形式は、Network Working Groupの「Best Current Practice 47(BCP-47)」(英語のみ)で規定されている言語の形式と同じです。認識されないロケールを受信した場合は、デフォルトでen-USになります。



例:en-USen-GBde-DE

文字列
minResultLimit
(必須)

この呼び出しで返される結果でpageTokenが必要となる最小件数。pageTokenは次の結果を取得するためのもので、新しいアイテムを取得する際にこれと一緒に返されたアイテムの件数がminResultLimitフィールドよりも少ない場合、AlexaはpageTokenを無視し、受信したアイテムをそのまま表示します。

pageTokenを使用して次の結果を取得するのは、アイテムの件数がminResultLimitの値以上である場合のみです。ただし、アイテムの件数がminResultLimitを超える場合は、maxResultLimitが上限となります。アイテムの件数がmaxResultLimitを超えると、maxResultLimitを超えたアイテムはAlexaによって破棄されます。



例: 8

整数
maxResultLimit
(必須)

返される結果の最大件数(上限)。詳細については、minResultLimitフィールドの説明を参照してください。



例: 25

整数
timeWindow
省略可能

リクエストされた処理の開始時刻と終了時刻を指定します。これは通常、ライブTVや録画にのみ使用され、オンデマンドコンテンツには使用されません。一般的に、タイムウィンドウが指定されており、それを使用して結果をフィルタリングできる場合は、タイムウィンドウを使用する必要があります。

検索対象がオンデマンドコンテンツのみとなるプロバイダーの場合は、タイムウィンドウフィールドが通常nullに設定されているため、無視して構いません。

ライブTVや録画でユーザーがタイムウィンドウを指定している場合(「午後4時から5時のテレビ番組を検索して」や「先週録画したテレビ番組を探して」など)、開始時刻と終了時刻が指定されていれば、それらを使用して結果をフィルタリングする必要があります。

機能によって、startendの両方のフィールドが存在する場合と、どちらか一方のフィールドしか存在しない場合とがあります。たとえば、「午後4時から5時のテレビ番組を検索して」の場合は両方のフィールドが存在しますが、「午後5時に始まるテレビ番組を見せて」の場合、設定されるのはstartフィールドだけで、endフィールドはnullになります。

startendの時間を含むオブジェクト
start
省略可能

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



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

ISO 8601形式の文字列
end
省略可能

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



例: 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" } ..], ```

マルチモーダルデバイスでは、追加のエンティティタイプとして、 LISTTYPESORTTYPEが用意されています。

LISTTYPEは、ユーザーがウォッチリストやライブラリの閲覧を希望した場合に設定されます。たとえば、「ウォッチリストを見せて」や「ビデオライブラリを見せて」といった発話が挙げられます。 LISTTYPEには、次の列挙値を設定できます。

  • WATCHLIST: 「ウォッチリストを見せて」 - ユーザーのウォッチリストに追加されているビデオを表示する際に使用します。
  • LIBRARY: 「ビデオライブラリを見せて」 - ユーザーのライブラリに存在するビデオを表示する際に使用します。通常、これにはユーザーが購入したビデオが該当します。

SORTTYPEは、検索時に使用するリクエストや、結果のソート方法に関して、追加情報を提供する際に使用されます。たとえば、「おすすめの映画を見せて」という発話の場合、Alexaはコンテンツプロバイダーからのおすすめコンテンツを取得する必要があります。SORTTYPEには、次の列挙値を設定できます。

  • RECOMMENDED: 「おすすめの映画を見せて」や「おすすめのアクション映画を見せて」といった発話の場合、この値が設定されます。

エクスペリエンスタイプ

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

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

  • VOICE_OPTIMIZED: 音声専用デバイス向けに最適化された表示方法です。リモコンを使用せずに音声で操作できる検索結果のリストが表示されます。

  • DEFAULT: 検索に使用されたデバイスに関係なく、すべての検索結果をリスト形式で表示する、デフォルトの表示方法です。

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

Lambdaのレスポンス

GetPlayableItemsディレクティブを受信したら、Lambdaはここで示す構造に準拠したGetPlayableItemsResponseレスポンスを返す必要があります。この場合のレスポンス構造は、GetDisplayableItemsディレクティブに対して返すレスポンスと同様です。

レスポンスについては、以下のガイドラインに従ってください。 

  • GetPlayableItemsディレクティブの目的は、そのディレクティブで再生できる単一のアイテムを取得することです。 

  • 再生するアイテムが1つしかない場合、そのアイテムを返せば、Alexaによってアイテムが再生されます。 

  • 再生するアイテムがはっきりしない場合は、レスポンスで複数のアイテムを返すことができます。Alexaは、その中から再生するアイテムを選択するようユーザーに促します。たとえば、ユーザーが「『スター・ウォーズ』を再生して」と言った場合、レスポンスで返すアイテムとしては、「スター・ウォーズ」シリーズの映画だけでなく、「スター・ウォーズ」に関連したさまざまな映画やテレビ番組が考えられます。複数の結果を返した場合、Alexaはメタデータを取得して検索結果を表示するためにGetDisplayableItemsMetadataディレクティブを送信します。1回目の呼び出しで返す結果の件数が、ディレクティブで指定されたresultLimitパラメーターの値を超えないように注意してください。

  • ユーザーにタイトルを再生する権限がないことや、定期購入が必要であることが原因で、見つかった唯一の結果が再生できない場合でも、そのアイテムを返すことができます。そのアイテムが再生できないとわかると、Alexaはメタデータを取得して、購入・レンタル・定期購入を促すプロンプトを提供します。その後、ユーザーは購入ワークフローを開始し、タイトルを購入・レンタルしてから再生することができます。

  • 再生できない結果が複数見つかった場合は、その結果をすべて返すことができます。Alexaは、再生するアイテムを選び出すようユーザーに求めるか、アイテムの購入・レンタル・定期購入を促すプロンプトを提供します。

  • 再生できるアイテムと再生できないアイテムとが混在する複数の結果が見つかった場合は、再生できるアイテムを優先する必要があります。デバイスで再生できるように、再生可能な結果を返すようにしてください。

レスポンスの例

GetPlayableItemsに対するLambdaからのレスポンスの例を次に示します。

{
    "event": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "5f0a0546-caad-416f-a617-80cf083a05cd",
            "name": "GetPlayableItemsResponse",
            "namespace": "Alexa.VideoContentProvider",
            "payloadVersion": "3"
        },
        "payload": {
            "nextToken": "fvkjbr20dvjbkwOpqStr",
            "mediaItems": [
                {
                    "mediaIdentifier": {
                        "id": "recordingId://provider1.dvr.rp.1234-2345-63434-asdf"
                    }
                },
                {
                    "mediaIdentifier": {
                        "id": "recordingId://provider1.dvr.rp.1234-2345-63434-asdf"
                    }
                }
            ]
        }
    }
}

ペイロードの説明

次の表は、GetPlayableItemsResponsepayloadフィールドについて説明しています。

ペイロードの説明
フィールド 説明 データ型
nextToken
省略可能

次の結果セットを取得するためのトークン。プロバイダーから送信される不透明型の文字列で、後続の検索リクエストで返されます。

文字列
mediaItems
(必須)

検索結果として画面に表示されるビデオのmediaIdentifierのリスト。

リスト
mediaIdentifier
(必須)

mediaItemの識別子。mediaIdentifierオブジェクトからの画像サイズデータの取得を参照してください。

オブジェクト
id
(必須)

ビデオアイテムの識別子。後続のGetDisplayableItemsMetadataまたはGetPlayableItemsMetadataの呼び出しで、表示または再生に関連したメタデータ情報を取得する目的で使用されます。この識別子は、Alexaからは認識できず、メタデータ情報を照会する際にそのまま使用されます。

文字列