天猫精灵语音服务 (TmallGenie Voice Service; TVS) 是天猫精灵团队所开发,与亚马逊Alexa Voice Service 的AVS协议完全兼容的接口服务,适合产品已在国内外接入AVS的厂商与开发者快速将其语音服务替换为天猫精灵服务时使用。
TVS能让具有麦克风与喇叭的连网设备增添语音能力。集成之后,你的产品即能够使用天猫精灵的语音功能 (像是音乐播控、生活服务、智能家居控制等等) 以及由三方开发者所开发的各类语音技能。
TVS由多个与客户端功能对应的接口所组成,像是语音识别 (speech recognition)、音频播控 (audio playback)、与音量调整 (volume control) 等。每个接口会包含一到多个称为指令 (directives) 与事件 (events) 的报文格式。 指令 是由云端所下发到客户端,要求客户端进行操作的讯息。 事件 则是由你的客户端上报给精灵服务以告知有事件发生的讯息。
TVS的授权与登陆流程依赖淘宝登录与淘宝开放平台中的TVS相关接口,其传输协议则支持HTTP1.1与HTTP/2两个版本。HTTP1.1版本的TVS对应AVS在v20160207
之前的接口版本,不具备服务端推送能力。HTTP/2版本的TVS则对应AVS目前的v20160207
版本。
要使用TVS API,你的产品必须要让用户进行淘宝登陆之后,使用该用户授权信息调用TVS激活接口取得精灵token。相关说明请见:
以下文档提供如何接入TVS的方式:
每个接口都是一组的指令与事件,并对应某个特定的客户端功能。下表为TVS所提供的接口:
接口 | 说明 |
---|---|
AudioPlayer | 此接口用以管理和控制精灵服务所给出媒体内容的播控操作。相关概念请见AudioPlayer介绍。 |
PlaybackController | 此接口用以处理由设备GUI界面所触发的播放列表控制事件。 |
Settings | 此接口用以管理设备上的精灵服务配置项。 |
Speaker | 此接口用以控制精灵服务所提供媒体内容的音量大小,包含静音设置。 |
SpeechRecognizer | 精灵语音服务的最核心接口。每个用户语音问句都需要使用此接口的Recognize事件对精灵服务进行请求。 |
SpeechSynthesizer | 此接口将回复精灵服务TTS。 |
TemplateRuntime | 用以定义渲染元数据的接口。相关概念请见显示卡片 (display card) 介绍。 |