内容启动器处理语音请求的最佳实践
内容启动器处理语音请求的最佳实践
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。
Fire TV客户可使用自然语言命令搜索和播放应用内容、控制媒体播放等等。内容启动器API使应用能够接收和处理Alexa命令。以下是处理Alexa语音以进行搜索和播放内容的最佳实践。
直接处理快速播放请求
语音断崖指的是一种语音体验，会导致用户需要拿起遥控器。对于任何快速播放表述，应用应避免出现语音断崖。
- 避免使用中间用户界面： 对于要求快速播放的表述，立即开始播放，不要显示内容详细信息页面或配置文件选择屏幕。
- 使用上次使用的配置文件： 如果您的应用有用户配置文件，则使用上次激活的配置文件继续播放，以最大限度减少用户互动。
- 处理儿童配置文件： 如果请求的内容不适合当前的儿童配置文件，则显示配置文件选择屏幕。
播放特定剧集
- 避免显示电视节目详情页面： 直接播放所请求的剧集，无需中间步骤。
- 处理季和剧集编号： 使用提供的ID、季和剧集编号检索正确的剧集。
-
播放所请求的剧集： 如果请求播放特定剧集，则直接播放该剧集，而不是从该季的开头开始播放。
- 处理仅指定季的请求： 如果只指定了某一季，则继续播放该季中最后观看的剧集或播放下一集。如果继续选项不可用，则显示包含该季所有剧集的搜索结果屏幕。
- 处理仅指定剧集的请求： 如果指定了剧集，则播放上次观看的季或最新一季中的剧集。您也可以显示包含不同季中选项的搜索结果屏幕。
恢复部分观看的内容
如果您的应用为用户保持内容的播放状态，请确保您的应用使用语音请求恢复内容的播放。
- 从上次观看的位置继续： 从用户停止的地方继续播放电影和剧集。
- 处理没有剧集/季编号的电视节目： 对于电视节目的观看表述，如果上次观看的剧集已放完，则继续播放上次观看的剧集，或播放下一剧集。
处理非特定的播放请求
客户可以使用通用表述，例如按题材名称观看、按体育运动类型观看。然后您的应用可以播放由应用特定算法识别的相关内容，或者显示包含媒体结果列表的搜索屏幕。
- 使用应用特定算法： 根据用户的首选项或题材识别相关内容。
- 显示搜索结果： 如果未找到特定内容，则显示包含相关选项的搜索屏幕。
- 考虑特殊页面： 利用喜剧、动作片或体育节目等题材的专用页面，提供更加定制化的体验。
切记要优先考虑流畅的用户体验，避免需要使用Fire TV遥控器的不必要步骤，并对语音命令提供直观的响应。
一致且用户友好的搜索体验
- 确保搜索结果页面设计良好，易于浏览，并以清晰简洁的方式显示结果。
- 考虑整合筛选、排序和分页等功能来增强用户体验。
使用实体类型和值进行搜索
- 调用您的应用时，使用搜索查询中提供的实体类型和值来优化搜索结果。例如，如果用户搜索“阿诺德·施瓦辛格电影”，则该应用应搜索阿诺德·施瓦辛格主演的电影。
- 处理所有指定的实体类型（Actor, Channel、Character、Director、Episode、Event、Franchise、Genre、League、MediaType、Production Company、Season、Sport、SportsTeam、Video和Popularity），以提供相关结果。
避免客户体验中断
务必处理搜索请求，以避免客户体验中断。如果您的应用没有应用内搜索，则应显示一条明确的消息，表明不支持搜索功能。
注意： Fire OS应用可以通过在清单中省略
SearchAndDisplayResults功能，选择不在Alexa搜索查询中被调用。但是Vega没有提供完全删除搜索界面的机制。在集成了目录的Vega应用中实现搜索处理传输控制请求
内容启动器不提供传输控制。对于目录集成应用，必须处理传输控制表述。
- 如果您的应用的媒体播放器使用W3C媒体播放器API，则使用W3C媒体与Vega媒体控制集成来处理除了“Next”（下一个）和“Previous”（上一个）之外的所有传输控制表述。使用
AppOverrideMediaControlHandler覆盖媒体控制处理程序即可支持“Next”和“Previous”表述。 - 如果您的应用的媒体播放器未使用W3C媒体播放器API，则可以使用Vega媒体控制API来支持传输控制。
Last updated: 2025年9月30日
