1.如何进入设备调试?
在完成产品信息,功能定义及人机交互配置后,就可以通过调试中心在线调试设备所有业务功能。点击第三步的设备调试即可进入调试中心页面。
1.1、账号授权
在进行设备功能调试前,首先确保该设备已经在厂商云完成配网绑定。然后在调试中心进行用户账号Oauth授权绑定。流程如下:
1.2、选择天猫精灵音箱
进入调试页面后会展示当前登录用户名下绑定的天猫精灵,当存在多天猫精灵时,由用户指定天猫精灵作为调试音箱。后续语音调试都是使用已选择的音箱进行的。
1.3、选择待测试的设备
在1.1、账号授权 完成后,选择设备调试页面会展示授权的账号下与当前产品型号对应的真实设备(前提是该设备必须在厂商云先配网绑定)。注意此处只显示当前产品对应的设备
开发者可以选择一个真实设备点击“在线调试”进入设备调试页面。
如果页面未展示该产品对应的设备,请点击“刷新一下”按钮,天猫精灵IoT平台会主动向厂商云发起设备发现请求到厂商云,重新获取该授权用户下的设备。
2.语音调试
语音调试,主要模拟用户通过天猫精灵进行语音控制设备,页面展示整个语音交互过程的对话流信息。同时也展示当前语音控制发送到厂商云的设备控制日志信息,方便开发者问题排查。
通过点击在线调试进入设备调试页面后会展示出语音调试页面:
- 标准语料:为了提高测试效率减少用户口头进行每个功能测试,平台根据产品的功能定义提供每个功能的常用语音表述文本。选择平台默认的标准语料点击发送测试,该语料文本就下发到1.2步骤所选择的天猫精灵进行识别和设备控制。
- 泛化语料:输入想测试的语料进行调试,这里的语料是指用户对天猫精灵说的话,经过ASR识别后的自然语言文本
平台已开放的IoT语料均已做过NLP模型训练泛化。
页面中实时消息显示的是从天猫精灵云发送控制请求到厂商云的日志,如有问题请复制当前发送请求的traceid,提供traceid和问题描述给相关技术支持同学。
3.触屏调试
触屏调试是模拟APP或带屏音箱上设备控制面板上渲染的功能操作。APP或带屏音箱上会根据产品的功能定义为每个设备生成用于触屏控制的设备控制面板。
首先选择“触屏测试”单选按钮,进入触屏测试页面。
然后选择需要测试的功能,并设置该属性的值,然后点击“发送测试”按钮。这时天猫精灵云就会把该属性及属性值封装成 2.5.1 设置设备属性值操作 协议下发给厂商云。
实时消息页面会展示当前属性控制下发的全链路日志及厂商云返回的响应日志。开发者可以根据日志排查开发中遇到的问题。
4.协议测试
协议测试使用的场景是厂商在创建产品时“数据格式”选择是“透传/自定义”,这时需要厂商开发协议透传脚本进行将天猫精灵产品功能转换成厂商云对应的设备控制指令,详情请查看协议透传脚本。如某厂商编写的协议转换透传脚本测试效果如下:
协议测试使用比较特殊,请厂商根据自己实际情况进行测试。
4.常用FAQ
Q:设备调试过程中,设备消息无法上报,导致后续产品流程无法继续
A:
Q:指令无法控制,设备无反应
A: 1.先确定产品开发是否按照目录到达 IoT开放平台->开发指南->嵌入式开发 确定设备严格按照协议开发
2.满足1的前提下,通过输入指定指令是否到设备端
3.满足以上 1. 2 如果还未确定问题,在相关技术支持通过问题模式反馈给技术支持
Q:调试中心设备控制报错
A:1.反馈真实设备能控制,由于APP面板控制下发多个属性导致设备不能控制
Q:设备控制,错误码对应具体原因
A:常用控制错误码详解
错误码 | 对外错误信息 | 错误信息 | ||
310004 | 未找到对应产品信息 | 未找到对应产品信息 | 根据pk未获取到产品信息 | 通用 |
310009 | json命令格式解析错误 | json命令格式解析错误 | json命令格式解析错误 | json调试 |
310010 | 三元组创建信息错误 | 三元组创建信息错误 | 三元组或Mac信息为空 | 绑定虚拟设备 |
310011 | 虚拟设备绑定错误 | 虚拟设备绑定错误 | 绑定过程发生错误 | 绑定虚拟设备 |
310012 | 该产品不支持虚拟设备 | 该产品不支持虚拟设备 | 不是mesh/BLE/wifi的其中一种,不支持绑定虚拟设备 | 绑定虚拟设备 |
310013 | 虚拟设备解绑错误 | 虚拟设备解绑错误 | 解绑过程错误 | 解绑虚拟设备 |
310014 | 协议创建错误 | 协议创建错误 | 二进制调试 | |
310015 | 设备控制失败 | 二进制指令控制过程失败 | 二进制调试 | |
310016 | 设备控制失败 | Json指令控制过程失败 | json调试 | |
310017 | 系统内部异常 | tair写入失败 | tair存入用户和设备映射信息失败 | 绑定虚拟设备 |
310018 | 调试指令不能为空 | 调试指令不能为空 | json/二进制调试 | |
310019 | 调试指令与设备类型不匹配 | 调试指令与设备类型不匹配 | json/二进制调试 | |
310020 | 指令下发错误 | 指令下发错误 | 二进制调试 | |
310021 | 系统内部异常 | 阿里云控制错误 | json调试 | |
310022 | 获取设备品类错误 | 获取设备品类错误 | 根据DevType未获取到设备品类 | 绑定虚拟设备 |
310023 | 缺少用户信息 | 缺少userId | 通用 | |
310024 | 缺少设备信息 | 缺少deviceId | 通用 | |
310025 | 缺少产品信息 | 缺少productKey | 通用 | |
310026 | 缺少天猫精灵设备信息 | 缺少uuid | 二进制调试 | |
310027 | 获取设备默认属性失败 | 获取设备默认属性失败 | 开放平台获取设备默认属性失败 | 启动虚拟设备 |
302002 | 设备操作不支持 | 设备操作不支持 | 存量设备不支持绑定虚拟设备 | 绑定虚拟设备 |