tencent cloud

实时互动-工业能源版

产品简介
产品概述
产品功能
应用场景
购买指南
免费试用
计费概述
续费与停服
Demo 体验流程
开发指南
多网络路径传输
控制数据传输
控制授权管理
语音对讲
视频观看与切流
现场设备 SDK
基本介绍
SDK API 调用流程
C/C++ 现场设备 SDK API
现场设备配置说明
错误码及排查
远端设备 SDK
基本介绍
SDK 调用过程
C/C++ 远端设备SDK API
远端设备配置说明
错误码及排查
SDK 及 DEMO 下载
现场设备端
远端设备端
常见问题
共性问题
相关协议
实时互动-工业能源版隐私协议
实时互动-工业能源版数据处理协议
服务等级协议
文档实时互动-工业能源版开发指南控制数据传输

控制数据传输

PDF
聚焦模式
字号
最后更新时间： 2025-02-11 16:46:56
说明：
控制数据传输，用于现场设备和远端设备之间的二进制数据通信。两端SDK均提供一个数据发送接口和一个数据接收回调接口。
注意：
现场设备 SDK，数据发送接口会向与该现场设备处于会话连接中的所有远端设备发送数据消息。
远端设备 SDK，数据发送接口可以向会话连接中的指定现场设备发送数据消息，仅当该远端设备拥有现场设备控制权时，才可发送成功。

现场设备：

向远端设备发送数据

说明：
该接口会向与该现场设备处于会话连接中的所有远端设备发送数据消息。 发送消息单条长度限制为700字节，发送频率限制为100Hz。
extern "C" TRRO_EXPORT int TRRO_sendControlData(const char* msg, int len, int qos = 0);
参数
含义
msg
消息内容
len
消息长度
qos
发送 qos 类型。
0：非可靠传输，不会重传
1：可靠传输
返回值
成功：1
失败：<= 0

注册控制消息回调

extern "C" TRRO_EXPORT int TRRO_registerControlDataCallback(void* context, TRRO_onControlData * callback);
参数
含义
context
回调上下文
TRRO_onControlData
回调函数

typedef void TRRO_onControlData(void *context, const char *controller_id, const char* msg, int len, int qos);
参数
含义
context
回调上下文
controller_id
控制端设备id
msg
控制消息字符串
len
字符串长度
qos
消息 qos 类型：
0：不可靠传输，不会重传
1：可靠传输

远端设备

向现场设备发送数据

使用说明：该接口会向会话连接中的指定现场设备发送数据消息，仅当该远端设备拥有现场设备控制权时，才可发送成功。 发送消息单条长度限制为700字节，发送频率限制为100Hz。
extern "C" TRRO_EXPORT int TRRO_sendControlData(const char* gwid, const char* msg, int len, int qos = 0);
参数
含义
gwid
现场设备 ID
msg
发送二进制数据
len
消息长度
qos
发送 qos：
0：不可靠传输
1：可靠传输
返回值
成功：1
失败：<= 0

注册控制消息回调

使用说明：此接口用于注册远端设备 SDK 发送的控制数据回调函数，可根据需要实现。
extern "C" TRRO_EXPORT int TRRO_registerControlDataCallback(void* context, TRRO_onControlData * callback);
参数
含义
context
上下文指针
callback
回调函数

typedef void TRRO_onControlData(void *context, const char *controller_id, const char* msg, int len, int qos);
参数
含义
context
回调上下文
controller_id
远端设备 ID
msg
控制消息字符串
len
字符串长度
qos
消息 qos 类型。
0：不可靠传输
1：可靠传输

上一篇: 多网络路径传输下一篇: 控制授权管理

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈