设备标签用于展示如设备信息,如厂商、设备型号的静态扩展信息,以键值对的形式存储在云端。

向云端发送更新设备标签的消息

上报设备标签信息更新的消息时,标签信息放在成对的一组或多组attrKey和attrValue中attrKey的定义支持大小写字母及数字,但不能以数字开头,长度为2~32个字节,payload为JSON数组类型,可包含多对{"attrKey":"","attrValue":""}。示例如下:

/* 设备标签有两组, 第一组attrKey为abc, attrValue为Hello,World. 第二组attrKey为def, attrValue为Hello,Aliyun */
char *payload = "[{\"attrKey\":\"abc\",\"attrValue\":\"Hello,World\"},{\"attrKey\":\"def\",\"attrValue\":\"Hello,Aliyun\"}]";
/* 设备标签payload准备好以后, 就可以使用如下接口进行上报了 */
IOT_Linkkit_Report(devid, ITM_MSG_DEVICEINFO_UPDATE, (unsigned char *)payload, strlen(payload));

向云端发送删除设备标签的消息

上报设备标签信息删除的消息时,将标签信息的attrKey放在一个或多个attrKey中。

/* 设备标签attrKey有两个, 第一个attrKey为abc. 第二个attrKey为def */
char *payload = "[{\"attrKey\":\"abc\"},{\"attrKey\":\"def\"}]";

/* 设备标签payload准备好以后, 就可以使用如下接口进行上报了 */
IOT_Linkkit_Report(devid, ITM_MSG_DEVICEINFO_DELETE, (unsigned char *)payload, strlen(payload));