Alexa.RemoteVideoPlayer接口： SearchAndDisplayResults (VSK Fire TV)

当用户说出诸如“Search for [X]]”（搜索 [X]）之类的表述时，Alexa.RemoteVideoPlayer接口会向您的应用或Lambda发送SearchAndDisplayResults指令。对于此指令，您的应用的逻辑应将用户引导至搜索结果页面，而不是直接进入媒体播放。

SearchAndDisplayResults指令的表述
SearchAndDisplayResults指令示例
有效载荷定义
- 实体类型
- 体验类型
处理SearchAndDisplayResults指令
响应示例
声明此接口的功能支持

SearchAndDisplayResults指令的表述

当用户说出以下表述时，Alexa会向您的应用（用于仅限应用的集成）或您的Lambda（用于云端集成）发送SearchAndDisplayResults指令。

功能	表述示例	预期回应
搜索 [标题] 需要认证	Search for breaking bad	向用户显示标题的匹配项列表。
按演员搜索需要认证	Search for sean connery	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	Search for comedy	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	Search for star trek	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	Search movies	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	Search breaking bad season two	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	Search for breaking bad episode five	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	Search for breaking bad season two episode five	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	Search for james bond	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	Search for quentin tarantino	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	Search for disney	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	Search seahawks	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	Search for soccer	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	Search for n. b. a. league	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	Search for soccer game	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	Launch netflix app	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	Launch a. t. and t. u-verse app	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	trouve / cherche / montre [VideoName] sur [AppName]	向用户显示标题的匹配项列表。
按演员搜索需要认证	recherche des films avec [ActorName] cherche des films avec [ActorName]	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	recherche un/une [GenreName] cherche un/une [GenreName]	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	recherche [VideoName] cherche [VideoName]	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	recherche [mediatype] cherche [mediatype]	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	recherche la saison [number] de [title] cherche la saison [number] de [title]	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	recherche la saison [number] de [title] cherche la saison [number] de [title]	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	recherche/cherche la saison [SeasonNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName] recherche/cherchela saison [SeasonNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de [VideoName] recherche/cherchel'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName]	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	recherche un film avec [charactername] cherche un film avec [charactername]	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	recherche un film de [DirectorName] cherche un film de [DirectorName]	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	recherche des films de disney cherche des films de disney	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	Not supported	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	Not supported	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	recherche [league] cherche [league]	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	Not supported	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	pars [AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	pars [AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	trouve / cherche / montre [VideoName] sur [AppName]	向用户显示标题的匹配项列表。
按演员搜索需要认证	cherche des films avec [ActorName]	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	cherche une comédie	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	cherche star trek	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	Cherche [mediatype]	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	cherche la saison [number] de [title]	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	cherche l'épisode [number] de [title]	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	cherche la saison [SeasonNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName] cherche la saison [SeasonNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de [VideoName] cherche l'épisode [EpisodeNumber] de la saison [SeasonNumber] de [VideoName]	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	cherche un film avec [charactername]	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	cherche un film de quentin tarantino	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	cherche des films de disney	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	Not supported	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	Not supported	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	cherche [league]	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	Not supported	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	lance [AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	lance [AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	such nach? [VideoName] such/zeig/find film? [VideoName] auf [AppName] zeig mir film? [VideoName] auf [DeviceBrand] such trailer von [VideoName]	向用户显示标题的匹配项列表。
按演员搜索需要认证	such [ActorNameName] filme zeig filme mit [ActorNameName]	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	zeig [GenreNameName] filme auf [AppName] such nach [GenreName] [MediaType]	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	such nach? [VideoName] such/zeig/find film? [VideoName] auf [AppName] zeig mir film? [VideoName] auf [DeviceBrand] such trailer von [VideoName]	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	find [MediaType] such/zeig/empfiehl [MediaType]	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	spiel [VideoName] [Season] [Season_Numer] spiel [VideoName] [Season] [Season_Numer] auf [AppName]	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	spiel die [Episode_Number] [Episode] von [VideoName] spiel [VideoName] [Episode_Number] spiel von [VideoName] [Episode] [Episode_Number]	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	spiel [Season] [Season_Numer] [Episode] [Episode_Number] von [VideoName] spiel [VideoName] [Season] [Season_Numer] [Episode] [Episode_Number] spiel die [VideoName] [Season] [Season_Numer] [Episode] [Episode_Number] auf [AppName] ab	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	Not supported	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	such nach [MediaType] mit [ActorName] such [ActorName] [MediaType] zeig [MediaType] mit [ActorName]	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	suche nach [ProductionCompany] filmenzeige mir [ProductionCompany] filme	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选		向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	such [Sport] [Event] find [Sport] [Event]	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	Not supported	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	such [Sport] [Event] find [Sport] [Event]	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	starte [AppName] spiel/öffne [AppName] app starte [AppName] auf [DeviceBrand]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	starte [AppName] spiel/öffne [AppName] app starte AppName auf [DeviceBrand]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	[VideoName] खोजो/ढूँढो [AppName] पे/पर/में [VideoName] दिखा/खोज दो मुझे [VideoName] दिखाओ/खोजो/ढूँढो मुझे [AppName] पे/पर/में [VideoName] दिखाओ/खोजो/ढूँढो मुझे [VideoName] को [AppName] पे पर में दिखाओ/खोजो/ढूँढो खोजो [VideoName]	向用户显示标题的匹配项列表。
按演员搜索需要认证	[ActorName] के/का/की/वाला movies दिखाओ/ढूँढो [ActorName] के/का/की/वाला [GenreName] movies दिखाओ/खोजो/ढूँढो [ActorName] के/का/की/वाला [GenreName] movie [VideoName] दिखाओ/खोजो/ढूँढो दिखाओ/खोजो [ActorName] के/का/की/वाला [GenreName] movies	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	[GenreName] movies दिखाओ/ढूँढो [ActorName] के/का/की/वाला [GenreName] movies दिखाओ/खोजो/ढूँढो	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	start trek के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	[VideoName] movie दिखाओ/ढूँढो [AppName] पे/पर/में [MediaType] को खोजो [ChannelName] को खोजो/ढूँढो	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	breaking bad season दो ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	breaking bad episode पाँच के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	breaking bad season दो episode five के लिये ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	[CharacterName] movie दिखाओ/खोजो [CharacterName] के/का/की/वाला movie [VideoName] दिखाओ/खोजो/ढूँढो	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	quentin tarantino के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	disney के लिए ढूँढ़ो/ढूँढ़ना/खोजो/खोजना/search करना	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो [Sport] के [Event] को दिखाओ/खोजो	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	[Sport/League/Seam] games दिखाओ/खोजो/ढूँढो [Sport] के [Event] को दिखाओ/खोजो	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	netflix launch करो/करना/कीजिए/करिएगा	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	facebook app launch करो/करना/कीजिए/करिएगा	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	trova / cerca / mostra / dammi + VideoName (+ da/su ServiceName)?	向用户显示标题的匹配项列表。
按演员搜索需要认证	cerca film con [ActorName] trova un film con [ActorName]	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	cerca [GenreName] trova [GenreName]	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	cerca [VideoName] trova [VideoName]	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	cerca [mediatype] trova mi un [mediatye]	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	cerca la stagione due di [VideoName] trova la stagione due di [VideoName]	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	cerca [VideoName] Episodio cinque trova [VideoName] Episodio cinque	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	cerca [VideoName] episodio [EpisodeNumber] trova [VideoName] episodio [EpisodeNumber] cerca [VideoName] stagione [SeasonNumber] trova [VideoName] stagione [SeasonNumber] cerca [VideoName] stagione [SeasonNumber] episodio [EpisodeNumber] trova [VideoName] stagione [SeasonNumber] episodio [EpisodeNumber]	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	cerca un film con [CharacterName] trova un film con [CharacterName]	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	cerca [DirectorName]	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	cerca disney	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	not supported	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	cerca [Sport] trova [Sport]	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	not supported	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	cerca partite di [SportName] trova partite di calcio	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	lancia [AppName] apri [AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	apri [special character AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	[VideoName]を探して[VideoName]を＜AppName]で探して	向用户显示标题的匹配项列表。
按演员搜索需要认证	[ActorNameName]が出ている[MediaType]を探して	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	[GenreNameName]の[MediaType]を見つけて	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证		向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	[MediaType]を探して [AppName]で[MediaType]を探して [ChannelName]を検索	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选		向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选		显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	[title] シーズン[SeasonNumber] エピソード[EpisodeNumber] を探して	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	[CharacterNameName]が主人公の[MediaType]を探して	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选		向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	[ProductionCompany]を検索	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	[Sport]の[Event]を見つけて[SportTeam]の[Event]を見つけて	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证		请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证		请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	procurar/buscar/mostrar [VideoName] no/na [AppName]	向用户显示标题的匹配项列表。
按演员搜索需要认证	procurar por [ActorName]	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	procurar por [GenreName]	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	procurar[VideoName]	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	procurar [MediaType]	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	procurar [VideoName] temporada [SeasonNumber]	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	procurar por [title] episódio [EpisodeNumber]	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	procurar por [VideoName]episódio [EpisodeNumber]procurar por [VideoName]temporada [SeasonNumber]procurar por [VideoNumber]temporada	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	not supported	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	not supported	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	Procurar/procura/procure por [ProductionCompany]	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	procurar por[SportTeam]	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	procurar por [Sport]	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	procurar por [League]	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	procurar por [SportName]	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	abrir [AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	abrir [special character AppName]	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

功能	表述示例	预期回应
搜索 [标题] 需要认证	muestra juego de tronos enséña me el efecto mariposa	向用户显示标题的匹配项列表。
按演员搜索需要认证	busca películas con antonio banderas	向用户显示以演员为特征的匹配项列表。
按流派名称搜索需要认证	busca comedias románticas	向用户显示所请求类型的媒体的匹配结果列表（通过为用户选择推荐媒体的算法进行个性化）。
按系列片搜索 [标题] 需要认证	busca shrek	向用户显示系列片的匹配结果列表。
按媒体类型搜索可选	busca películas enséña me las películas busca películas en netflix	向用户显示所需媒体类型的匹配项列表。
使用季编号搜索 [标题] 可选	enséña me la segunda temporada de friends	向用户显示匹配季的所有剧集。
按剧集编号搜索 [标题] 可选	busca el capítulo final de los serrano^*	显示用户最近观看的季中已上线剧集的列表。例如，如果用户的观看进度在第2季内，则会显示第2季的剧集列表。
通过季和剧集编号搜索 [标题] 可选	busca el segundo episodio de la primera temporada de anabel^*	显示用户请求的季的已上线剧集列表，包括用户特别要求的剧集。
按角色姓名搜索可选	busca películas de la pantera negra	向用户显示以角色姓名为特征的媒体的匹配结果列表。
按导演姓名搜索可选	busca las películas de alejandro lozano	向用户显示由所请求的导演制作的媒体的匹配结果列表。
按制作公司搜索可选	busca películas de disney	向用户显示制作公司出品的媒体的匹配结果列表。
按运动队搜索可选	busca el partido del real madrid	向用户显示运动队的匹配结果列表。
按体育运动类型搜索可选	enséña nos un vídeo de fútbol	向用户显示体育运动类型的匹配结果列表（优先基于对用户的推荐）。
按体育联赛搜索可选	busca el partido de la n. b. a.	向用户显示体育联赛的匹配结果列表（优先基于对用户的推荐）。
按体育赛事搜索可选	busca el partido de fútbol	向用户显示体育赛事的匹配结果列表（优先基于对用户的推荐）。
启动 [合作伙伴] 应用需要认证	lanza la app de netflix lanza netflix	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。
启动特殊角色标题需要认证	lanza i. b. e. x. treinta y cinco	请求的应用启动并显示可供播放的已上线媒体列表。多模式设备有一个主页模板，其中填写了可能分为不同类别的媒体。

SearchAndDisplayResults指令示例

以下是SearchAndDisplayResults指令示例。这是Alexa在回应用户搜索请求“Alexa, show me UW Husky games”（Alexa，播放UW Husky队比赛）时可能会发出的指令。

仅限应用的集成
云端集成

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

payload包含以下内容：

{
    "payload": {
        "experience": {
            "mode": "VOICE_OPTIMIZED",
             },
        "entities": [
            {
                    "externalIds": {
                        "key name": "event external id"
                    },
                    "type": "Event",
                    "uri": "entity://provider/event/games",
                    "value": "games"
                },
            {
                "externaIds": {
                    "key name": "sports team id"
                },
                "type": "SportsTeam",
                "uri": "entity://provider/sportsteam/someURI",
                "value": "UW Huskies"
            }
        ],
        "searchText": [
            {
                "transcribed": "UW Huskies games"
            }
        ],
        "timeWindow": {
            "end": "2016-09-07T23:59:00+00:00",
            "start": "2016-09-01T00:00:00+00:00"
        }
    }
}

{
    "directive": {
        "endpoint": {
            "cookie": {},
            "endpointId": "<目标终端的标识符>",
            "scope": {
                "token": "<OAuth2持有者令牌>",
                "type": "BearerToken"
            }
        },
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "5b77aa06-3bc6-4ab1-8e10-a7f41c208a0a",
            "name": "SearchAndDisplayResults",
            "namespace": "Alexa.RemoteVideoPlayer",
            "payloadVersion": "3"
        },
        "payload": {
            "experience": {
                "mode": "VOICE_OPTIMIZED",
                 },            
            "entities": [
                {
                    "externalIds": {
                        "key name": "event external id"
                    },
                    "type": "Event",
                    "uri": "entity://provider/event/games",
                    "value": "games"
                },
                {
                    "externaIds": {
                        "key name": "sports team id"
                    },
                    "type": "SportsTeam",
                    "uri": "entity://provider/sportsteam/someURI",
                    "value": "UW Huskies"
                }
            ],
            "searchText": [
                {
                    "transcribed": "UW Huskies games"
                }
            ],
            "timeWindow": {
                "end": "2016-09-07T23:59:00+00:00",
                "start": "2016-09-01T00:00:00+00:00"
            }
        }
    }
}

有效载荷定义

支持以下字段。
字段	描述	数据类型
`entities` 可选	要播放的实体对象数组，例如Title、Franchise、Actor、Team或MediaType。有关实体类型和值的更多详细信息，请参阅实体类型。	数组
`experience` 可选	优化搜索结果显示的对象。使用`experience`对象，您可以根据客户用来搜索的设备更改搜索结果。有关`experience`对象及其值的更多详细信息，请参阅体验类型。	包含`mode`的对象
`searchText` 可选	在`transcribed`字段中以字符串值的形式包含用户搜索查询的转录版本。有关详细信息，请参阅查看客户的实际请求。	包含`transcribe`的对象
`transcribed` 可选	提供用户表述的转录版本。有关详细信息，请参见searchText对象。示例：`高清热门喜剧电视节目`	字符串
`timeWindow` 可选	为客户想要播放的内容提供时间窗口。例如，如果客户想播放上周的剧集，则时间窗口将显示前一周。	包含`start`和`end`时间的对象。
`end` 可选	时间窗口的结束时间。示例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601格式的字符串。
`start` 可选	时间窗口的开始时间。示例： `2016-09-07T23:59:00+00:00`、`2018-01-24T02:30:00Z`	ISO 8601格式的字符串。

实体类型

entities对象由一个对象列表组成，每个对象都包含一个type和一个值，以及其他可能的数据，例如外部ID。type值可能包括以下值： Actor、App、Channel、Character、Director、Episode、Event、Franchise、Genre、League、MediaType、ProductionCompany、Season、Sport、SportsTeam、Video、Popularity、Recency和VideoResolution。以下各部分提供了有关每种实体类型的有效负载的详细信息。

Actor

Actor代表视频媒体内容中的演员；例如，Casey Affleck可能包含以下项：

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

App

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

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

体验类型

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

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

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

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

处理SearchAndDisplayResults指令

SearchAndDisplayResults指令包含搜索媒体然后以适合您的应用的方式显示搜索结果的指示。SearchAndDisplayResults指令包含一个实体数组，用于指定要搜索的内容。

（SearchAndDisplayResults指令与多模式实现视频技能中的GetDisplayableItems类似。）

以下各部分为处理不同类型请求的SearchAndDisplayResults指令提供了指导。

按标题搜索

使用与SearchAndPlay指令中按标题观看相同的逻辑，但显示用户搜索结果而不是进入播放状态。

按标题、剧集和季搜索

使用与SearchAndPlay指令中按标题、剧集和季观看相同的逻辑，但显示用户搜索结果而不是进入播放状态。

按系列片搜索

使用与SearchAndPlay指令中按系列片观看相同的逻辑，但显示用户搜索结果而不是进入播放状态。

按类型、体育运动、运动队、联赛和其他不明确的搜索指令进行搜索

使用与SearchAndPlay指令中按类型、体育运动、运动队、联赛和其他模糊播放指令观看相同的逻辑，但显示用户搜索结果而不是进入播放状态。

处理不明确的请求

使用与SearchAndPlay指令中处理模糊播放请求相同的逻辑，但显示用户搜索结果而不是进入播放状态。

图像

在您向用户呈现的结果列表中，纳入适用于标题的相关图像。图像应该让用户易于识别您在搜索中推荐的内容。

查看客户的实际请求

有关与searchText对象相关的说明和建议，请参阅查看客户的实际请求。

如果您的应用成功处理了该指令，则您的BroadcastReceiver类应连同成功状态将成功意图发回，如下所示：

if (response != null && sendResponse) {
  Intent success = new Intent().putExtra(VSKIntentConstants.EXTRA_DIRECTIVE_STATUS, didSucceed);
  try {
    response.send(context, 0, success);
  } catch(PendingIntent.CanceledException e) {
    //我们进行回复、记录错误可能花了太长时间
  }
}

有关更多详细信息，请参见步骤 7：添加广播接收器。另请参阅示例应用中的AlexaDirectiveReceiver类，以获取更具体的代码示例。

当SearchAndDisplayResults指令成功完成后，您的应用或Lambda应使用Alexa.Response消息进行响应。

{
    "context": {
        "properties": []
    },
    "event": {
        "header": {
            "correlationToken": "dFMb0z+PgpgdDmluhJ1LddFvSqZ/jCc8ptlAKulUj90jSqg==",
            "messageId": "1d8749ce-2805-4781-bb34-c5c59ce71f6a",
            "name": "Response",
            "namespace": "Alexa",
            "payloadVersion": "3"
        },
        "payload": {}
    }
}

不需要payload内容。借助Fire TV应用上的视频技能，返回到Alexa的响应很少，并且payload为空。这是因为您通过ADM向Fire TV应用发送了所需的指示。

如果您由于某种原因无法完成客户请求，可以用错误来回应。有关更多详细信息，请参阅错误处理。

声明此接口的功能支持

仅限应用的集成
云端集成

要从RemoteVideoPlayer接口接收针对您应用的SearchAndDisplay指令，必须在声明功能时指明支持此接口。有关通过仅限应用的集成声明功能的更多信息，请参阅以下内容：

要指明您的视频技能支持来自Alexa.RemoteVideoPlayer接口的SearchAndDisplayResults指令，您必须在响应通过Alexa.Discovery接口发送的Discover指令时指明支持该接口。Alexa.Discovery中提供了更多详细信息。

Last updated: 2021年6月9日