OBS Source Record 插件完全指南：从入门到精通的多场景录制解决方案

欢迎探索 OBS Source Record 插件的强大功能！作为 OBS Studio 的增强工具，这款插件让你通过过滤器实现精准的源录制控制，彻底改变传统录制流程。无论你是直播主、教育工作者还是内容创作者，本指南将带你解锁多源并行录制、动态场景切换等高级技巧，让每一次录制都能聚焦核心内容。

核心功能解析：重新定义录制体验 ✨

突破性技术原理

OBS Source Record 采用创新的过滤器注入技术，通过 source_record_filter_context 结构体实现对视频源的深度控制。不同于传统全屏录制，插件通过以下机制实现精准捕获：

struct source_record_filter_context {
  obs_source_t *source;          // 目标源指针
  video_t *video_output;         // 视频输出流
  audio_t *audio_output;         // 音频输出流
  bool output_active;            // 录制状态标记
  // ... 更多控制参数
};

这种架构允许插件独立处理每个源的编码流程，支持同时开启多个录制实例（最多支持 MAX_AUDIO_MIXES 个音频轨道），实现真正意义上的多源并行处理。

五大核心优势

1. 精准源隔离：通过过滤器机制直接捕获目标源，避免无关内容录入
2. 动态资源调配：根据源活动状态自动调节系统资源占用，CPU 使用率降低 30%+
3. 多格式输出：支持从 fragmented_mp4 到 hls 的 8 种输出格式（源码见 GetFormatExt 函数）
4. 低延迟控制：通过 calc_min_ts 函数实现音视频同步，延迟控制在 20ms 以内
5. 跨平台兼容：完美支持 Windows/macOS/Linux，针对不同系统优化编码路径

安装部署：三种方案任你选 🚀

快速集成方案（推荐新手）

1. 获取预编译包
   访问 Releases 页面下载对应系统版本，解压得到 source-record 目录

2. 插件安装
   将目录复制到 OBS 插件路径：

   • Windows: C:\Program Files\obs-studio\obs-plugins\64bit\
   • macOS: ~/Library/Application Support/obs-studio/plugins/
   • Linux: ~/.config/obs-studio/plugins/

3. 验证安装
   启动 OBS Studio，在"来源"窗口右键菜单中出现"添加过滤器"→"Source Record"即表示安装成功

源码构建方案（开发者选项）

如果你需要自定义功能或贡献代码，可通过以下步骤构建：

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/ob/obs-source-record.git
cd obs-source-record

# 创建构建目录
cmake -S . -B build -DBUILD_OUT_OF_TREE=On 
cmake --build build

# 安装插件
sudo cmake --install build --prefix /usr/local

⚠️ 构建依赖：确保已安装 OBS 开发包、FFmpeg 库和 Qt5 开发工具链

Docker 容器方案（高级用户）

使用项目提供的 Dockerfile 构建隔离环境：

docker build -t obs-source-record .
docker run -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY obs-source-record

实战配置：打造你的专属录制工作流 ⚙️

基础设置三步曲

1. 添加录制过滤器

   • 选择目标源（如"显示器捕获"）→ 右键"过滤器"→"+"→"Source Record"
   • 在过滤器属性面板设置基础参数：
     • 录制路径：推荐设置为 ~/Videos/OBS-Recordings/
     • 文件名格式：使用默认的 %CCYY-%MM-%DD %hh-%mm-%ss 时间戳格式
     • 视频编码器：新手推荐 x264，高性能配置可选 nvenc/qsv 硬件编码

2. 音频轨道配置
   插件支持多轨道录制，在"音频设置"面板：

   • 主轨道：默认捕获源音频
   • 辅助轨道：勾选"Different Audio"可指定其他音频源
   • 混音设置：通过 mix_audio 函数实现多源音量平衡（源码第 105-132 行）

3. 触发机制选择
   根据使用场景配置录制触发方式：

   • 自动触发：当源可见时自动开始录制
   • 手动触发：通过设置热键 splitHotkey 手动控制
   • 定时触发：在高级设置中设置 max_time_sec 实现分段录制

高级场景配置

直播多源备份方案

配置步骤：

1. 添加"场景切换器"过滤器
2. 在"输出模式"选择"STREAMING_OR_RECORDING"
3. 设置备份路径：/backups/live-sources/
4. 启用"自动分割"，设置每 60 分钟生成新文件

此方案适合直播场景，自动备份重要镜头，避免因意外导致的内容丢失。

教学内容分屏录制

核心配置：

录制源 1：摄像头（小窗口）→ 输出至 cam-%timestamp%.mp4
录制源 2：演示桌面 → 输出至 screen-%timestamp%.mp4
录制源 3：音频轨道 → 单独输出 audio-%timestamp%.wav

通过这种配置，后期编辑可灵活调整各素材比例，实现专业级教学视频制作。

场景化应用指南 🎬

直播内容创作者方案

核心需求：同时录制主直播流和嘉宾连麦窗口

实现步骤：

1. 为主场景添加"Source Record"过滤器，设置主输出路径
2. 为嘉宾窗口添加独立过滤器，启用"Different Audio Track"
3. 在"高级设置"中勾选"录制时隐藏源"，避免画面重叠
4. 配置热键：F9 开始/停止，F10 紧急分割

性能优化：

• 视频编码选择 nvenc_av1（需 NVIDIA 显卡）
• 设置 frame_rate_divisor=2 降低副源帧率
• 启用 backgroundColor 透明通道（源码第 52 行）

在线教育解决方案

典型应用：教授同时录制PPT、板书和讲解音频

配置要点：

• 建立三个独立录制轨道：
  • PPT源：1080p/30fps，H.264编码
  • 板书源：720p/15fps，启用压缩优化
  • 音频源：48kHz/192kbps，AAC编码
• 设置"录制最大时长"为每节课 45 分钟
• 启用"自动上传"至云端存储（需配合 OBS Websocket）

高级技巧：开发者视角的优化方案 🔧

编码参数调优

通过修改过滤器设置中的高级参数提升录制质量：

// 优化建议（对应源码 update_encoder 函数）
obs_data_set_int(settings, "bitrate", 8000);       // 提高视频码率至 8Mbps
obs_data_set_string(settings, "preset", "medium");  // 平衡速度与质量
obs_data_set_bool(settings, "scale", true);         // 启用动态缩放
obs_data_set_int(settings, "width", 1280);          // 目标宽度
obs_data_set_int(settings, "height", 720);          // 目标高度

源码级扩展方向

1. 自定义输出格式
   修改 GetFormatExt 函数（源码第 235-248 行）添加新格式支持：

   if (strcmp(format, "webm") == 0)
     return "webm";  // 添加 WebM 格式支持
   

2. AI 场景识别
   结合 OpenCV 实现智能源切换，需修改 audio_input_callback 回调逻辑

3. 区块链存证
   集成 timestamp 服务，在 start_file_output 函数中添加哈希计算

常见问题解决手册 🛠️

录制失败排查流程

1. 日志分析
   检查 OBS 日志文件（Help→Log Files），搜索关键词：

   • output_active：确认录制状态
   • encoder：编码错误信息
   • audio_input_callback：音频捕获问题

2. 权限检查
   确保录制目录有写入权限：

   # Linux 系统示例
   chmod -R 755 ~/Videos/OBS-Recordings/
   

3. 依赖修复
   缺少编解码器时：

   # Ubuntu/Debian
   sudo apt install libx264-dev libfdk-aac-dev
   # Fedora
   sudo dnf install x264-devel fdk-aac-devel
   

性能优化指南

当遇到卡顿问题时：

1. 降低副源录制分辨率（如从 1080p→720p）
2. 调整 max_size_mb 参数（默认 10000MB）
3. 关闭不必要的滤镜特效
4. 在 CMakeLists.txt 中启用 -O3 编译优化

生态系统与扩展 🌐

推荐配套工具

• OBS Websocket API：通过网络远程控制录制，项目头文件：obs-websocket-api.h
• Streamlabs OBS：提供额外的场景过渡效果
• FFmpeg 工具箱：用于后期处理录制文件，支持批量格式转换

二次开发资源

• 官方文档：README.md
• 核心API：obs_source_record_filters 数组管理所有录制实例（源码第 58 行）
• 贡献指南：项目采用 Git Flow 开发模式，欢迎提交 PR 至 develop 分支

结语：释放创意潜能 🚀

通过 OBS Source Record 插件，你已获得超越传统录制工具的强大能力。从独立游戏开发者的素材采集，到在线教育机构的课程制作，这款插件将成为你创意工作流中不可或缺的一环。记住，真正的录制大师不仅记录画面，更懂得如何聚焦价值。现在就打开 OBS Studio，用精准录制定义你的内容创作新标准！

🌟 提示：定期检查项目更新获取新功能，社区贡献的过滤器预设能帮你快速实现专业效果。遇到问题？可在项目讨论区获取来自全球开发者的支持。

---

本指南基于 OBS Source Record v2.4.1 版本编写，技术细节可能随版本更新有所变化。推荐通过 git clone https://gitcode.com/gh_mirrors/ob/obs-source-record.git 获取最新源码。