天猫精灵对接开发商服务
完整控制流程图与天猫精灵对接后,终端用户可以通过对天猫精灵说出控制命令来调用云端的业务逻辑,最终将正确的操作反馈给用户。 流程图如下所示。相关连接汇总开发者网站:https://open.bot.tmall.com/account/login添加新技能:https://open.bot.tmall.com/console/skill/list示例代码见:https://gith...
完整控制流程图
与天猫精灵对接后,终端用户可以通过对天猫精灵说出控制命令来调用云端的业务逻辑,最终将正确的操作反馈给用户。 流程图如下所示。
相关连接汇总
开发者网站:https://open.bot.tmall.com/account/login
添加新技能:https://open.bot.tmall.com/console/skill/list
示例代码见:https://github.com/AbleCloudGit/tmallbot_server_demo/tmallbot_server_demo.js
新技能配置
-
前往开发者网站(https://open.bot.tmall.com/account/login)注册后登陆开发者平台。
-
点击"添加新技能"新增一个技能。
-
按照界面提示配置技能基本信息。
序号 | 选项 | 备注 |
1 | 技能名称 | 可由开发者自定义 |
2 | 调用词 | 使用者通过调用词进入对应的技能,由开发者自定义,如:通过“天猫精灵+Able”可进入到创建的Able技能执行操作。 |
3 | 技能类型 | 选择标准类型,目前天猫精灵仅支持标准技能。 |
4 | 技能模板 | 选择智能家居。 |
5 | 技能描述 | 针对技能的描述说明,由开发者自定义。 |
-
按照界面提示配置服务基本信息
序号 | 选项 | 备注 |
1 | 账户授权连接 | 由AbleCloud提供,用于AbleCloud账号为天猫精灵授权。 |
2 | Client ID | 由AbleCloud分配用于对接天猫精灵 |
3 | Client Secret | 由AbleCloud分配用于对接天猫精灵 |
4 | Access Token URL | 由AbleCloud提供,天猫精灵通过链接获取到用户账号的token |
5 | 开发者网关地址 | 服务所在的服务器地址(由于天猫没有提供对应的服务,所以该部分有开发者提供服务器,并部署对应的服务) |
账户授权连接 Url 填入:
https://oauthtest.ablecloud.cn/authorize (测试环境)
https://oauth.ablecloud.cn/authorize (国内环境)
Access Token Url 填入:
https://oauthtest.ablecloud.cn/token (测试环境)
https://oauth.ablecloud.cn/token (国内环境)
协议说明
协议地址:http://doc-bot.tmall.com/docs/doc.htm?spm=0.0.0.0.ZsYBQd&treeId=393&articleId=107454&docType=1
设备发现
设备控制
{
"header":{
"namespace":"ali_genie.Iot.Device.Discovery",
"name":"DiscoveryDevices",
"messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
"payLoadVersion":1
},
"payload":{
"accessToken":"access token"
}
}
{
"header":{
"namespace":"ali_genie.Iot.Device.Control",
"name":"TurnOn",
"messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
"payLoadVersion":1
},
"payload":{
"accessToken":"access token",
"deviceId":"34234",
"deviceType":"XXX",
"attribute":"powerstate",
"value":"on",
"extensions":{
"extension1":"",
"extension2":""
}
}
}
服务开发示例URL
由于天猫本身并没有提供托管服务,因此开发者需要准备一台服务器用于服务程序部署运行。开发过程中建议开发者不要再服务程序中做过多的逻辑处理,而是将主要逻辑处理放在云端UDS内部进行处理,在服务中调用sendToService接口,请求UDS进行处理具体逻辑详见服务程序示例,该示例为node.js开发者可选择其他语言自行实现。至此天猫接入流程完成,可以在镇机上针对天猫精灵进行测。示例地址: https://github.com/AbleCloudGit/tmallbot_server_demo/blob/master/tmallbot_server_demo.js
天猫精灵测试
- 开启测试
- 点击【账户配置】(如果点击失败,可尝试【新窗打开】)
- 获取设备
- 语音控制
-
提交发布
测试无问题后便可进行提交发布
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)