智能家居接入流程

一、概述

目前IoT设备接入方式为云云接入,云云接入是指设备厂商自建IoT云服务与思必驰智能家居云服务的对接,IoT设备连接自建的云服务后,适配DUI智能家居协议,实现与思必驰云服务的对接

二、设备接入流程

2.1 准备阶段

1、在DUI开放平台注册登录账号 DUI开放平台

2、下载DUI DEV APP,用于测试语音控制设备最终效果

 

2.2 智能家居协议开发

云云接入需要遵循DUI智能家居协议,基于这些协议可以轻松的通过语音控制家里的智能设备,与设备进行交互;DUI协议提供设备发现接口、设备控制接口、设备状态查询接口等。

我们支持三种协议:AliGenie、Dueros以及DUI协议;前两种协议我们做了兼容,已经接入天猫精灵/Dueros智能家居的设备厂商可复用现有天猫精灵/Dueros的设备接口,减少开发成本。但为了获得良好的用户体验,我们推荐使用DUI协议完成接入:

智能家居接入协议

 

2.3 创建智能家居技能

1、创建技能

点击“控制台->定制技能”,对话类型选择智能家居,填写技能基本信息,包括图标,名称以及协议版本
Minion

2、 配置Oauth2.0授权参数

智能家居技能是基于Oauth2.0协议的云云接入,设备厂商创建技能时需要配置Oauth2.0参数,了解Oauth2.0授权认证参考智能家居授权方式

1)授权地址: 开发者授权访问的地址,遵守OAuth 2.0标准。
2)Client_Id: 客户端ID。
3)ClientSecret:客户端Secret。
4)Scope:scope权限,多个权限之间请使用空格进行分开。
5)回调地址: 每个技能创建时,在开放平台上生成的唯一URL地址,该地址不能修改。
6)Token地址:用于获取Access Token的地址,遵守OAuth 2.0标准协议。
7)设备网关地址:智能家居设备的设备云服务部署地址。
Minion

 

3、 发布技能&真机测试

智能家居型技能支持真机测试,您可以在控制台上开启或关闭技能测试。开启后,您可以通过DUI DEV APP在移动端进行智能家居型技能的对话效果测试。

DUI DEV APP是一款用于在移动端进行技能测试或产品对话效果体验的轻量级APP,目前只支持Android平台。

测试步骤

Step1. 在技能列表页,点击技能后的“开发”按钮,进入技能详情页。

Minion


Step2. 在技能详情页点击左侧“发布”按钮,进入发布列表页。

Minion


Step3. 在发布列表页,点击左侧“测试技能”,进入智能家居型技能测试页面。

Minion


Step4. 打开测试开关,使用DUI DEV APP扫描出现的二维码。
如果没有安装DUI DEV APP,可以在页面左下角看到下载的入口。

Minion

 

测试时注意事项

1)只有已发布的智能家居型技能才能进行真机测试;
2)测试版本不会自动更新,如技能发布了新版本,需要重新扫描一次二维码,才能测试技能的新版本;
3)同一时间,同一账号仅支持一个技能测试;
4)测试时,需要保证技能开发账号和APP登录账号一致。

 

操作演示视频

4、 提交技能商店

详见上架技能步骤

技能上架前,需拍摄一段测试视频,包含正常的账号登陆,设备控制等,视频拍摄完成后,请邮件发送至:dui-smarthome@aispeech.com ,格式内容为需要审核的技能id+测试视频。

注意:若技能发生更改,需要重新发布提交上架。如需对接DCA,是必须上架的,调试期间,上架时请选择“技能商店隐藏”。