GetPlayableItems指令 (VSK Echo Show)

警告： 不会将新的合作伙伴引入视频技能工具包 (VSK)。如果对现有集成有疑问，请联系您的亚马逊技术客户经理。

当用户使用VideoName、ActorName或GenreName等条件要求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负责解析用户的表述并确定意图，然后Alexa将其打包成GetPlayableItems指令。但是，可能不清楚用户想要播放什么，因此Alexa会向您发送所请求的内容，以便您可以查找要播放的项目。

您的Lambda发送的响应中应包含有关可播放内容的基本识别信息。根据您的响应，Alexa会执行以下操作：

如果您的Lambda在响应中只返回“一个项目”，Alexa会发送GetPlayableItemsMetadata指令来启动播放。
如果您的Lambda在响应中返回“多个项目”，Alexa会发送GetDisplayableItemsMetadata指令来显示搜索结果。

GetPlayableItems指令与GetDisplayableItems相同，但header名称除外。当用户要求在设备上播放内容时，使用GetPlayableItems指令。为播放和搜索设置单独的指令可以提高用户意图的透明度。

以下一般指南显示了如何在不同场景中执行搜索：

视频名称
流派/演员

视频名称：例如“Play Interstellar”（播放Interstellar）。

当用户在表述中包含视频名称（“Play Interstellar”（播放Interstellar））时，Alexa会发送GetPlayableItems指令，其中包含在您目录中找到的所有相关视频名称，目录ID包含在externalIds字段中。您应该根据发送给您的ID和videoNames来优先选择内容，选择可以播放的项目，然后返回该项目。

提示： 如果Alexa从您的目录中找到了匹配的作品，则您应当无需再进行一次搜索。您可以使用指令中发送给您的信息来选择正确的视频。

流派/演员：例如，“Play a comedy movie”（播放喜剧片）或“Play an action movie with Tom Cruise”（播放Tom Cruise演出的动作片）

在视频名称不存在但存在其他方面匹配的项（例如流派和/或演员）的情况下，Alexa会发送GetPlayableItems指令。在这些情况下，您应该使用指令中发送的实体进行搜索。

例如，对于像“Play an action movie”（播放动作片）这样的表述，您会收到{mediaType: MOVIE, genreName: COMEDY}（在GetPlayableItems指令中）。您可以根据此信息进行搜索并返回喜剧电影的标识符。

与之类似，对于像“Play an action movie with Tom Cruise”（播放Tom Cruise演出的动作片）这样的表述，您会收到{mediaType: MOVIE, genreName: ACTION, actorName: Tom Cruise}（在GetPlayableItems指令中）。您可以搜索并返回符合此条件的电影的标识符。

当您在响应中返回标识符后，Alexa会发送GetPlayableItemsMetadata指令来获取更多元数据。

GetPlayableItems示例

以下是GetPlayableItems指令示例。在此示例中，媒体标题 (Manchester by the Sea) 由用户明确标识。

{
    "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": "Manchester by the Sea",
                    "externalIds": {
                        "imdb": "tt4574334"
                    }
                }
            ],
            "contentType": "RECORDING",
            "locale": "en-US",
            "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 = "Comedy," actorName ="Tom Hanks"}`，则意味着搜索结果应包含Tom Hanks演出的喜剧电影/电视节目。但是，如果请求包含多个相同类型的实体，例如`{videoName = "Interstellar," VideoName = "Interstellar Wars"}`，则可以将其视为OR运算，并且可以搜索指令中的所有实体。如果有疑问，请假设该类型中的顶部实体（在本例中为`videoName`）最为相关。假设您还有另一个请求，其中包含`{mediaType = "MOVIE', genreName = "Comedy," actorName ="Tom Hanks," actorName = "Tom Hanks}`。对此假设有多个演员名叫Tom Hanks。在这种情况下，您可以搜索包含请求中所有演员的电影，然后根据喜剧类型进行筛选以返回所有搜索结果。 Alexa现在不对实体进行排名，因为当有多个匹配的实体时，Alexa无法知道用户想要播放的是什么。 `entities` with a `type: Channel`）包含电视频道的识别数据。例如： { "type": "Channel", "value": "PBS", "externalIds": { "imdb": "tt4574334" }, "entityMetadata": { "channelCallSign": "KBTC", "channelNumber": "123" } }	列表
`type` 必需	视频内容的实体类型。有关视频内容实体类型的列表，请参阅实体类型。示例： `MediaType`、`video`、`Actor`、`Genre`、`Franchise`、`Season`、`Episode`	字符串
`value` 必需	实体的值。对于频道，为频道的名称。示例： `Interstellar`, `PBS`	字符串
`externalIds` 可选	此实体的外部标识符映射；`key`是提供方，`value`是`id`。示例：`key` = `gti`、`value` = `SH000000012`	对象
可选
`contentType` 可选	`ContentType`指定要搜索的内容类别。请注意，这与`entities`中的`MediaType`不同。`MediaType`指定要搜索的媒体类型，例如电影或电视节目等。因此，如果用户有兴趣浏览录制的电影，他们会说“Show me recorded movies”（显示录制的电影）之类的话。在这种情况下，mediaType将设置为`MOVIE`，而contentType将设置为`RECORDING`。与之相似，当用户想要浏览直播TV内容时，他们会说“Show me whats on now”（显示当前热映）之类的话，在这种情况下，contentType将设置为`LIVE`。示例： `RECORDING`、`LIVE`、`ON_DEMAND`	枚举
`locale` 必需	用户的区域设置，应当用于获取搜索结果的可显示信息。格式与网络工作组当前最佳实践47(BCP-47) 中为语言指定的格式相同的区域设置。如果您收到无法识别的区域设置，则默认设置为`en-US`。示例：`en-US`、`en-GB`、`de-DE`	字符串
`minResultLimit` 必需	此调用中要返回的最小结果数，对于此调用已接受`pageToken`。如果您返回的值小于`minResultLimit`字段并附带`pageToken`来获取更多结果，那么Alexa不会考虑使用`pageToken`来获取新项目，而只会显示Alexa收到的所有内容。要考虑使用`pageToken`来获取更多结果，项目数量必须至少与`minResultLimit`中的值相匹配。但是，项目数量可以大于`minResultLimit`，最大值为`maxResultLimit`。如果项目数量大于`maxResultLimit`，Alexa会在达到`maxResultLimit`之后废弃这些项目。示例： `8`	整数
`maxResultLimit` 必需	对要返回的最大结果数的限制。有关更多详细信息，请参阅`minResultLimit`字段的描述。示例： `25`	整数
`timeWindow` 可选	提供请求应采用的开始和结束时间。这通常仅用于直播TV或录像，不用于点播内容。通常，如果时间窗口可用并且可以用来筛选结果，就应当使用它。对于仅搜索点播内容的提供方，时间窗口字段通常设置为空且可以忽略。对于直播TV或录像，如果用户指定时间窗口，例如“Search for TV shows between 4 and 5 pm”（搜索下午4点到5点之间的电视节目）或“Find TV shows recorded last week”（查找上周录制的电视节目），则应根据开始和结束时间（如果有）筛选结果。根据功能的不同，可以同时存在`start`和`end`两个字段，也可以存在其中任何一个字段。例如，对于“Search for TV shows between 4 and 5 pm”（搜索下午4点到5点之间的电视节目），这两个字段都存在。对于“Show me TV shows starting at 5 pm”（播放下午5点开始的电视节目），只需填写`start`字段，而将`end`留空。	包含`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代表视频媒体内容中的演员；例如，Casey Affleck可能包含以下项：

Actor有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `ASIN`	该实体的外部ASIN	字符串	`B01LTHZVKG`
└─ `imdb`	演员的IMDB标识符。	字符串	`tt4034228`
`uri`	映射到演员/女演员的URI	URI	`entity://provider/actor/caseyaffleck`
`value`	演员的姓名	字符串	`Casey Affleck`

应用

App代表用户在口头上指定的明确应用名称；例如，“Manchester by the Sea on Prime”（Prime上的Manchester by the Sea）可能包含以下项：

App有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `ENTITY_ID`	应用列表中的应用标识符。	字符串	`amzn1.alexa-ask-target.app.72095`
`value`	应用程序的名称	字符串	`Prime Video`

频道

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)	字符串	`B00DT55P3K`
└─ `imdb`	角色的IMDB标识符。	字符串	`character id`
`uri`	映射到角色的URI	URI	`entity://provider/character/snowwhite`
`value`	角色的名称	字符串	`Snow White`

Director

Director代表视频媒体内容的导演姓名；例如，“Kenneth Lonergan”可能包含以下项：

Director有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	外部IMDB标识符	字符串	`tt4034228`
`uri`	映射到导演的URI	URI	`entity://provider/director/kennethlonergan`
`value`	导演的姓名	字符串	`Kenneth Lonergan`

Episode

Episode代表电视节目等连续内容的剧集编号；例如，Transparent的第八集的剧集编号为8。

Episode有效负载字段	描述	类型	示例
`value`	剧集编号	整数	`8`

Event

Event是指一种事件；示例包括体育运动、音乐或其他类型的事件。例如，搜索“Football games”（橄榄球比赛）将搜索game事件实体和football体育运动实体。

Event有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	事件的IMDB标识符。	字符串	`tt4034228`
`uri`	映射到事件的URI	URI	`entity://amazon/events/games`
`value`	事件类型的名称	字符串	`Games`

Franchise

Franchise是一个视频实体，可以代表许多视频实体，例如电影或电视节目。例如，以虚构系列片“Intergalactic Wars”为例，它代表了电影三部曲以及动画和真人电视节目的集合。引入这种实体类型是为了考虑客户的请求，例如“Find Intergalactic Wars movies”（查找Intergalactic Wars电影），它将搜索MediaType的MOVIE值的所有“Intergalactic Wars”节目，而不是尝试与单个标题进行匹配。

Franchise有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	外部IMDB标识符	字符串	`tt4034228`
`uri`	映射到系列片的URI	映射到事件的URI	`entity://amazon/franchise/intergalacticwars`
`value`	类型的名称	字符串	`Intergalactic Wars`

Genre

Genre代表视频媒体内容的类型，例如动作、戏剧或喜剧。例如，Action类型可能包含以下项：

Genre有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	外部IMDB标识符	字符串	`tt4034228`
`uri`	映射到类型的URI	URI	`entity://provider/genre/action`
`value`	类型的名称	字符串	`Action`

League

League代表体育运动联赛的分类信息；例如，NCAA是一个可能包含以下项的联赛：

League有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	联赛的IMDB标识符	字符串	`tt4034228`
`uri`	映射到联赛的URI	URI	`entity://amazon/league/ncaa`
`value`	联赛的名称	字符串	`NCAA`

MediaType

MediaType代表特定内容片段的媒体类型类别；例如，“Manchester by the Sea”的MediaType应为MOVIE。

MediaType有效负载字段	描述	类型	示例
`value`	媒体类型；可能的值为`MOVIE`、`VIDEO`、`TV_SHOW`	枚举	`MOVIE`

ProductionCompany

ProductionCompany代表视频媒体内容的制作公司名称；例如Marvels、Disney。

ProductionCompany有效负载字段	描述	类型	示例
`value`	制作公司名称	字符串	`Marvel`

Season

Season代表电视节目等系列内容的季编号；例如，“Transparent”第二季的季编号应为2。

Season有效负载字段	描述	类型	示例
`value`	季编号	整数	`2`

Sport

Sport代表一项体育运动的分类信息；例如，橄榄球是一项可能包含以下项的体育运动：

Sport有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	体育运动的IMDB标识符	字符串	`tt4034228`
`uri`	映射到体育运动的URI	URI	`entity://amazon/sport/football`
`value`	体育运动的名称	字符串	`Football`

SportsTeam

SportsTeam代表职业运动队的分类信息；例如，“University of Washington Huskies”是一支可能包含以下项的运动队：

SportsTeam有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
└─ `imdb`	该运动队的IMDB标识符。	字符串	`tt4034228`
`uri`	映射到运动队的URI	URI	`entity://amazon/sportsteam/huskies`
`value`	运动队的名称	字符串	`University of Washington Huskies`

Video

Video代表视频内容片段的识别数据；例如，“Manchester by the Sea”可能包含以下项：

Video有效负载字段	描述	类型	示例
`externalIds`	该实体的外部标识符映射。键是提供方，值是ID。	对象	—
`ASIN`	该实体的外部ASIN	字符串	`B01LTHZVKG`
└─ `imdb`	IMDB标识符	字符串	`tt4034228`
`userConfirmations`	包含有关商品的用户确认信息的对象	对象
└─ `entitlementVoiceActivation`	通知合作伙伴观看期限或权利的语音启用是否成功的标记。可能的值 - `CONFIRMED`（可选）。	枚举；默认策略 - 忽略无法识别的值	`CONFIRMED`
`uri`	映射到视频的URI	URI	`entity://provider/movie/manchesterbythesea`
`value`	视频的名称	字符串	`Manchester by the Sea`

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。例如，诸如“Show me my Watchlist”（显示我的播放列表）或“Show me my Video Library”（显示我的视频库）之类的表述。 LISTTYPE可以有以下枚举值：

WATCHLIST：针对“Show me my Watchlist”（显示我的播放列表）- 用于显示用户添加到播放列表中的视频。
LIBRARY：针对“Show me my Video Library”（显示我的视频库）- 用于显示用户库中的视频。通常，这些是用户购买的视频。

SORTTYPE用于提供有关搜索期间应使用的请求以及需要如何对结果进行排序的更多信息。例如，对于“Show me recommended movies”（显示推荐的电影），Alexa需要内容提供方的推荐。SORTTYPE可以有以下枚举值：

RECOMMENDED：此值是为诸如“Show me recommended movies”（显示推荐的电影）或“Show me recommended action movies”（显示推荐的动作电影）等表述填充的。

体验类型

使用experience对象根据用于执行搜索的设备优化搜索结果的显示。例如，如果客户通过Fire TV遥控器进行搜索，则experience对象会显示大量的搜索结果，客户可以使用遥控器浏览这些结果。但是，如果搜索请求来自与Fire TV配对的Echo，则experience对象会限制显示的结果数量及其显示方式，从而让客户可以无需使用遥控器即可查看结果。

experience对象由一个mode对象组成，后者决定如何显示搜索结果。mode对象采用两个值： VOICE_OPTIMIZED and DEFAULT.

VOICE_OPTIMIZED: 针对纯语音设备的搜索结果优化的显示。提供结果列表，客户无需遥控器即可通过语音浏览这些结果。
DEFAULT: 所有搜索结果列表格式的默认显示，无论使用哪种设备进行搜索。

为确保向前兼容性，如果在mode中收到未知值，可回退到DEFAULT，而不是遭遇失败。

Lambda响应

收到GetPlayableItems指令后，您的Lambda必须返回一个遵循此处结构的GetPlayableItemsResponse响应。本例中的响应结构类似于为GetDisplayableItems指令返回的响应。

请在响应中遵循以下指导准则：

请记住，GetPlayableItems指令的目标是获得一个可以为指令播放的项目。
如果只有一个项目可以播放，您可以仅返回该项目，Alexa将播放该项目。
如果不清楚该播放哪个项目，您可以选择在响应中返回多个项目。Alexa会要求用户选择要播放的项目。例如，如果用户说“Play Star Wars”（播放Star Wars），则响应中可能会返回Star Wars系列片中的多部电影，或者多部与Star Wars相关的电影和电视节目。如果您返回多个结果，Alexa会发送GetDisplayableItemsMetadata指令来获取元数据并显示搜索结果。请注意，第一次调用中返回的结果数不应超过指令中指定的resultLimit参数。
如果由于用户无权播放作品或需要订阅而导致所找到的唯一结果无法播放，则可以返回该项目。一旦Alexa发现此项目不可播放，Alexa会获取元数据并显示购买、租借或订阅提示。之后，用户可以触发购买工作流程来购买/租借作品，然后再播放它。
如果发现多个无法播放的结果，您可以选择返回所有结果，Alexa要么通过用户消除要播放哪个项目的歧义，要么显示购买、租借或订阅项目的提示。
如果找到多个结果，其中一些可以播放，而有些则不能播放，那么您应该选择可播放的结果并返回可播放的结果，这样就可以在设备上播放相应项目。

响应示例

以下是您的Lambda对GetPlayableItems的响应示例：

{
    "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` 必需	屏幕上显示为搜索结果的视频的`mediaIdentifiers`列表。	列表
`mediaIdentifier` 必需	`mediaItem`的标识符。请参阅从mediaIdentifier对象检索图像大小数据。	对象
`id` 必需	视频项目的标识符，用于在后续调用`GetDisplayableItemsMetadata`或`GetPlayableItemsMetadata`时获取任何与显示或播放相关的元数据信息。此标识符对于Alexa不透明，仅在查询元数据信息时按原样使用。	字符串

Last updated: 2020年11月2日