1. 项目简介

TacviewConnector-QT是一款基于 C++/Qt 框架开发的桌面应用程序，其核心功能是将外部仿真系统的空战数据实时推送到回放客户端，使操作人员能够在 Tacview 中以三维视角实时观察仿真态势。

Tacview 是飞行模拟领域广泛使用的空战回放和分析工具，支持通过 ACMI（Air Combat Maneuvering Instrumentation）格式记录和回放飞行数据。本项目实现了 Tacview 的实时遥测协议（Real-Time Telemetry），通过 TCP 网络连接将仿真帧数据以 ACMI 文本格式流式推送给 Tacview 客户端，从而实现"边仿真、边回放"的实时态势展示效果。

2. 核心架构

项目采用经典的生产者-消费者模式，整体架构分为三层：

2.1 UI 层 — MainWindow

主窗口使用 Qt Widgets 构建（通过.ui文件设计），提供以下交互功能：

功能	说明
服务器设置	可配置监听端口（默认 42674）和帧间隔（默认 100ms），一键连接/断开
仿真控制	开始、暂停/继续、停止仿真，实时显示当前帧号和仿真时间
实体数据表	3 行 x 8 列表格，实时显示蓝方 F-35、红方 F-22、AIM-120C 导弹的名称、阵营、经纬度、高度和姿态角
状态指示	以彩色圆点实时显示服务器和 Tacview 客户端的连接状态（灰/橙/绿）

2.2 仿真层 — SimWorker

SimWorker 继承QThread，在独立线程中运行仿真循环，不阻塞 UI。内置一套完整的演示场景，每帧按照时间线编排各种事件：

蓝方 F-35：持续飞行，正弦波模拟爬升/下降，周期性释放热诱弹

红方 F-22：持续飞行，反向正弦波模拟爬升/下降，周期性释放箔条弹，第 200 帧后开启雷达传感器

AIM-120C 导弹：第 101~201 帧从红方 F-22 位置发射并飞行，第 201 帧销毁

航路管理：红/蓝双方航路的添加、删除和随机重建

雷达威胁区：红方雷达传感器在第 200 帧后激活

仿真数据通过dataUpdated信号（跨线程安全传递）通知 UI 刷新，同时通过 API 调用将数据投递给 TacviewServer。

2.3 传输层 — TacviewServer

TacviewServer 是整个项目的核心，负责与 Tacview 客户端进行 TCP 通信，实现了完整的 Tacview 实时遥测协议：

协议握手流程：

服务端监听指定端口，等待 Tacview 客户端连接

客户端连接后，服务端发送握手标识：XtraLib.Stream.0\nTacview.RealTimeTelemetry.0\nhunter\n\0

客户端回复后，服务端发送 ACMI 文件头（FileType=text/acmi/tacview\nFileVersion=2.2\n）和参考时间

握手完成，帧定时器开始按固定间隔推送数据

数据推送机制：

TacviewServer 内部维护了多个待处理队列（QQueue），外部调用者通过以下 API 将数据投递到队列中：

帧定时器每帧按以下顺序处理数据：

处理实体删除请求
处理航路删除请求
处理传感器删除请求
构建时间戳头（RecordingTime+#帧时间）
创建箔条弹对象（带随机位置散布和自动到期清理）
创建热诱弹对象（同上）
发送航路更新数据
发送传感器更新数据
发送实体位置更新/创建数据
发送带雷达属性的实体数据
清理到期的箔条弹/热诱弹对象

这种队列化的设计使得仿真线程和网络发送线程实现了松耦合，任何线程都可以安全地调用 API 投递数据。

3. 数据类型体系

项目在TacviewTypes.h中定义了完整的数据类型体系：

每种数据类型都提供了toString()/toStringUpdate()/toStringCreate()方法，可将自身序列化为 Tacview ACMI 文本格式。

4. 技术特性

特性	说明
实时遥测协议	完整实现 Tacview Real-Time Telemetry 协议，支持 TCP 连接、握手、ACMI 格式数据流
多线程架构	UI 线程、仿真线程、网络发送通过信号/槽和原子变量协调，线程安全
队列化发送	所有数据操作通过内部队列缓冲，由帧定时器统一处理，实现生产者-消费者解耦
箔条弹/热诱弹模拟	支持创建带随机散布的箔条弹和热诱弹对象，自动按时清理
雷达威胁区	支持为实体挂载雷达传感器属性（波束宽度、探测距离、方位等）
航路管理	支持创建/删除/动态重建航路，航路点通过 Next 链接串联
可配置参数	帧间隔、监听端口、箔条弹散布系数、持续时间、重绘模式均可调整
FD 版本兼容	通过 `FD_VERSION` 编译宏支持与外部仿真系统的数据转换
跨平台	基于 Qt 框架，支持 Windows / Linux 编译运行
C++17	使用 C++17 标准，`std::atomic` 确保线程安全