FStarRTool_project_handbook

项目：FStarRTool — C++/Qt + FFmpeg 屏幕录像工具

技术栈：Qt 6.5 · FFmpeg 8.0 · C++17 · qMake/CMake

总代码量：≈ 2000 行 | 新建 10 个文件 | 修改 12 次

这个项目你能学到什么？

1. 技术能力提升

2. 核心设计模式

3. 面试加分点

4. 学完后能做什么

一、七天计划总览表

二、每日知识点详解表

三、项目文件结构表

四、学习路线图

Day 0 ─── 环境搭建 ── Qt 6.5 + FFmpeg + CMake
  │
Day 1 ─── Qt 基础 ──── 信号与槽、应用结构、基础控件
  │
Day 2 ─── Qt UI ───── 布局管理器、QSS 样式、对话框
  │
Day 3 ─── FFmpeg CLI ── 屏幕录制、编码参数、音频捕获
  │
Day 4 ─── Qt 进程 ──── QProcess、QTimer、事件系统、区域选择
  │
Day 5 ─── Qt 绘图 ──── QPainter、ScreenRecorder、系统托盘
  │
Day 6 ─── FFmpeg API ── libav* 编码流程、像素格式、配置持久化
  │
Day 7 ─── 综合实战 ──── 编译打包、功能扩展、优化方向
  │
  └──→ 独立开发能力：Qt 桌面应用 + 音视频处理 + 系统工具

部分技术点讲解

一、框架

项目框架

FStarRTool/
├── main.cpp                 # 程序入口
├── mainwindow.h/cpp         # 主窗口 UI 和逻辑
├── screenrecorder.h/cpp     # FFmpeg 进程封装
├── screenselector.h/cpp     # 窗口/区域选择
├── regionselectdialog.h/cpp # 区域选择对话框
├── settingsdialog.h/cpp     # 设置对话框
└── videoencoder.h/cpp       # FFmpeg 库编码器（可选）

知识体系框架

┌─────────────────────────────────────────────────────────────────┐
│                    FStarRTool 知识体系                          │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │   C++ 基础   │  │   Qt 框架   │  │  操作系统   │              │
│  │  • 类与对象  │  │  • 信号槽   │  │  • 进程管理 │              │
│  │  • 继承多态  │  │  • 事件系统 │  │  • 窗口管理 │              │
│  │  • 智能指针  │  │  • 布局     │  │  • 设备枚举 │              │
│  └─────────────┘  └─────────────┘  └─────────────┘              │
│                                                                  │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │   多媒体    │  │   UI/UX     │  │   工程实践  │              │
│  │  • FFmpeg   │  │  • 拖拽选择 │  │  • 模块化   │              │
│  │  • 音频捕获 │  │  • 实时绘制 │  │  • 配置管理 │              │
│  │  • 视频编码 │  │  • 托盘图标 │  │  • 错误处理 │              │
│  │  • 设备检测 │  │  • 悬浮窗   │  │  • 打包部署 │              │
│  └─────────────┘  └─────────────┘  └─────────────┘              │
└─────────────────────────────────────────────────────────────────┘

执行流程图

用户启动程序
    ↓
main() 初始化 QApplication
    ↓
创建 MainWindow
    ↓
setupUI() 创建界面
    ↓
用户点击"开始录制"
    ↓
startRecording() 调用
    ↓
recorder->start() 启动 FFmpeg
    ↓
recordingStarted 信号 → onRecordingStarted 槽
    ↓
FFmpeg 进程录制
    ↓
用户点击"停止"
    ↓
stopRecording() 调用
    ↓
recordingStopped 信号
    ↓
视频文件保存

二、屏幕捕获技术

1. Windows GDI 抓取（GDIGrab）

args << "-f" << "gdigrab";
args << "-i" << "desktop";

• 使用 FFmpeg 的 gdigrab 输入设备
• 支持指定录制区域（-offset_x/y、-video_size）

2. 三种录制模式

3. 跨平台窗口检测

#ifdef Q_OS_WIN
#include <windows.h>
HWND hwnd = WindowFromPoint(pt);
while (GetParent(hwnd) != NULL) hwnd = GetParent(hwnd);
#endif

部分面试题

3.1 项目设计类

Q1: 为什么要自己开发录屏工具？市场上不是有很多现成的吗？

标准答案：

主要有三个原因：
1. 学习目的：深入理解音视频处理原理，从零搭建完整项目
2. 定制需求：现有录屏工具要么收费（如 FastStone），要么功能冗余（如 OBS）
3. 技术验证：验证 Qt + FFmpeg 组合的可行性，为后续直播项目打基础

项目规模约 2000 行代码，核心模块包括：
- ScreenRecorder：FFmpeg 进程管理
- ScreenSelector：区域/窗口选择
- RegionSelectDialog：多种区域选择方式
- SettingsDialog：配置管理

Q2: 项目的整体架构是什么？

标准答案：

采用 MVC 变体架构：

┌─────────────────────────────────────────────────────┐
│                    MainWindow (View + Controller)    │
│  - UI 控件管理                                        │
│  - 用户交互响应                                       │
│  - 信号槽连接                                         │
├─────────────────────────────────────────────────────┤
│                  ScreenRecorder (Model)              │
│  - FFmpeg 进程封装                                    │
│  - 录制参数管理                                       │
│  - 错误处理                                          │
├─────────────────────────────────────────────────────┤
│                   辅助组件                            │
│  - ScreenSelector: 窗口/区域选择                      │
│  - RegionSelectDialog: 区域选择对话框                 │
│  - SettingsDialog: 设置管理                          │
│  - RecordingControlWidget: 悬浮控制栏                │
└─────────────────────────────────────────────────────┘

通信方式：Qt 信号槽（解耦）
数据持久化：QSettings（注册表/INI文件）

3.2 技术实现类

Q4: 如何实现窗口录制？如何找到鼠标下的窗口？

答案：

// 核心：Windows API + 跨平台条件编译
QRect ScreenSelector::getWindowGeometry(const QPoint &pos) {
#ifdef Q_OS_WIN
    POINT pt = {pos.x(), pos.y()};
    HWND hwnd = WindowFromPoint(pt);
    
    // 关键：获取顶层窗口（而不是子窗口）
    while (GetParent(hwnd) != NULL) {
        hwnd = GetParent(hwnd);
    }
    
    // 排除桌面窗口
    if (hwnd == GetDesktopWindow()) {
        return QRect();  // 无效
    }
    
    RECT rect;
    if (GetWindowRect(hwnd, &rect)) {
        return QRect(rect.left, rect.top, 
                     rect.right - rect.left, 
                     rect.bottom - rect.top);
    }
#endif
    return QRect();
}

【扩展讨论】
- 为什么需要 GetParent 循环？
  因为 WindowFromPoint 可能返回子窗口（如按钮），需要找到根窗口
  
- 如何处理最小化窗口？
  IsIconic(hwnd) 检查，如果是则无法获取有效矩形
  
- 跨平台方案？
  macOS: CGWindowListCopyWindowInfo
  Linux: XQueryTree + XGetWindowAttributes

Q5: 区域选择时的橡皮筋效果如何实现？

答案：

【核心思路：绘制叠加层 + 清除遮罩】

void ScreenSelector::paintEvent(QPaintEvent *event) {
    QPainter painter(this);
    
    // 1. 绘制截图背景
    painter.drawPixmap(0, 0, m_screenPixmap);
    
    // 2. 绘制半透明黑色遮罩（覆盖全屏）
    painter.fillRect(rect(), QColor(0, 0, 0, 100));
    
    // 3. 清除选中区域的遮罩（露出原图）
    if (m_selecting) {
        QRect selectedArea = QRect(m_startPoint, m_currentPoint);
        
        // 关键：CompositionMode_Clear 清除该区域
        painter.setCompositionMode(QPainter::CompositionMode_Clear);
        painter.fillRect(selectedArea, Qt::transparent);
        painter.setCompositionMode(QPainter::CompositionMode_SourceOver);
        
        // 4. 绘制选择框边框
        painter.setPen(QPen(QColor(0, 120, 215), 2));
        painter.drawRect(selectedArea);
    }
}

【技术点】
- QRubberBand：Qt 内置橡皮筋控件，可简化实现
- 为什么用 CompositionMode_Clear？高效，无需二次截图
- 如何确保精确性？记录鼠标按下和释放时的坐标

部分简历模板

模板一：C++ 开发工程师（综合型）

项目经历

FStarRTool — 桌面屏幕录像工具 | 个人项目 | 2025.01 - 2025.03

• 基于 Qt 6.5 框架独立开发了一款功能完整的桌面屏幕录像软件，支持全屏、窗口、自定义区域三种录制模式
• 集成 FFmpeg 8.0.1 音视频编解码能力，支持 H.264 / H.265 / VP9 / AV1 四种视频编码和 AAC / MP3 / Opus 三种音频编码
• 使用 DirectShow API 实现 Windows 音频设备自动检测与采集，支持系统音频（立体声混音）和麦克风双通道录制
• 实现了基于 GDI Grab 的屏幕截图采集、libswscale 色彩空间转换、libavcodec 视频编码的完整数据管线
• 通过 QSystemTrayIcon 实现系统托盘驻留与最小化录制，QSettings 实现配置持久化，支持快捷键操作

技术关键词： C++17, Qt 6.5, FFmpeg, libavcodec, libavformat, libswscale, DirectShow, GDI, 信号槽机制, QProcess, 多媒体编解码