当OAuth接入的设备列表发生变动时(包括但不限于新增设备、删除设备、更新设备等)需要通知天猫精灵智能家居云端去更新该技能下的设备列表,接入该流程的步骤如下:
一.建立阿里系服务端应用
1.登录阿里百川服务
2.进入控制台
https://console.baichuan.taobao.com/applications.htm
3.点击 创建应用,输入应用信息
3.1.因为阿里百川基础服务同样由淘宝开放平台进行支撑,所以百川中所建立的应用同样可以在淘宝开放平台中进行管理,但淘宝开放平台开放业务线以店商为主,阿里百川则有较多较开放的业务类型可选择。所以对于非电商属性的业务可以先在阿里百川建立应用后,再到淘宝开放平台管理 (例如修改回调地址之类的操作)。
3.2.应用信息说明:
- APP名称: 即淘宝开放平台应用名称
- 分类: 选择智能硬件
- OS端: 可选择安卓,Package Name使用有意义的包名称即可,例如: com.alibaba.ailabs.demo
- APP下载地址: 不重要,随意HTTP URL即可
4.确认应用已在阿里百川平台创建完成
5.接着登入淘宝开放平台
https://console.open.taobao.com/?#/app/manager
6.控制台中应该能够看到刚刚所创建的应用
其应用名称及appKey会与刚刚在百川平台中看到的相同
7.如果需要调用设备列表更新通知接口
那么请将app key告知阿里同学(请在钉钉AliGenie智能家居接入咨询群或者AliGenie智能家居接入咨询2群中告知管理员),阿里同学会将天猫精灵云云对接设备状态上报及设备列表更新通知权限包加入这个应用的可用功能场景中。当权限包成功加入后,应用概览页的“功能场景”表格中会看到增加了“天猫精灵云云对接设备状态上报及设备列表更新通知”一项
8.至此,您的阿里系服务端应用已创建完成
二.调用设备列表更新通知接口
当用户OAuth接入的设备列表发生了变化(含新增、删除、更新)时,调用 alibaba.ailabs.iot.device.list.update.notify 通知天猫精灵智能家居云端,天猫精灵云端收到通知后会去更新用户在该技能下的设备列表,具体的集成流程请参考 https://open.taobao.com/api.htm?docId=42961&docType=2&scopeId=16015