LinkVoice解决方案
更新时间：2018-09-28 19:20:13
文档说明
使用对象：希望将使用飞燕平台接入的设备上，集成天猫精灵Indise语音能力的方案商、品牌商，让设备成为语音交互终端。消费者通过语音指令，就可以控制本设备。
文档目的：由于方案商往往不会同时熟悉飞燕平台和天猫精灵Inside平台，本文档希望通过对对接流程、实现流程的阐述，让方案商对整个实现过程有个初步的了解。
方案概述
本方案，通过与天猫精灵硬件开放平台的对接，帮助飞燕平台设备具备了语音能力。用户只需要如下几步，即可完成对接：
- 在天猫精灵平台和飞燕平台注册账户和产品信息。
- 在天猫精灵平台定义自定义技能，并在方案商的云端实现对自定义技能与飞燕平台控制指令之间对转换。
- 设备端集成Inside SDK和Link Kit SDK。
- 按照飞燕APP SDK指定对方式进行注册和配网。 具体内部逻辑和实现机理，后文介绍。
基本概念
|
飞燕
|
飞燕平台
|
智能生活接入平台
|
|
APP SDK
|
飞燕平台的APP端的SDK，实现配网和与飞燕平台的接口封装
|
|
|
Link Kit SDK
|
飞燕平台的设备端接口封装
|
|
天猫精灵
|
AliGenie Inside平台
|
天猫精灵硬件开放平台
|
|
AliGenie Inside SDK
|
天猫精灵硬件开放平台在设备端的能力封装飞燕平台的APP端的SDK，实现配网和与飞燕平台的接口封装
|
|
方案商
|
设备应用
|
厂家或方案商开发的设备端端应用程序
|
|
三方云
|
厂家或者方案商提供的云平台
|
开发前的准备
飞燕平台
- 注册飞燕平台账号
- 链接：https://living.aliyun.com/
- 下载APP端和设备端端SDK
- 按需创建产品： https://living.aliyun.com/doc#readygo.html
天猫精灵平台
- 注册天猫精灵硬件开发平台账号（企业用户）
- 链接：https://aligenie.bot.tmall.com/
- 下载设备端SDK：注册之后可下载
- 按需创建产品：http://doc-bot.tmall.com/docs/doc.htm?spm=0.7629140.0.0.607d1780jKxQMj&treeId=393&articleId=108875&docType=1
原理与流程
系统初始化
该流程示意了为了实现后续的语音控制链路，需要做的初始化工作及其顺序。
图中各步骤解释如下：
1.注册：通过飞燕SDK注册账户
2/3.配网：通过飞燕SDK为设备配网和设备授权
4/5.初始化Inside账户：根据用户APP上输入的信息（淘宝账号），激活Inside平台的账号
6/7.初始化Inside设备：向Inside平台注册和绑定该设备
8.绑定转换关系：用户账户之间、设备ID之间的转换关系
语音控制流程
该流程阐述了在这个集成方案中，一个语音指令从发起到设备控制的响应，整个过程涉及到的所有关键步骤和节点。
图中各步骤解释：
1.语音口令：主要由Inside SDK完成。
2.技能+意图：Inside云根据输入的语音和该设备配置的自定义技能，识别出技能和意图，并通过WebHook的方式回调三方云平台。
3/4.通用设备控制：飞燕平台基础的设备标准控制链路。
平台间的互通
三方云在整个方案中承担了猫精inside语音体系和飞燕控制体系之间的打通和串联的功能。为了实现互通，三方云转换如下关系：
| 转换项目 | ILOP云 | Inside云 | 三方云转换 |
|---|---|---|---|
| 设备ID | 设备标识为DN（MAC），提交平台设备唯一码为IoT ID，通过DN换取 | 设备表示为MAC，提交平台设备唯一码为UUID，通过MAC换取 | 在APP配网之后，由APP发起，将对应关系写入三方云 |
| 用户ID | 用户通过APP在百川账户系统注册（BID） | 用户通过APP，输入相应的淘宝账户（TID） | 在APP注册之后，由APP发起，将对应关系写入三方云 |
| 语音与指令 | 格式化的标准设备控制指令 | 通过自定义技能定义的技能和意图 | 根据在Inside云定义的技能ID，【手动关联】对应的ILOP云的控制关系 |
补充资料
申请内测名额
请按照标题格式【LinkVoice对接支持 +「空格」+ 公司名称】，发送电子邮件至 alibaba_iot@service.aliyun.com，进行内测申请。
并确保在邮件内容中，请包含如下信息：
- 公司名称
- 联系人及联系方式
- 公司地址
- 应用场景描述
我们的商务人员在收到邮件后，会主动与您联系。