如何通过配置C Link SDK实现设备上报,更新或删除标签

阿里云物联网平台提供的设备标签功能，可以为设备自定义标识，以便灵活管理设备。本文介绍通过配置C Link SDK，实现设备上报、更新或删除标签。

前提条件

已获取设备认证信息。
已下载C LinkSDK Extended。

使用流程

如下功能时序图，以设备的应用程序demos/devinfo_basic_demo.c为例，介绍设备标签的使用流程。

步骤一：设备初始化

创建设备句柄，完成设备建连。

static void* demo_device_init(char *product_key, char *device_name, char *device_secret, char *host, uint16_t port)
{
    int32_t res = STATE_SUCCESS;
    /* 创建设备 */
    void *device = aiot_device_create(product_key, device_name);
	....
    ....
        
    res = aiot_device_connect(device);
    
	....
    ....
    return device;
}

设置标签模块回调函数。
添加或删除标签的结果会通过demo_devinfo_callback返回。
```
	aiot_device_devinfo_set_callback(device, demo_devinfo_callback, NULL);
```

步骤二：添加标签

使用如下示例代码添加标签。

 /* 测试添加标签key,value */
 aiot_device_devinfo_add(device, "test_key", "test_value");

参数说明

参数	说明
`device`	设备句柄。
`"test_key"`	标签名称。必须为非空字符串。
`"test_value"`	标签的值。必须为非空字符串。

步骤三：删除标签

使用如下示例代码删除标签。

	/* 测试删除标签key */
	aiot_device_devinfo_delete(device, "test_key");

参数说明

参数	说明
`device`	设备句柄。
`"test_key"`	标签名称。必须为非空字符串。

步骤四：设备反初始化

 /* 断开设备连接，并回收设备资源 */
 demo_device_deinit(device);