1. 课程导入

无人机地面站（GCS）是操作员与飞行器之间的核心交互界面，而视频显示与录像模块则是地面站中信息密度最高、实时性要求最强的子系统之一。无论是巡检、测绘、安防还是应急救援，操作员都需要通过地面站实时观察机载相机回传的画面，并在必要时将关键片段完整录制下来，用于事后分析、取证或成果归档。本课程围绕“视频从机载端到地面端，再到显示与落盘”的完整链路展开，帮助学习者建立从协议解析到界面渲染、从解码播放到文件封装的全栈开发能力。

一、学习目标与能力定位

本课程的目标不是简单调用一个播放器控件，而是让学习者理解并掌握地面站视频子系统的完整工程实现。完成课程后，应具备以下能力：

• 理解无人机视频链路的典型架构，包括机载编码、无线传输、地面接收与解码显示四个阶段；
• 掌握 RTSP、RTMP、UDP、RTP 等常见视频传输协议在地面站场景中的选型与配置方法；
• 能够使用 FFmpeg、GStreamer 或硬件解码 SDK 完成视频流的拉取、解码与帧回调；
• 能够在 Qt、C#/WPF 或 Web 前端中实现低延迟视频显示，并叠加 OSD 飞行参数；
• 能够设计录像模块，实现按需录制、分段存储、时间戳对齐与文件索引；
• 能够对视频延迟、花屏、卡顿、丢包等常见问题进行定位与优化。

二、核心概念与整体框架

地面站视频子系统可以抽象为一条“采集—传输—解码—渲染—存储”的数据流水线。机载相机输出原始视频，经编码器压缩为 H.264/H.265 码流，通过图传链路以 RTP/UDP 或 RTSP 方式发送到地面站；地面站接收后完成解封装、解码，得到 YUV 或 RGB 帧，再送入显示控件渲染，同时可选择将码流或解码帧写入录像文件。

理解这条链路的关键在于区分“码流”和“帧”两个层次：码流是压缩后的数据，体积小但不可直接显示；帧是解码后的图像，可直接渲染但占用带宽和内存。录像模块通常有两种策略：一是直接转存码流（不重新编码，CPU 占用低，但需要封装容器）；二是录制解码后的帧（可叠加 OSD，但需要重新编码，CPU/GPU 占用高）。实际项目中，前者更常见。

三、方法流程：从拉流到落盘的典型步骤

一个可运行的地面站视频模块，通常按以下流程搭建。建议在课程实践中逐步实现，而不是一次性堆叠所有功能。

1. 确定视频源与协议：明确机载端输出的是 RTSP 地址、RTMP 推流地址，还是裸 RTP/UDP 码流。不同协议决定后续拉流方式。
2. 搭建拉流与解封装：使用 FFmpeg 的 avformat_open_input 打开流，读取 packet，获取视频流索引与编码参数。
3. 初始化解码器：根据 codec_id 查找 H.264/H.265 解码器，配置线程数或启用硬件加速（如 DXVA、VAAPI、NVENC/NVDEC）。
4. 解码并管理帧队列：将 packet 送入解码器，取出 AVFrame，转换为显示所需的像素格式，放入有界队列，避免内存无限增长。
5. 渲染显示：在 UI 线程中定时取帧，绘制到 QLabel、Image 控件或 OpenGL 纹理上，并叠加 OSD 信息。
6. 录像落盘：可选择直接写码流到 MP4/TS，或将解码帧重新编码后写入。需处理文件分段、时间戳和异常断电保护。

# 常用调试命令示例
ffprobe -v error -show_streams rtsp://192.168.1.10:8554/video
ffmpeg -i rtsp://192.168.1.10:8554/video -c copy -f mp4 record_01.mp4
gst-launch-1.0 rtspsrc location=rtsp://192.168.1.10:8554/video ! rtph264depay ! h264parse ! avdec_h264 ! autovideosink

四、案例场景：巡检任务中的视频显示与录像

假设某电力巡检无人机通过 4G 图传将 1080p@30fps 的 H.264 码流推送到地面站。操作员需要在大屏上实时观察绝缘子细节，同时全程录像以备复查。此时地面站面临三个现实约束：一是 4G 网络抖动大，容易出现丢包和延迟突增；二是录像文件必须可被普通播放器打开，且时间戳与飞行日志对齐；三是 UI 不能因为解码阻塞而卡死。

合理的做法是：接收线程只负责收包和解封装，解码线程独立运行，渲染线程通过帧队列取最新帧并丢弃过期帧，录像线程将原始码流按时间分段写入 MP4。这样即使网络短时抖动，显示端也只是短暂花屏或跳帧，而不会导致整个界面无响应。录像文件则通过关键帧对齐分段，保证每段可独立播放。

五、常见误区与复盘要点