as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content

使用通用搜索启动器用户体验进行验证

您可以在Fire TV主屏幕中通过通用搜索来验证账户登录。

使用遥控器验证内容启动器集成

  1. 安装并登录应用。
  2. 在Fire TV主页屏幕上,搜索应用的内容
  3. 在内容详情页面上,选择Watch Now。
预期结果: 调用内容启动器处理程序后,您的应用应自动启动,所选内容应开始播放。

使用语音验证内容启动器集成

安装并登录应用。当应用在前台运行时,使用语音命令 (“Alexa…”) 播放应用中可用的内容。内容启动器处理程序会被调用,应用正确处理请求并开始播放所请求的内容。 表述示例:
  • “Watch <电影名称>”(观看<电影名称>)
  • “Watch <电视节目名称> with season <数字> and episode <数字>”(放<电视节目名称>第<数字>季第<数字>集)
  • “Watch comedy movies”(放喜剧电影)

使用KCP CLI验证账户登录集成

您还可以通过命令行验证您的账户登录集成。通过此方式来调试并确认您的应用正确报告其登录状态。

先决条件

  • 您已在Vega设备上启用开发者模式。有关说明,请参阅启用开发者模式。
  • 您的应用通过侧载安装,至少启动过一次,并且正在前台或后台运行。应用组件shell无法用于通过动态应用测试或通过亚马逊应用商店安装的应用。

进入组件shell

启用开发者模式后,进入组件shell并检查CLI。
CLI预装在/usr/bin/kcp-cli-v2,可通过组件shell访问。

读取账户登录状态

要从组件shell检查应用的登录状态,请运行以下命令。
例如:
预期输出:
如果值为true,则应用为SIGNED_IN。如果值为false,则应用为SIGNED_OUT。

订阅账户登录状态变更

要实时监控登录状态变更,请使用watch-status命令。
例如:
预期输出:
当状态发生变化时,输出流会更新。在此命令运行期间登录和退出您的应用,以验证状态转换。 要了解详细用法,请运行:

测试账户登录的CLI场景

  1. 验证SIGNED_IN: 登录您的应用,然后运行account-login read-status。状态应返回true。
  2. 验证SIGNED_OUT: 注销您的应用,然后运行account-login read-status。状态应返回false。
  3. 验证转换: 运行account-login watch-status,然后登录和退出您的应用。确认每次状态都会更新。

使用KCP CLI验证内容启动器集成

您可以使用KCP CLI工具在应用上调用内容启动器请求。这使您无需使用通用搜索、遥控器或语音命令即可测试启动请求。

先决条件

  • 您已在Vega设备上启用开发者模式。有关说明,请参阅启用开发者模式。
  • 您已安装应用并向KCP注册,且至少启动过一次。

添加内容搜索JSON

--content-search参数接受具有以下结构的JSON对象:

添加external_id_list字段

按标题启动电影

模拟: “Alexa, Watch <Movie Name>”(Alexa,观看<电影名称>)
预期结果: 您的应用应启动并开始播放所请求的电影。

启动特定季和剧集

模拟: “Alexa, Watch Season 1, Episode 3 in <Show Name>”(Alexa,观看<节目名称>的第1季第3集)
参数明细:

启动特定剧集(无季信息)

模拟: “Alexa, Watch Episode 3 in <Show Name>”(Alexa,观看<节目名称>的第3集)
预期结果: 您的应用应启动并开始播放所请求节目的第3集。

启动特定季

模拟: “Alexa, Watch Season 1 in <Show Name>”(Alexa,观看<节目名称>的第1季)
预期结果: 您的应用应启动并开始播放第1季(通常从第1集开始)。

搜索案例(目前仅支持特定应用)

搜索电影(不自动播放)

模拟: “Alexa, Search <Movie Name>”(Alexa,搜索<电影名称>)
预期结果: 您的应用应显示所请求内容的搜索结果。

按演员搜索

模拟: “Alexa, Find <Actor Name>”(Alexa,找<演员姓名>)
预期结果: 您的应用应显示与指定演员相关的内容。

按类型搜索

模拟: “Alexa, Find Comedy Movies”(Alexa,找喜剧电影)
预期结果: 您的应用应显示喜剧内容,或者如果指定了--auto-play,则开始播放。

内容搜索参数类型

使用内容搜索JSON中的param_type字段指定搜索类型:

内容启动器的CLI测试场景

  • 基本电影启动: 发送带有--auto-play的启动请求,使用已知电影名称和有效的external_id_list值。验证您的应用启动并开始播放。
  • 季和剧集启动: 发送带有季和剧集参数的启动请求。验证您的应用导航到正确的剧集。
  • 仅剧集启动: 发送仅包含剧集编号的启动请求。验证您的应用导航到正确的内容。
  • 搜索结果显示: 发送不带--auto-play的启动请求。验证您的应用显示相关的搜索结果。
  • 演员搜索: 发送带有param_type: 0和演员姓名的启动请求。验证您的应用显示该演员的内容。
  • 类型搜索: 发送带有param_type: 6和类型的启动请求。验证您的应用显示或播放该类型的内容。
  • 播放首选项: 发送带有--optional-fields并指定播放位置的启动请求。验证您的应用在正确的时间戳处恢复播放。
  • 未知内容处理: 发送针对您目录中不存在的内容的启动请求。验证您的应用能否妥善处理该请求。
要了解详细用法,请运行:

故障排除

最后修改于 2026年10月22日