as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
使用此页面诊断媒体应用中Vega媒体控制的问题,例如:
  • 遥控器上的快进和快退按钮没有响应。
  • Alexa语音命令被忽略或调用的处理程序与预期不同。
  • 拖动条与播放位置不匹配。
  • 媒体控制仅在某些时候起作用。

快速分类: 平台问题还是应用问题

在调查应用代码之前,请回答以下问题。 如果您对两个或更多问题回答“是”,则可能存在平台问题。请联系您的亚马逊代表或按照问题分类准则进行报告。否则,请继续查看此页面上的常见问题。

快进和快退按钮没有响应

症状
  • 遥控器上的快进和快退按钮没有响应。
  • 方向键左右仍会触发跳转。
  • 播放和暂停正常工作。
原因 您的应用未向Vega媒体控制注册,这通常是因为未设置W3C媒体集成。 解决方案
  1. 确保manifest.toml文件中的主要交互组件具有媒体类别并标识为接口提供方。有关完整清单,请参阅开始使用Vega媒体控制。
  2. 确保您的清单列出了您的应用支持的命令和功能。您的应用不会接收SkipForward和SkipBackward,除非它们出现在command_options中,也不会接收FastForward和Rewind,除非VariableSpeed出现在features中。
  3. 按照W3C媒体与Vega媒体控制集成中所述,在开始播放之前在播放器上调用setMediaControlFocus。
  4. 通过运行注册检查来确认您的应用已注册。

媒体控制仅在某些时候起作用

症状
  • 快进和快退有时起作用,但并非总是如此。
  • 重启应用后,控制开始起作用。
原因 应用调用setMediaControlFocus过晚,例如在播放已经开始之后,或者在组件实例可用之前。 解决方案 在组件实例可用后、播放开始之前调用setMediaControlFocus。
不要在开始播放的功能内设置焦点。

拖动条与播放位置不匹配

症状
  • 快进和快退都起作用,但拖动条无法移动。
  • 显示的位置偏离实际播放位置。
原因 您的应用自行处理媒体控制命令,但在更改播放位置后没有将新状态发布到Vega媒体控制。 解决方案 每次更改播放位置或状态后,更新会话状态并调用updateMediaSessionStates。以下示例扩展了开始使用Vega媒体控制中的MediaPlayerState模式。
在应用在处理程序之外更改位置的任何位置都应用相同的模式,例如从自己的用户界面中进行跳转。

Alexa语音命令调用的处理程序与预期不同

症状
  • 说“Alexa,停止”会暂停播放,而不是调用handleStop。
  • “Alexa,快进”会跳转,而是调用handleFastForward。
原因 Alexa将一些传输控制话音转换为与其名称所表示的不同的Vega媒体控制命令。 解决方案 实现下表中的处理程序。它们才是Alexa实际调用的对象。

诊断工具

这些检查使用Vega媒体控制客户端API像系统一样查看您的应用。在应用的测试版本中运行这些检查。有关客户端API的更多信息,请参阅适用于媒体控制客户端应用。

检查您的应用是否已注册

端点定位器会返回媒体应用的排名列表。第一个条目通常是当前具有焦点的应用。
如果您的应用的软件包ID不在列表中,请检查您的清单和setMediaControlFocus调用。

测试命令路由

向对焦应用发送命令,并确认您的处理程序已收到这些命令。

最小可运行实现

以下示例是接收远程和Alexa媒体命令的最小W3C媒体集成。
您的package.json文件必须包含以下依赖项。

相关主题

最后修改于 2026年10月13日