agora_iot_dp.h

更新时间

本页提供声网灵隼设备端 SDK 的 agora_iot_dp.h 文件的 API 参考。

引用文件

C
#include "agora_iot_base.h"

函数

agora_iot_dp_register_dp_query_handler

C
agora_iot_dp_result_e agora_iot_dp_register_dp_query_handler(agora_iot_handle_t handle, int dp_id,
                                                             agora_dp_type_e dp_type, on_dp_query_callback callback,
                                                             void *args);

注册属性查询回调。

你需要确保已经在控制台通过功能定义页面新增了相应功能。详见开通灵隼服务。

参数

参数描述
[in] handleagora_iot_init 返回的 SDK 句柄。详见 agora_iot_handle_t。
[in] dp_id属性 ID。即控制台功能定义页面的功能标识符。详见开通灵隼服务。
[in] dp_type属性的数据类型。详见 agora_dp_type_e。
[in] callback属性查询回调。详见 on_dp_query_callback。
[in] args回调参数。
表格内容超出当前宽度,可横向滚动查看更多列。

返回

agora_iot_dp_result_e 结构体中的枚举。

agora_iot_dp_register_dp_cmd_handler

C
agora_iot_dp_result_e agora_iot_dp_register_dp_cmd_handler(agora_iot_handle_t handle, int dp_id,
                                                           agora_dp_type_e dp_type, on_dp_cmd_callback callback,
                                                           void *args);                                                         

注册属性命令回调。

你需要确保已经在控制台通过功能定义页面新增了相应功能。详见开通灵隼服务。

参数

参数描述
[in] handleagora_iot_init 返回的 SDK 句柄。详见 agora_iot_handle_t。
[in] dp_id属性 ID。即控制台属性定义页面的属性标识符。参考开通灵隼服务在控制台创建属性。
[in] dp_type属性的数据类型。详见 agora_dp_type_e。
[in] callback属性命令回调。详见 on_dp_cmd_callback。
[in] args回调参数。
表格内容超出当前宽度,可横向滚动查看更多列。

返回

agora_iot_dp_result_e 结构体中的枚举。

agora_iot_dp_publish

C
agora_iot_dp_result_e agora_iot_dp_publish(agora_iot_handle_t handle, agora_dp_info_t *info);

发布一个属性。

你需要确保已经在控制台通过功能定义页面新增了相应属性。详见开通灵隼服务。

参数

参数描述
[in] handleagora_iot_init 返回的 SDK 句柄。详见 agora_iot_handle_t。
[in] info属性信息。详见 agora_dp_info_t。
表格内容超出当前宽度,可横向滚动查看更多列。

返回

agora_iot_dp_result_e 结构体中的枚举。

agora_iot_dp_publish_all

C
agora_iot_dp_result_e agora_iot_dp_publish_all(agora_iot_handle_t handle);

发布全部属性。你需要确保已经在控制台通过功能定义页面新增了相应属性。详见开通灵隼服务。

在发布全部属性之前,确保你已经调用 agora_iot_dp_register_dp_query_handler 注册了属性回调。

参数

参数描述
[in] handleagora_iot_init 返回的 SDK 句柄。详见 agora_iot_handle_t。
表格内容超出当前宽度,可横向滚动查看更多列。

返回

agora_iot_dp_result_e 结构体中的枚举。

常量

AGORA_DP_USER_LEN

C
#define AGORA_DP_USER_LEN     64

属性用户名长度。

AGORA_DP_ID_MIN

C
#define AGORA_DP_ID_MIN       100

属性 ID 长度的最小值。

类型定义

agora_iot_dp_result_e

C
typedef enum {
  ERR_AG_DP_SUCCESS           = ERR_SUCCESS,
  ERR_AG_DP_FAILED            = ERR_FAILED,
  ERR_AG_DP_INVALID_ARGUMENT  = ERR_INVALID_ARGUMENT,
} agora_iot_dp_result_e;

属性函数调用结果。

参数描述
ERR_AG_DP_SUCCESS0:方法调用成功。
ERR_AG_DP_FAILED-1:方法调用失败。
ERR_AG_DP_INVALID_ARGUMENT-2:参数无效。
表格内容超出当前宽度,可横向滚动查看更多列。

agora_dp_type_e

C
typedef enum agora_dp_type {
  AGORA_DP_TYPE_INT           = 0,
  AGORA_DP_TYPE_BOOL          = 1,
  AGORA_DP_TYPE_ENUM          = 2,
  AGORA_DP_TYPE_STR           = 3,
} agora_dp_type_e;

属性类型。

参数描述
AGORA_DP_TYPE_INT0:整数类型。
AGORA_DP_TYPE_BOOL1:布尔类型。
AGORA_DP_TYPE_ENUM2:枚举类型。
AGORA_DP_TYPE_STR3:字符串类型。
表格内容超出当前宽度,可横向滚动查看更多列。

agora_dp_value_t

C
typedef union {
  int dp_int;
  bool dp_bool;
  unsigned int dp_enum;
  char *dp_str;
} agora_dp_value_t;

属性的值。

参数描述
dp_int整数类型的值。
dp_bool布尔类型的值。
dp_enum枚举类型的值。
dp_str字符串类型的值。 SDK 不会自动释放该参数分配的内存。为避免内存泄露,你需要手动管理内存。
表格内容超出当前宽度,可横向滚动查看更多列。

agora_dp_info_t

C
typedef struct agora_dp_info {
  unsigned int dp_id;
  agora_dp_type_e dp_type;
  agora_dp_value_t dp_value;
} agora_dp_info_t;

属性信息。

参数描述
dp_id属性 ID。即控制台功能定义页面的属性标识符。详见开通灵隼服务。
dp_type属性的数据类型。详见 agora_dp_type_e。
dp_value属性的值。详见 agora_dp_value_t。
表格内容超出当前宽度,可横向滚动查看更多列。

on_dp_query_callback

C
typedef void (*on_dp_query_callback)(agora_dp_info_t *info, void *args);

客户端 SDK 通过设备属性方法查询本地属性时触发。

参数

参数描述
[in] info属性信息。详见 agora_dp_info_t。你需要在此参数中传入本地属性的信息。
[in] args回调参数。通过 agora_iot_dp_register_dp_query_handler 传入。
表格内容超出当前宽度,可横向滚动查看更多列。

on_dp_cmd_callback

C
typedef void (*on_dp_cmd_callback)(const agora_dp_info_t *info, void *args);

接收到客户端 SDK 通过设备属性方法发送的命令时触发。

参数

参数描述
[in] info属性信息。详见 agora_dp_info_t。你可以在此参数中传入本地属性或远端属性的信息。
[in] args回调参数。通过 agora_iot_dp_register_dp_cmd_handler 传入。
表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?