Alexa语音服务允许开发者通过麦克风和扬声器为连接的产品提供语音功能.一旦集成,你的产品将有权访问Alexa内置功能(如音乐播放、定时器和闹钟、快递追踪、电影列表、日历管理等)以及使用Alexa技能工具包开发的第三方技能.
AVS由与客户端功能对应的接口组成,如语音识别,音频回放,和音量控制.每个接口都包含被称为指令和事件的逻辑分组消息.
指令(Directives) : 云端发送消息到客户端,指示客户端采取行动
事件(Events) : 从客户端发送消息至云端,通知Alexa发生了一些事情
API使用Login with Amzaon (LWA)进行产品授权,并公开HTTP/2端点.
授权
要访问AVS API,你的产品需要获得使用LWA访问令牌的登录名称,它授予产品访问权限以代表客户调用API.有两种方式授权产品.
-
远程授权用于授权设备与配套网站或移动应用程序的设备.通常，远程授权与智能设备一起使用,如智能音响
-
本地授权用于授权来自支持AVS产品的Alexa,通常,本地授权与Android和IOS应用程序一起使用
传输协议
以下提供的页面可帮助你管理连接和结构请求
端点
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中传输新的指令或新的属性,同时保持现有指令和属性的向后兼容.
