GetPlayableItemsディレクティブ

GetPlayableItemsディレクティブ（VSK Echo Show）

警告： Video Skills Kit（VSK）のサポートは終了しました。既存の統合に関して質問がある場合は、Amazonのテクニカルアカウントマネージャーにお問い合わせください。

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

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

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

ヒント： AlexaのGetPlayableItemsディレクティブとGetPlayableItemsMetadataディレクティブがLambdaのコードとどのようにやり取りするかについては、手順3： AlexaディレクティブとLambdaのレスポンスを理解するを参照してください。

GetPlayableItemsの発話
GetPlayableItemsディレクティブの処理
GetPlayableItemsの例
ペイロードの説明
- エンティティタイプ
- エクスペリエンスタイプ
Lambdaのレスポンス
レスポンスの例
ペイロードの説明

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に基づいてコンテンツを選定し、再生できるアイテムを選択して返すようにしてください。

ヒント： Alexaによってカタログから一致するタイトルが見つかった場合は、改めて検索を行う必要はありません。ディレクティブで送信された情報を基に、適切なビデオを選択してください。

ジャンル／俳優（例：「コメディ映画を再生して」、「トム・クルーズのアクション映画を再生して」）

ビデオ名がなく、ジャンルや俳優といったその他のスロットがある場合は、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": {
                        "imdb": "tt4574334"
                    }
                }
            ],
            "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": { "imdb": "tt4574334" }, "entityMetadata": { "channelCallSign": "KBTC", "channelNumber": "123" } }	リスト
`type` （必須）	ビデオコンテンツのエンティティタイプ。ビデオコンテンツのエンティティタイプの一覧については、エンティティタイプを参照してください。例： `MediaType`、`video`、`Actor`、`Genre`、`Franchise`、`Season`、`Episode`	文字列
`value` （必須）	エンティティの値。チャンネルの場合は、チャンネル名。例： `インターステラー`、`PBS`	文字列
`externalIds` （省略可能）	このエンティティの外部識別子のマップ。`key`はプロバイダー、`value`は`id`です。例：`key` = `gti`、`value` = `SH000000012`	オブジェクト
（省略可能）
`contentType` （省略可能）	`contentType`は、検索するコンテンツのカテゴリーを指定します。エンティティの`MediaType`とは異なることに注意してください。`MediaType`では、検索するメディアのタイプ（映画、テレビ番組など）を指定します。そのため、録画した映画を閲覧する場合は、「録画した映画を見せて」などと発話します。このとき、mediaTypeは`MOVIE`に、contentTypeは`RECORDING`に設定されます。同様に、ライブTVのコンテンツを閲覧する場合は、「今放送中の番組を見せて」などと発話します。このとき、contentTypeは`LIVE`に設定されます。例： `RECORDING`、`LIVE`、`ON_DEMAND`	列挙型
`locale` （必須）	ユーザーのロケール。検索結果に対応する表示可能な情報を取得するために必要となります。ロケールの形式は、Network Working Groupの「Best Current Practice 47（BCP-47）」（英語のみ）で規定されている言語の形式と同じです。認識されないロケールを受信した場合は、デフォルトで`en-US`になります。例：`en-US`、`en-GB`、`de-DE`	文字列
`minResultLimit` （必須）	この呼び出しで返される結果で`pageToken`が必要となる最小件数。`pageToken`は次の結果を取得するためのもので、新しいアイテムを取得する際にこれと一緒に返されたアイテムの件数が`minResultLimit`フィールドよりも少ない場合、Alexaは`pageToken`を無視し、受信したアイテムをそのまま表示します。 `pageToken`を使用して次の結果を取得するのは、アイテムの件数が`minResultLimit`の値以上である場合のみです。ただし、アイテムの件数が`minResultLimit`を超える場合は、`maxResultLimit`が上限となります。アイテムの件数が`maxResultLimit`を超えると、`maxResultLimit`を超えたアイテムはAlexaによって破棄されます。例： `8`	整数
`maxResultLimit` （必須）	返される結果の最大件数（上限）。詳細については、`minResultLimit`フィールドの説明を参照してください。例： `25`	整数
`timeWindow` （省略可能）	リクエストされた処理の開始時刻と終了時刻を指定します。これは通常、ライブTVや録画にのみ使用され、オンデマンドコンテンツには使用されません。一般的に、タイムウィンドウが指定されており、それを使用して結果をフィルタリングできる場合は、タイムウィンドウを使用する必要があります。検索対象がオンデマンドコンテンツのみとなるプロバイダーの場合は、タイムウィンドウフィールドが通常nullに設定されているため、無視して構いません。ライブTVや録画でユーザーがタイムウィンドウを指定している場合（「午後4時から5時のテレビ番組を検索して」や「先週録画したテレビ番組を探して」など）、開始時刻と終了時刻が指定されていれば、それらを使用して結果をフィルタリングする必要があります。機能によって、`start`と`end`の両方のフィールドが存在する場合と、どちらか一方のフィールドしか存在しない場合とがあります。たとえば、「午後4時から5時のテレビ番組を検索して」の場合は両方のフィールドが存在しますが、「午後5時に始まるテレビ番組を見せて」の場合、設定されるのは`start`フィールドだけで、`end`フィールドはnullになります。	`start`と`end`の時間を含むオブジェクト
`start` （省略可能）	タイムウィンドウの開始時刻。例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601形式の文字列
`end` （省略可能）	タイムウィンドウの終了時刻。例： `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" } ..], ```

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

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

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

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

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

エクスペリエンスタイプ

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

experienceオブジェクトは、検索結果の表示方法を決定するmodeオブジェクトで構成されています。modeオブジェクトは、 VOICE_OPTIMIZEDとDEFAULTの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"
                    }
                }
            ]
        }
    }
}

ペイロードの説明

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

ペイロードの説明
フィールド	説明	データ型
`nextToken` （省略可能）	次の結果セットを取得するためのトークン。プロバイダーから送信される不透明型の文字列で、後続の検索リクエストで返されます。	文字列
`mediaItems` （必須）	検索結果として画面に表示されるビデオの`mediaIdentifier`のリスト。	リスト
`mediaIdentifier` （必須）	`mediaItem`の識別子。mediaIdentifierオブジェクトからの画像サイズデータの取得を参照してください。	オブジェクト
`id` （必須）	ビデオアイテムの識別子。後続の`GetDisplayableItemsMetadata`または`GetPlayableItemsMetadata`の呼び出しで、表示または再生に関連したメタデータ情報を取得する目的で使用されます。この識別子は、Alexaからは認識できず、メタデータ情報を照会する際にそのまま使用されます。	文字列