物联网智能视频服务(消费版) 自定义信令模块

本模块提供自定义信令与后台服务器数据收发功能。

一、使用流程

模块初始化 > 发送数据 / 接收数据 > 模块去初始化。

二、接口参考

该功能模块提供以下接口：

·iv_uc_init：自定义模块初始化。

·iv_uc_exit：自定义模块去初始化。

·iv_uc_send_msg：自定义信令发送。

用户需注册以下回调函数

iv_uc_recv_msg_cb：自定义信令接收回调。

三、iv_uc_init

功能描述

自定义信令模块的初始化。包括自定义信令接口回调注册、消息通信初始化等。

函数原型

int iv_uc_init(iv_uc_init_parm_s *pstInitParm);

参数说明

返回值

四、iv_uc_exit

功能描述

自定义信令模块去初始化。

函数原型

int iv_uc_exit(void);

参数说明

无

返回值

五、iv_uc_send_msg

功能描述

发送自定义信令。

函数原型

uint32_t iv_uc_send_msg(void *pUcData, uint32_t u32UcDataLen);

参数说明

返回值

六、iv_uc_recv_msg_cb

功能描述

自定义信令接收回调。

函数原型

void (*iv_uc_recv_msg_cb)(void *pUcData, uint32_t u32UcDataLen);

参数说明

返回值

无

七、数据结构

该模块提供以下数据结构：

iv_uc_init_parm_s：初始化参数。

八、iv_uc_init_parm_s

功能描述

初始化参数。

结构原型

typedef struct iv_uc_init_parm_s{ void (*iv_uc_recv_msg_cb)(void *pUcData, uint32_t u32UcDataLen);}iv_uc_init_parm_s;;

参数说明

九、注意事项

1. 该模块初始化需要在系统模块、物模型模块初始化完成后才能进行模块初始化，初始化成功后即可调用发送数据接口或接收数据回调进行自定义信令的收发。

2. 自定义信令发送和接收的实际消息长度以接口数据长度入参为准。

十、1. 自定义信令模块初始化

int user_cmd_init(void){ int eErrCode = 0; iv_uc_init_parm_s stUCInitParm; stUCInitParm.iv_uc_recv_msg_cb = userCmd_recv_msg; eErrCode = iv_uc_init(&stUCInitParm); if (eErrCode < 0) { Log_e("iv_uc_init error:%d", eErrCode); } return eErrCode;}

十一、2. 自定义信令模块退出

int iv_uc_exit(void)

十二、3. 自定义信令接收

static void userCmd_recv_msg(void *pUcData, uint32_t u32UcDataLen){ char msgbuf[1024] = {0}; if (u32UcDataLen >= sizeof(msgbuf)) { Log_e("recv msg buf is not enough, datalen:%u", u32UcDataLen); return; }  memcpy(msgbuf, pUcData, u32UcDataLen); return;}