发行说明 (VSK Fire TV)

这里提供了VSK Fire TV和Alexa客户端库的发行说明。

VSK Fire TV发行说明
VSK开发者门户1.1自助服务门户发行说明
Alexa客户端库发行说明

VSK Fire TV发行说明

下表提供了Fire TV的VSK的发行说明。

日期	描述
2022年5月1日	指令有效负载更新。VSK指令有效负载已更新，以弃用某些类别的ID。
2022年1月14日	检测声明和格式更新，以及对Alexa.Launcher 3.1的新支持。更新了Capabilities API，可使用生成器对象轻松声明和格式化发现。增加了对Alexa.Launcher 3.1功能的支持。
2021年8月12日	新的国家/地区和语言支持。推出了对奥地利德语 (de-DE) 的视频技能支持。
2021年6月30日	新的国家/地区和语言支持。为墨西哥 (es-MX)、巴西 (pt-BR)、澳大利亚 (en-AU)、新西兰 (en-AU) 和爱尔兰 (en-GB) 启动了视频技能支持。
2021年1月11日	Alexa客户端库1.4.9。Alexa客户端库版本1.4.9已发布。此版本将`minSdkVersion`属性的可接受值增加到`18`，并包括稳定性和安全性增强。
2020年9月28日	发布了仅限应用的集成。仅限应用的集成一种方法，可以更高效、更简单地将VSK集成到您的Fire TV应用中，使您可以直接在应用的Android代码中工作，而不是配置外部服务（例如ADM、Lambda、CloudWatch、IAM）。借助仅限应用的集成，Fire TV上一项名为VSK Agent的服务通过广播意图将指令从Alexa路由到您的应用。您应用中的BroadcastReceiver会处理这些意图。您基于意图，在应用中满足用户的请求（通常是以检索或播放所请求内容的方式）。要开始使用，请参阅仅限应用的集成概述。
2020年8月10日	新的实体类型。添加了三个新的实体类型： `Popularity`、`Recency`和`VideoResolution`。实体类型提供了有关用户发出的请求类型的更多详细信息。除了包含这些新实体类型的文档外，该文档还进行了更新，以纳入以前缺少的实体类型：（`Channel`、`Episode`、`Director`、`ProductionCompany`和`App`）。
2020年7月27日	文档导航。进行了一些文档更新。Fire TV的VSK和Echo Show的VSK分离成了各自的导航，从而更易于查看和导航它们。为了便于导航，已将表述从认证步骤移至表述参考，还纳入了表述概述，以阐明表述的不同方面。此外，使用以理解Alexa所用算法的自然语言实现的最新确认的表述，更新了每个区域设置支持的表述列表。还为表述列出了版本。
2020年5月21日	es-MX测试版。对区域设置es-MX（针对墨西哥本地化的西班牙语）的视频技能支持已进入公开测试版阶段。有关更多详细信息，请参阅支持的国家/地区。
2020年5月13日	en-AU支持。对区域设置澳大利亚 (en-AU) 的视频技能支持已进入公开测试版阶段。有关更多详细信息，请参阅支持的国家/地区。
2020年3月22日	新示例应用。发布了包含VSK的新示例应用。有关更多详细信息，请参阅步骤2：设置示例Fire TV应用了解详情，或直接前往位于sample-fire-tv-app-video-skill的GitHub存储库。与新示例应用相关的文档也已更新。
2020年2月14日	hi-IN支持。推出了对区域设置印地语印度 (hi-IN) 的视频技能支持。有关更多详细信息，请参阅支持的国家/地区。
2019年11月23日	门户更新。已推出开发者门户1.1自助服务门户版本。有关更多详细信息，请参阅下面的开发者门户1.1自助服务门户版本部分。
2019年11月12日	fr-CA支持。推出了对区域设置法语加拿大 (fr-CA) 的视频技能支持。有关更多详细信息，请参阅支持的国家/地区。
2019年11月7日	es-ES支持。推出了对区域设置西班牙 (es-ES) 的视频技能支持。有关更多详细信息，请参阅支持的国家/地区。
2019年10月31日	en-IN支持。推出了对区域设置印度 (en-IN)、日本 (ja-JP)、意大利 (it-IT) 和法国 (fr-FR) 的视频技能支持。对区域设置西班牙 (es-ES) 的视频技能支持已进入公开测试版阶段。有关更多详细信息，请参阅支持的国家/地区。
2019年10月25日	自动配对。在Alexa控制台的视频技能配置屏幕中推出了自助自动配对选项。有关此功能的文档更新仍然待定。
2019年9月20日	Alexa客户端库1.4.5。Alexa客户端库版本1.4.5已发布。此版本支持一个名为`Alexa.KeypadController`的新接口，该接口提供用于滚动和选择的指令。
2019年9月20日	KeypadController接口。`Alexa.KeypadController`接口文档。当用户说出滚动和选择表述时，此接口会发送`SendKeystroke`指令。
2019年9月15日	检测文档。`Alexa.Discovery`接口 (FTV) 和`Alexa.Discovery`接口 (MM) 的文档。`Discovery`接口向您的Lambda发送`Discover`指令，以了解您的视频技能支持哪些功能。然后，Alexa会根据响应发送与您的支持功能相关的指令。
2019年6月28日	de-DE测试版。推出了对区域设置德国 (de-DE) 的视频技能的测试支持。有关更多详细信息，请参阅支持的国家/地区。
2019年6月27日	en-CA支持。推出了对区域设置加拿大 (en-CA) 的视频技能支持。有关更多详细信息，请参阅支持的国家/地区。
2019年5月2日	en-GB支持。推出了对区域设置英国 (en-GB) 的视频技能支持。对印度区域内视频技能的支持已进入公开测试版阶段。有关更多详细信息，请参阅支持的国家/地区。
2019年5月2日	公开文档发布。适用于Fire TV应用的VSK的第一份公开文档已发布。之前该文档位于私有Github存储库中。此外，为了整合视频技能的设备实现文档，Echo Show文档已移至此处。

有关与Alexa客户端库相关的更新，请参阅Alexa客户端库发行说明。

VSK开发者门户1.1自助服务门户发行说明

开发者门户1.1简化了现场工程师为将视频技能与Fire TV应用配对而必须执行的手动后端配置。对于此版本，当您配置视频技能时，您可以自行选择一个Fire TV应用来与您的视频技能配对，无需现场工程师参与。

该版本在Alexa控制台中增加了有关视频技能配置的新部分，名为“4.Fire TV Support”（4. Fire TV支持）：

本部分允许您选择与您的视频技能关联的Fire TV应用。

尽管视频技能用户界面的变化很小，但因此启用自动配对需要进行许多其他更改。文档许多内容已更新。进行了以下更新：

对Lambda代码的更改

之前，有一个基本的Lambda函数用于快速入门，当您开始使用自己的技能自定义Lambda代码时，会使用另一个Lambda函数。为了简化配置，现在只有一个Lambda。（已删除您之前粘贴到编辑器中的基本Lambda。）以前包含在sample-nodejs-vsk-with-adm.zip项目中的Lambda现在是您唯一需要使用的Lambda。此外，该项目被重命名为firetv-lambda.zip。
现在，可以在Lambda代码中自动检索ADM注册ID。初始无需在Lambda代码中对注册ID进行硬编码，之后在自动配对后使用更自动化的方法替换代码。
要将您的Lambda代码上传到AWS中的Lambda，您现在必须始终生成Lambda部署程序包（zip文件）。您不再将代码粘贴到Lambda函数编辑器中。
Lambda已更新，在CloudWatch日志的第一行显示指令名称。这可以帮助您更轻松地识别您的Lambda收到的指令。

不再需要Discover.Response有效负载中的一部分端点代码：

"endpointId": "VSKTV",
       "description": "VSKTV是专为Fire TV集成开发的视频技能默认设备"，
       "friendlyName": "VSKTV",
       "manufacturerName": "Amazon"

对示例应用的更改：

在示例应用中，Alexa客户端管理器立即启用Alexa。之前已注释掉下面的行，现已启用此行：clientManager.setAlexaEnabled(true);。
在示例应用中，当初始化Alexa客户端库时，技能阶段设置为AlexaClientManager.SKILL_STAGE_DEVELOPMENT。只有在您的技能通过动态应用测试和认证后，您才会将此更新为AlexaClientManager.SKILL_STAGE_LIVE。
示例应用的Alexa客户端库版本已更新至1.4.5。

流程变更：

已删除之前与自动配对相关的许多说明。
当您创建视频技能时，您将从一开始就完成最低限度的任务 - 只需要获得视频技能ID即可。您将把其他视频技能字段和部分留空。在流程的稍后阶段（步骤7），您将返回以填写其他字段。最重要的是，在第7步中，您将完成新的视频技能部分： "4.启用Fire TV支持。” 本部分允许您将视频技能与特定的Fire TV应用配对。
在使用示例应用测试表述并查看CloudWatch中的日志之前，需要进行更多设置。之前，可在步骤2中使用此表述测试。现在，您在步骤8中进行表述测试。
您不再需要使用Alexa应用来手动检测您的视频技能您的视频技能，也不需要通过在Alexa应用中选择VSKTV来手动配对技能。检测是自动的。
以前，在将应用与视频技能自动配对之前，您会看到每个目录的目录结果。现在，开发过程中您的视频技能与应用配对的时间将大幅提前，因此您只能看到与视频技能相关的目录的目录结果和Prime Video标题的目录结果。
在各个位置中，更新、扩展或以其他方式调整了实施步骤的序列和顺序。还添加了更多关于认证后如何上线的说明。

Alexa客户端库发行说明

下面提供了最新版本Alexa客户端库的发行说明。有关集成说明，请参阅步骤3：集成Alexa客户端库。

版本1.5.0

2022年1月14日发布

更新了Capabilities API，可使用生成器对象轻松声明和格式化检测。
增加了对Alexa.Launcher 3.1功能的支持

版本1.4.9

2021年1月11日发布

将minSdkVersion属性的可接受值增大到18
加入稳定性和安全性增强

版本1.4.8

2020年11月23日发布

移除了javax.inject依赖项，以减少可能出现的编译冲突情况。
提高了多次调用initialize() 时的灵活性。这不会再导致客户端崩溃，但仍应避免。

版本1.4.7

2020年8月26日发布

移除了Dagger依赖项注入框架，以防止构建冲突并且不要求使用者将其声明为依赖项
将LWA SDK更新为最新版本以防止构建冲突

版本1.4.6

2019年12月17日发布

增强对程序包名称的处理，以防止初始化顺序可能导致其为空的情况
防止记录程序包名称
如果相关字段没有更改，请不要在7天后重新发送检测

版本1.4.5

2019年8月29日发布

将对KeypadController检测的功能版本更新到“版本3”
仅发送有关状态更改的已更改状态报告

版本1.4.4

2019年6月12日发布

提供对Fire OS 7的支持。新的Fire TV设备将在Fire OS 7上运行，因此您的应用需要有此版本的Alexa客户端库才能支持FOS 7设备。旧版本的Alexa客户端库与FOS 7不兼容。
包含错误修复补丁，有助于在使用语音时为客户提供更好的体验。
增强了Alexa、Fire TV和您的应用之间关系的安全性。

版本1.4.3

2019年4月19日发布

删除了对Build.getSerial() 的调用以防止崩溃。

版本1.4.2

内部发布

安全性增强。

版本1.4.1

2019年2月12日发布

修复了可能导致客户端库在不后移的情况下重试失败事件的错误。

版本1.4.0

2018年10月9日发布

从1.4.0版开始，客户端库支持国际地区。该库会考虑用户注册亚马逊账户时所在的市场，然后根据当前注册到设备的客户与“正确”的地区Alexa终端节点进行配对。

要使此流程端到端运作，您必须确保已向您的亚马逊解决方案架构师提供了特定于地区的目录，或者至少指明您希望自己的美国目录也能在特定地区可用。使用这些详细信息更新您的技能后，您在国际地区的用户将能够自动配对并使用语音与Alexa来控制您的应用。

Last updated: 2022年6月15日