114 lines
3.1 KiB
C++
114 lines
3.1 KiB
C++
#ifndef IBINOCULARMARKRECEIVER_H
|
||
#define IBINOCULARMARKRECEIVER_H
|
||
|
||
#include <functional>
|
||
#include <vector>
|
||
#include <string>
|
||
#include <QtGlobal> // 提供qint64、quint16等Qt基本类型
|
||
|
||
/**
|
||
* @brief 通用 Mark 3D 数据结构
|
||
* 不依赖具体算法库的 Mark 数据定义
|
||
*/
|
||
struct VrMark3D
|
||
{
|
||
int markID; // Mark ID
|
||
double x; // X 坐标
|
||
double y; // Y 坐标
|
||
double z; // Z 坐标
|
||
|
||
VrMark3D() : markID(-1), x(0.0), y(0.0), z(0.0) {}
|
||
VrMark3D(int id, double _x, double _y, double _z)
|
||
: markID(id), x(_x), y(_y), z(_z) {}
|
||
};
|
||
|
||
/**
|
||
* @brief 双目Mark数据接收器接口
|
||
* 用于从BinocularMarkApp接收3D Mark检测结果
|
||
*/
|
||
class IBinocularMarkReceiver
|
||
{
|
||
public:
|
||
virtual ~IBinocularMarkReceiver() = default;
|
||
|
||
/**
|
||
* @brief Mark结果回调函数类型
|
||
* @param marks 检测到的3D标记列表
|
||
* @param timestamp 时间戳
|
||
* @param errorCode 错误码（0表示成功）
|
||
*/
|
||
using MarkResultCallback = std::function<void(const std::vector<VrMark3D>& marks,
|
||
qint64 timestamp,
|
||
int errorCode)>;
|
||
|
||
/**
|
||
* @brief 连接状态改变回调函数类型
|
||
* @param connected true-已连接，false-断开连接
|
||
*/
|
||
using ConnectionStatusCallback = std::function<void(bool connected)>;
|
||
|
||
/**
|
||
* @brief 启动TCP客户端并连接到服务器
|
||
* @param serverIp 服务器IP地址
|
||
* @param serverPort 服务器端口
|
||
* @return 0-成功，其他-失败
|
||
*/
|
||
virtual int Connect(const std::string& serverIp, quint16 serverPort) = 0;
|
||
|
||
/**
|
||
* @brief 断开连接
|
||
* @return 0-成功，其他-失败
|
||
*/
|
||
virtual int Disconnect() = 0;
|
||
|
||
/**
|
||
* @brief 检查是否已连接
|
||
* @return true-已连接，false-未连接
|
||
*/
|
||
virtual bool IsConnected() const = 0;
|
||
|
||
/**
|
||
* @brief 发送心跳消息
|
||
* @return 0-成功，其他-失败
|
||
*/
|
||
virtual int SendHeartbeat() = 0;
|
||
|
||
/**
|
||
* @brief 发送触发检测命令
|
||
* @return 0-成功，其他-失败
|
||
*/
|
||
virtual int TriggerDetection() = 0;
|
||
|
||
/**
|
||
* @brief 设置Mark结果回调
|
||
* @param callback 回调函数
|
||
*/
|
||
virtual void SetMarkResultCallback(MarkResultCallback callback) = 0;
|
||
|
||
/**
|
||
* @brief 设置连接状态回调
|
||
* @param callback 回调函数
|
||
*/
|
||
virtual void SetConnectionStatusCallback(ConnectionStatusCallback callback) = 0;
|
||
|
||
/**
|
||
* @brief 启动心跳定时器
|
||
* @param intervalSeconds 心跳间隔（秒），默认30秒
|
||
*/
|
||
virtual void StartHeartbeat(int intervalSeconds = 30) = 0;
|
||
|
||
/**
|
||
* @brief 停止心跳定时器
|
||
*/
|
||
virtual void StopHeartbeat() = 0;
|
||
|
||
/**
|
||
* @brief 创建BinocularMarkReceiver实例
|
||
* @param ppReceiver 接收器实例指针
|
||
* @return 0-成功，其他-失败
|
||
*/
|
||
static int CreateInstance(IBinocularMarkReceiver** ppReceiver);
|
||
};
|
||
|
||
#endif // IBINOCULARMARKRECEIVER_H
|