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 可选 |
时间窗口的结束时间。 示例: |
ISO 8601格式的字符串。 |
start 可选 |
时间窗口的开始时间。 示例: |
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 |
Recency
Recency
的解析值表示用户要求的是新内容还是旧内容。
Recency有效负载字段 | 描述 | 类型 | 示例 |
---|---|---|---|
value |
指明用户搜索的是新内容还是旧内容;可能的值为NEW 、OLD |
枚举 | NEW |
VideoResolution
VideoResolution
代表以下标准之一中要求的视频分辨率:
- SD (480p)
- HD (720p-1080p)
- 4k (2160p)
- 8k (4320p)
VideoResolution有效负载字段 | 描述 | 类型 | 示例 |
---|---|---|---|
value |
视频分辨率;可能的值为SD 、HD 、4k 、8k |
枚举 | HD |
体验类型
使用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日