文档中心 > TVS文档

天猫精灵语音服务 (TmallGenie Voice Service)

更新时间:2020/05/19 访问次数:5702

天猫精灵语音服务 (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) 介绍。

FAQ

关于此文档暂时还没有FAQ
返回
顶部