开发者控制台

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

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

当用户说出诸如“Search for [X]]”(搜索 [X])之类的表述时,Alexa.RemoteVideoPlayer接口会向您的应用或Lambda发送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
可选
为客户想要播放的内容提供时间窗口。例如,如果客户想播放上周的剧集,则时间窗口将显示前一周。

包含startend时间的对象。
end
可选

时间窗口的结束时间。



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

ISO 8601格式的字符串。
start
可选

时间窗口的开始时间。



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

ISO 8601格式的字符串。

实体类型

entities对象由一个对象列表组成,每个对象都包含一个type和一个值,以及其他可能的数据,例如外部ID。type值可能包括以下值: ActorAppChannelCharacterDirectorEpisodeEventFranchiseGenreLeagueMediaTypeProductionCompanySeasonSportSportsTeamVideoPopularityRecencyVideoResolution。以下各部分提供了有关每种实体类型的有效负载的详细信息。

Actor

Actor代表视频媒体内容中的演员;例如,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电影),它将搜索MediaTypeMOVIE值的所有“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 媒体类型;可能的值为MOVIEVIDEOTV_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 指明用户搜索的是新内容还是旧内容;可能的值为NEWOLD 枚举 NEW
请注意,此实体类型不包含任何“externalIds”。示例响应(仅摘自相关值)可能如下所示:``json "entities": [..{ "value": "NEW", "type": "Recency" } ..], ```

VideoResolution

VideoResolution代表以下标准之一中要求的视频分辨率:

  • SD (480p)
  • HD (720p-1080p)
  • 4k (2160p)
  • 8k (4320p)
VideoResolution有效负载字段 描述 类型 示例
value 视频分辨率;可能的值为SDHD4k8k 枚举 HD
请注意,此实体类型不包含任何“externalIds”。示例响应(仅摘自相关值)可能如下所示:``json "entities": [..{ "value": "4k", "type": "VideoResolution" } ..], ```

体验类型

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

experience对象由一个mode对象组成,后者决定如何显示搜索结果。mode对象采用两个值: VOICE_OPTIMIZEDDEFAULT

  • 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日