# agora_iot_device_manager.h (/zh-CN/api-reference/iot-apaas/device-sdk/call/device-manager) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 引用文件 [#引用文件] 无 ## 函数 [#函数] ### agora_iot_register_and_bind [#agora_iot_register_and_bind] ```c int agora_iot_register_and_bind(const char *host_url, const char *product_key, const char *device_id, const char *user_id, const char *device_nickname, agora_iot_device_info_t *info); ``` 注册设备并将设备与用户绑定。 #### 参数 [#参数] | 参数 | 描述 | | --- | --- | | [in] `host_url` | SDK 使用的 AWS OpenAPI 服务的主机域名。你可以在声网灵隼控制台的**应用配置>>开发者选项>>呼叫服务>>Master Server URL** 处获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `product_key` | 你的 Product Key。可以从声网灵隼控制台的**应用配置**页面的**开发者选项**选项卡中获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `device_id` | [device-manager-html-0-3-1 details](#table-slot-device-manager-html-0-3-1) | | [in] `user_id` | 你的用户 ID。 | | [in] `device_nickname` | 设备昵称。客户端 SDK 的设备绑定列表会显示该昵称。你可以任意指定,通常建议与产品名称一致(请使用 UTF-8 编码设置中文名称)。如果使用了绑定功能,该名称将显示在客户端。你也可以在客户端为设备重新命名。 | | [out] `info` | 注册绑定完成后返回的设备信息。详见 [agora_iot_device_info_t](#agoraiotdeviceinfot)。 | **device-manager-html-0-3-1 details** 你的设备 ID。你需要自行设置。每个设备的设备 ID 必须是唯一的。长度为 1 ~ 128 个字符。字符集支持: - 26 个大写英文字母和小写英文字母。 - 阿拉伯数字: 0-9。 - 特殊符号:`":"`、`"_"`、`"-"`。 设备 ID 与 License 绑定。参考[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/license)获取免费或商业 License。 #### 返回 [#返回] - 0:方法调用成功。 - < 0:方法调用失败。 ### agora_iot_query_user [#agora_iot_query_user] ```c int agora_iot_query_user(const char *host_url, const char *product_key, const char *device_id, char *user_id); ``` #### 参数 [#参数-1] | 参数 | 描述 | | --- | --- | | [in] `host_url` | SDK 使用的 AWS OpenAPI 服务的主机域名。你可以在声网灵隼控制台的**应用配置>>开发者选项>>呼叫服务>>Master Server URL** 处获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `product_key` | 你的 Product Key。可以从声网灵隼控制台的**应用配置**页面的**开发者选项**选项卡中获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `device_id` | [device-manager-html-1-3-1 details](#table-slot-device-manager-html-1-3-1) | | [out] `user_id` | 与设备绑定的的用户 ID。 | **device-manager-html-1-3-1 details** 你的设备 ID。你需要自行设置。每个设备的设备 ID 必须是唯一的。长度为 1 ~ 128 个字符。字符集支持: - 26 个大写英文字母和小写英文字母。 - 阿拉伯数字: 0-9。 - 特殊符号:`":"`、`"_"`、`"-"`。 设备 ID 与 License 绑定。参考 [开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)获取免费或商业 License。 查询设备绑定的用户。 #### 返回 [#返回-1] - 0:方法调用成功。 - < 0:方法调用失败。 ### agora_iot_license_activate [#agora_iot_license_activate] ```c int agora_iot_license_activate(const char *appid, const char *key, const char *secret, const char *product_key, const char *device_id, const char *pid, char **cert); ``` 激活 License 并生成证书。每次激活将消耗一个 License 额度。 #### 参数 [#参数-2] | 参数 | 描述 | | --- | --- | | [in] `appid` | 你的声网 App ID。可以从声网灵隼控制台的**应用配置**页面的**开发者选项**选项卡中获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `key` | 你的 Restful API Customer ID。可以从声网灵隼控制台的**应用配置**页面的**开发者选项**选项卡中获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `secret` | 你的 Restful API Customer Secret。可以从声网灵隼控制台的**应用配置**页面的**开发者选项**选项卡中获取。详见[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `product_key` | 你的 Product Key。可以从声网灵隼控制台的**应用配置**页面的**开发者选项**选项卡中获取。详见 [开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)。 | | [in] `device_id` | [device-manager-html-2-5-1 details](#table-slot-device-manager-html-2-5-1) | | [in] `pid` | 你的 PID。可以从声网灵隼控制台的用量查看页面中获取。 | | [out] `cert` | 激活成功后生成的证书。License 激活成功后,接口将返回获取到的 License 检验证书,用于 SDK 初始化的授权凭证,你需要保存证书到配置文件或 Flash 中,下次运行时从文件或 Flash 中获取证书。 | **device-manager-html-2-5-1 details** 你的设备 ID。你需要自行设置。每个设备的设备 ID 必须是唯一的。长度为 1 ~ 128 个字符。字符集支持: - 26 个大写英文字母和小写英文字母。 - 阿拉伯数字: 0-9。 - 特殊符号:`":"`、`"_"`、`"-"`。 设备 ID 与 License 绑定。参考[开通并配置声网灵隼服务](/zh-CN/solutions/iot-apaas/build/setup-and-access/license)获取免费或商业 License。 #### 返回 [#返回-2] - 0:方法调用成功。 - < 0:方法调用失败。 ## 常量 [#常量] ### AGORA_IOT_CERTIFICATE_MAX_LEN [#agora_iot_certificate_max_len] ```c #define AGORA_IOT_CERTIFICATE_MAX_LEN 2048 ``` 证书最大长度。 ### AGORA_IOT_PRIVATE_KEY_MAX_LEN [#agora_iot_private_key_max_len] ```c #define AGORA_IOT_PRIVATE_KEY_MAX_LEN 2048 ``` 私钥最大长度。 ### AGORA_IOT_DOMAIN_MAX_LEN [#agora_iot_domain_max_len] ```c #define AGORA_IOT_DOMAIN_MAX_LEN 256 ``` 域名最大长度。 ## 类型定义 [#类型定义] ### agora_iot_device_info_t [#agora_iot_device_info_t] ```c typedef struct agora_iot_device_info { char certificate[AGORA_IOT_CERTIFICATE_MAX_LEN]; char private_key[AGORA_IOT_PRIVATE_KEY_MAX_LEN]; char domain[AGORA_IOT_DOMAIN_MAX_LEN]; char client_id[AGORA_IOT_CLIENT_ID_MAX_LEN]; } agora_iot_device_info_t; ``` 设备信息。 | 参数 | 描述 | | --- | --- | | `certificate[AGORA_IOT_CERTIFICATE_MAX_LEN]` | 设备证书。 | | `private_key[AGORA_IOT_PRIVATE_KEY_MAX_LEN]` | 设备私钥。 | | `domain[AGORA_IOT_DOMAIN_MAX_LEN]` | 域名。 | | `client_id[AGORA_IOT_CLIENT_ID_MAX_LEN]` | Client ID。用于呼叫。 |