解决Fire TV Stick问题

本页面可帮助您解决使用Vega SDK进行开发时，遇到的特定于Fire TV Stick设备的常见问题。如果您在此处找不到特定问题的解决方案，请在开发者论坛中发布问题以获得更多支持。

进行无线 (OTA) 更新后，Fire TV Stick会不断重启

原因： 如果在使用KPI可视化工具时设置了不支持的开发者模式值，则会导致设备在进行OTA更新后进入死循环。

解决方案： 使用以下命令之一禁用开发者模式：

   kepler exec vda wait-for-device && kepler exec vda shell vsm developer-mode disable

或：

   kepler exec vda wait-for-device && kepler exec vda shell vdcm set com.amazon.devconf/system/security/developer_mode disable

运行命令后，设备应停止重启并正常运行。

通过计算机USB供电时，Fire TV Stick会重新启动

原因： 笔记本电脑USB端口供电不足。设备需要电流在5V的电压下高达1安培，但在播放高清/4K视频、音频内容或在Wi-Fi信号较弱的情况下运行等CPU使用率较高的场景中，许多笔记本电脑USB端口都无法提供1安培的电流。

解决方案： 使用以下选项之一：

选项1： 使用USB Y型电缆

使用USB Y型电缆连接Fire TV Stick，从笔记本电脑的USB端口和亚马逊提供的USB电源适配器中获取电源。

选项2： 使用带电的USB集线器

通过能够提供1安培或更高电流的独立供电的USB 3.0集线器来连接Fire TV Stick。

Fire TV Stick未收到OTA更新

原因： 设备可能未连接到Wi-Fi网络或需要触发手动更新操作。

解决方案：

1. 打开VDA shell：

   复制代码 已复制到剪贴板。

   kepler exec vda shell
   

2. 检查您设备的网络连接：

   复制代码 已复制到剪贴板。

   ace mw wifi_cli get_net_state
   

   该命令应返回networkState: CONNECTED。如果您的设备未连接，请参阅Fire TV Stick。

3. 强制手动更新：

   复制代码 已复制到剪贴板。

   kepler exec vda shell ace mw ota forceUpdate
   

OTA更新验证失败

原因： 需要确认更新是否成功完成以及是否与预期的SDK版本相匹配。

解决方案：

1. 查看设备的os-release版本：

   复制代码 已复制到剪贴板。

   kepler exec vda shell cat /etc/os-release | grep <版本号>
   

   将版本号替换为您的设备的发行版本号。

2. 验证返回的版本号是否与最新的SDK版本相匹配。

设备需要恢复出厂设置

原因： 设备需要完全恢复到原始状态，即移除Wi-Fi、远程配对和注册信息。

解决方案： 运行恢复出厂设置命令：

   kepler exec vda shell vfr reset --type shallow

终止设备上正在运行的应用

原因： 应用无响应、消耗过多资源或干扰了测试过程。

1. 打开VDA shell：

   复制代码 已复制到剪贴板。

   kepler exec vda shell
   

2. 列出运行的应用：

   复制代码 已复制到剪贴板。

   vlcm list
   

   示例输出：

   application type pid id state lifespan timeout container launch args
   com.amazondeveloper.keplersampleapp.main       S         2719    1     VISIBLE        PERMANENT      DEFAULT framework.slice/service                 <none>
   

3. 使用其程序包名称终止应用：

   示例：vlcm terminate-app --pkg-id com.amazondeveloper.keplersampleapp

从设备上卸载应用

原因： 出于测试或清理目的，需要删除应用。

解决方案： 运行卸载命令：

复制代码 已复制到剪贴板。

   vpm uninstall <程序包ID>

将 <程序包ID> 替换为应用的程序包ID（例如：com.foo.keplersampleapp）

在后台和前台之间移动应用

原因： 进行测试或调试需要在后台和前台之间更改应用的状态。

解决方案： 要将应用移至后台，请执行以下操作：

复制代码 已复制到剪贴板。

   vlcm trigger-app background --inst <实例ID>

将<实例ID>替换为您应用的实例ID。

要将应用移至前台，请执行以下操作：

复制代码 已复制到剪贴板。

   vlcm trigger-app foreground --inst <实例ID>

将<实例ID>替换为您应用的实例ID。

相关主题

• 在Fire TV Stick上运行您的应用

Last updated: 2025年9月30日