Alexa Voice Service 概述

Alexa语音服务允许开发者通过麦克风和扬声器为连接的产品提供语音功能.一旦集成,你的产品将有权访问Alexa内置功能(如音乐播放、定时器和闹钟、快递追踪、电影列表、日历管理等)以及使用Alexa技能工具包开发的第三方技能.

AVS由与客户端功能对应的接口组成,如语音识别,音频回放,和音量控制.每个接口都包含被称为指令和事件的逻辑分组消息.

指令(Directives) : 云端发送消息到客户端,指示客户端采取行动

事件(Events) : 从客户端发送消息至云端,通知Alexa发生了一些事情

API使用Login with Amzaon (LWA)进行产品授权,并公开HTTP/2端点.

授权

要访问AVS API,你的产品需要获得使用LWA访问令牌的登录名称,它授予产品访问权限以代表客户调用API.有两种方式授权产品.

• 远程授权用于授权设备与配套网站或移动应用程序的设备.通常，远程授权与智能设备一起使用,如智能音响

  • Authorize from a Companion Site

  • Authorize from a Companion App

• 本地授权用于授权来自支持AVS产品的Alexa,通常,本地授权与Android和IOS应用程序一起使用

  • Authorize from an AVS Product

传输协议

以下提供的页面可帮助你管理连接和结构请求

• Managing an HTTP/2 Connection
• Structuring an HTTP/2 Request

端点

AVS公开HTTP/2服务,并预期为HTTP/2编码的多部分消息.支持以下端点

地区	支持的国家	URL
亚洲	日本	https://avs-alexa-fe.amazon.com
欧洲	奥地利,德国,印度,英国	https://avs-alexa-eu.amazon.com
北美	加拿大,美国	https://avs-alexa-na.amazon.com

接口

每个接口都是指令和事件的集合,对应于特定的客户端功能.

接口	描述
SpeechRecognizer	Alexa语音服务的核心接口,每个用户话语都利用Recognizer事件
SpeechSynthesizer	返回Alexa TTS
Alerts	用于设置,停止和删除定时器和警报
AudioPlayer	管理和控制来自Alexa队列的音频回放
Bluetooth(开发者预览)	管理与对等蓝牙设备,如智能手机和音箱的连接
Notifications	当通知可用时, 提供视觉和音频指示器
PlaybackController	通过按钮按下来播放回放队列或GUI设置
Settings	管理产品上的Alexa设置,例如语言环境
Speaker	控制产品上Alexa播放的内容,包括静音和取消静音
System	用于发送关于你产品的Alexa信息
TemplateRuntime	呈现可视化数据

版本

亚马逊定期更新AVS API的新功能,性能增强和错误修复,为Alexa用户提供最好的体验.这些更改可能会导致在JSON中传输新的指令或新的属性,同时保持现有指令和属性的向后兼容.

翻译版本为v20160207