内容启动器对目录和语音客户体验的认证
内容启动器对目录和语音客户体验的认证
    
    
    
 开放Beta测试文档 作为预发布开放Beta测试的一项内容,亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代,所描述的这些功能可能会发生变化。有关最新功能的信息,请参阅发行说明。
本页描述了适用于所有目录集成应用的认证测试案例。
通过遥控器启动内容的要求
从未验证身份状态更改为已验证身份状态
使用账户登录API通知Fire TV,应用处于登录状态。
预期结果:
- 登录后,应用应发送登录状态true,由此指明登录后的权利。
- 应用磁贴将列在内容详情页面的“Watch Now”(立即播放)下。
从已验证身份状态更改为未验证身份状态
使用账户登录API以通知Fire TV,应用处于注销状态。
预期结果:
- 注销后,您的应用应发送登录状态false。
- 应用磁贴将列在内容详情页面的“Subscribe”(订阅)下。
处理已验证身份状态下的播放
在用户登录后,让您的内容能够从Fire TV主屏幕启动。
预期结果:
- 您的应用列在Fire TV主屏幕内容详情页面的“Watch Now”或“Watch Free”(免费观看)下。
- 如果单击内容详细信息页面上的应用磁贴,应当启动您的应用并立即开始内容播放,无需用户在应用内重新进行身份验证或导航到内容详情页面。
处理未验证身份状态下的播放
如果用户已注销,则从Fire TV主页启动时,您的应用应显示登录或注销页面。
预期结果:
- 您的应用列在Fire TV主屏幕内容详情页面的Subscribe下。
- 单击Subscribe按钮时,应启动您的应用并显示注册或登录屏幕。
- 用户成功登录或订阅后,您的应用应开始播放所选内容,无需进一步导航。
观看表述的要求
在内容启动器API中实现观看或播放表述。
| 功能 | 表述示例 | 预期回应 | 
|---|---|---|
| 观看 [标题] | “Watch Breaking Bad”(观看Breaking Bad) | 播放请求的媒体类型。如果内容有多个匹配项,则系统会提示用户进行选择。 | 
| 按演员观看 | “Watch Sean Connery”(观看Sean Connery) | 播放有该演员参演的媒体(使用一种为用户选择最佳匹配项的算法)。 | 
| 按流派名称观看 | “Watch comedy”(观看喜剧) | 使用选择推荐媒体的算法播放所请求流派的媒体。另一种选择是向用户提供结果列表。 | 
| 按系列片 [标题] 观看 | “Watch Star Trek”(观看Star Trek) | 要么播放所请求系列片最为推荐的结果,要么向用户提供匹配的系列片列表。 | 
| 按媒体类型观看 | “Watch a movie”(观看电影) | 使用选择推荐媒体的算法播放匹配非标题请求的任一媒体。另一种选择是向用户提供结果列表。 | 
| 通过季编号观看 [标题] | “Watch Breaking Bad season two”(观看Breaking Bad第2季) | 除非已观看完剧集,否则将播放该系列中最后观看的剧集。如果已观看完该剧集,则播放下一集未观看的剧集。 | 
| 通过剧集编号观看 [标题] | “Watch Breaking Bad episode five”(观看Breaking Bad第5集) | 通过用户上次观看的剧集来识别正确的剧集。除非已观看完剧集,否则将播放该系列中最后观看的剧集。如果已观看完上次观看的剧集,则播放下一剧集。 | 
| 通过季和剧集编号观看 [标题] | “Watch Breaking Bad season two, episode five”(观看Breaking Bad第2季第5集) | 播放请求的季和剧集的内容。 | 
| 按角色姓名观看 | “Watch James Bond”(观看James Bond) | 通过选择推荐媒体的算法播放任一与角色名称相匹配的媒体。另一种选择是向用户提供媒体结果列表。 | 
| 按运动队观看 | Watch seahawks(观看海鹰队) | 通过选择推荐媒体的算法播放任一与球队相匹配的媒体。另一种选择是向用户提供媒体结果列表。 | 
| 按体育运动类型观看 | “Watch soccer”(观看足球) | 通过选择推荐媒体的算法播放任一与体育运动类型相匹配的媒体。另一种选择是向用户提供结果列表。 | 
| 按体育联赛观看 | “Watch N. B. A. league”(观看N.B.A.联赛) | 通过选择推荐媒体的算法播放任一与体育联赛相匹配的媒体。另一种选择是向用户提供结果列表。 | 
| 按体育赛事观看 | “Watch soccer game”(观看足球比赛) | 通过选择推荐媒体的算法播放任一与体育赛事相匹配的媒体。另一种选择是向用户提供结果列表。 | 
搜索表述的要求(应用内搜索)
通过实现内容启动器API来支持以下搜索/查找表述。
| 功能 | 表述示例 | 预期回应 | 
|---|---|---|
| 搜索 [标题] | “Search for Breaking Bad”(搜索Breaking Bad) | 向用户提供该标题的匹配项列表。 | 
| 按演员搜索 | “Search for Sean Connery”(搜索Sean Connery) | 向用户提供以该演员为特征的匹配项列表。 | 
| 按流派名称搜索 | “Search for comedy”(搜索喜剧) | 向用户提供其所请求流派媒体的匹配结果列表。这是通过选择推荐媒体的算法来进行个性化的。 | 
| 通过剧集编号搜索 [标题] | “Search for Breaking Bad episode five”(搜索Breaking Bad第5集) | 显示用户最近观看的季中已上线剧集的列表。例如,如果用户当前在观看第2季,则会显示第2季的剧集列表。 | 
| 通过季和剧集编号搜索 [标题] | “Search for Breaking Bad, season two, episode five”(搜索Breaking Bad第2季第5集) | 显示用户请求的季的已上线剧集列表,包括用户要求的剧集。 | 
| 通过季编号搜索 [标题] | “Search Breaking Bad, season two”(搜索Breaking Bad第2季) | 向用户显示匹配季的所有剧集。 | 
| 按系列片搜索 [标题] | “Watch Star Trek”(观看Star Trek) | 向用户提供系列片的匹配结果列表。 | 
| 按媒体类型搜索 | “Search for a movie”(搜索电影) | 向用户提供所需媒体类型的匹配项列表。 | 
| 按角色姓名搜索 | “Search for James Bond”(搜索James Bond) | 向用户提供以角色姓名为特征的媒体的匹配结果列表。 | 
| 按导演姓名搜索 | “Search for Quentin Tarantino”(搜索Quentin Tarantino) | 向用户提供该导演制作的媒体的匹配结果列表。 | 
| 按制作公司搜索 | “Search for Disney”(搜索Disney) | 向用户提供该制作公司所出品媒体的匹配结果列表。 | 
| 按运动队搜索 | “Search Seahawks”(搜索海鹰队) | 向用户提供该球队的匹配结果列表。 | 
| 按运动类型搜索 | “Search for soccer”(搜索足球) | 向用户提供该类型体育运动的匹配结果列表。理想情况下,它应该基于对该用户的推荐。 | 
| 按体育联赛搜索 | “Search for N. B. A. league”(观看N.B.A.联赛) | 向用户提供该体育联赛的匹配结果列表。理想情况下,该操作基于对该用户的推荐。 | 
| 按体育赛事搜索 | “Search for soccer game”(搜索足球比赛) | 向用户提供该体育赛事的匹配结果列表。理想情况下,该操作基于对该用户的推荐。 | 
传输控制表述的要求
Alexa支持以下传输控制表述。
| 功能 | 表述示例 | 预期回应 | 
|---|---|---|
| 暂停 | “Pause”(暂停) | 媒体暂停,类似于按下网络播放器或遥控器上的Pause按钮。 | 
| 播放 | “Play”(播放) | 媒体播放,类似于按下网络播放器或遥控器上的Play按钮。 | 
| 停止 | “Stop”(停止) | 媒体停止,类似于按下网络播放器或遥控器上的Stop按钮。 | 
| 继续 | “Resume”(继续) | 媒体恢复播放,类似于按下网络播放器或遥控器上的Play按钮。 | 
| 重新开始 | “Start over”(重新开始) | 媒体重新开始,将搜索位置调整回媒体的开头。 | 
| 快进 | “Fast Forward”(快进) | 媒体快进10秒。 | 
| 快退 | “Rewind”(快退) | 媒体倒回10秒。 | 
| 上一个 | “Previous”(上一个) | 播放上一剧集。如果这不适用,则将用户转到当前播放列表中更早的任何内容。 | 
| 下一个 | “Next”(下一个) | 播放下一剧集。如果这不适用,则将用户转到当前播放列表中接下来的任何内容。 | 
| 快进 [持续时间] | “Fast Forward thirty seconds”(快进三十秒) | 将媒体快进请求的持续时间。 | 
| 快退 [持续时间] | “Rewind forty seconds”(快退四十秒) | 将媒体倒回请求的持续时间。 | 
 注意: W3C媒体播放器API不支持“下一个”和“上一个”命令。可使用Vega媒体控制API来实现“下一个”和“上一个”命令。
                  
                  
                  
                  
                  
                  
                  
                   Last updated: 2025年9月30日

