Alexa的语音服务(AVS)公开HTTP / 2端点和支持云启动指令,它允许您访问Alexa的内置功能,如定时器、报警器、媒体传输控制,语音控制音量调节,和亚马逊的Alexa的应用集成。
关键术语和概念
Frame:在HTTP/2协议的基本单元;每一个Frame都有不同的用途,例如标题和数据的Frame格式的HTTP请求和响应的基础。
流:一个独立的、双向的帧序列的一个客户端和服务器之间交换在一个HTTP / 2连接。
接口:AVS暴露接口(speechrecognizer,AudioPlayer,synchronizestate,等),提供您的产品使用Alexa的内置的技能。
Downchannel(下载通道):在你的HTTP / 2连接创建的一个流,它是用来传递指令从云端到你的客户。下载通道仍然开放,在半封闭的状态从设备和开放从AVS为连接的生命周期。下载通道主要是用来发送指令和音频附件云启动你的客户端。
注意:你的客户端每个连接只能创建一个下载通道流。
云启动指令:从云发送到客户端的指令。例如,当用户使用亚马逊Alexa的APP调整设备的音量,直接发送到你的产品不需要相应的语音请求。
先决条件
在创建一个与AVS的HTTP / 2连接,你需要:
获取访问令牌
使用AVS标准,您的产品需要获得亚马逊登录(LWA)访问令牌,使您的产品获得API代表客户。有用于获得与AVS使用访问令牌的两种方法。
远程授权用于授权使用同伴网站或移动应用程序的设备。
从同伴站点授权
从同伴应用程序授权
本地授权用于授权Alexa直接从AVS功能的产品。
从AVS授权产品
LWA访问令牌你获得必须发送到AVS在每个事件的标题。如果认证以任何理由,AVS连接关闭失败。
下面是一个示例头。除了你的访问令牌,一个边界条件是每个事件的头需送到AVS。
:method = POST
:scheme = https
:path = /{
{API version}}/events
authorization = Bearer {
{YOUR_ACCESS_TOKEN}}
content-type = multipart/form-data; boundary=