obs-multi-rtmp插件全攻略：从项目解析到跨平台直播分发

obs-multi-rtmp插件全攻略：从项目解析到跨平台直播分发

【免费下载链接】obs-multi-rtmp OBS複数サイト同時配信プラグイン 项目地址: https://gitcode.com/gh_mirrors/ob/obs-multi-rtmp

【项目解析】深入理解多平台直播插件的架构设计

核心目录功能权重分析

目录路径	功能描述	权重
src/	包含插件核心实现，如多流配置管理（output-config.h）、协议处理（protocols.h）和UI交互组件	★★★ 核心模块
cmake/	跨平台构建配置，分Linux/macOS/Windows子目录优化编译参数	★★ 辅助功能
data/locale/	40+种语言国际化支持，含zh-CN.ini等本地化配置	★★ 辅助功能
docs/	使用文档和截图资源，包含安装步骤与FAQ	★ 参考资源

📌 要点速记：项目采用CMake构建系统实现跨平台兼容，核心源码通过C++面向对象设计，将视频编码配置（VideoEncoderConfig）、音频轨道管理（AudioTrackConfig）与输出目标（OutputTargetConfig）解耦，支持多协议同时推流。

【环境准备】三步上手多平台部署环境

准备阶段：系统兼容性检查

⚠️ 警告：插件需与OBS Studio版本严格匹配，不兼容可能导致崩溃。建议组合：

• OBS 27.x → 插件v0.2.4及以下
• OBS 28.x+ → 插件v0.3.0+（需支持Qt6）

实施阶段：源码构建流程

1. 获取源码

   git clone https://gitcode.com/gh_mirrors/ob/obs-multi-rtmp.git
   

2. 配置构建环境

   • Linux：安装libobs-dev、cmake、qtbase5-dev
   • Windows：配置OBS Studio SDK路径
   • macOS：通过Homebrew安装依赖

3. 编译安装

   mkdir build && cd build
   cmake .. && make -j4
   sudo make install  # Linux示例
   

验证阶段：插件加载检测

1. 启动OBS Studio
2. 导航至 工具 > 插件
3. 确认"obs-multi-rtmp"出现在列表中，状态为"已加载"

📌 要点速记：项目依赖nlohmann-json处理配置文件，编译前需确保OBS开发环境完整。Windows用户优先使用installer.nsi生成的安装包，避免手动复制文件。

【核心功能】多流推流的配置与管理

多目标输出配置详解

参数名称	数据类型	作用说明
protocol	字符串	推流协议类型（如"rtmp"、"srt"）
syncStart	布尔值	是否与主推流同步开始
videoConfig	可选字符串	关联的视频编码配置ID
audioConfig	可选字符串	关联的音频编码配置ID

新手常见错误示例对比

错误配置	正确配置	原因分析
"server": "rtmp://server"	"protocol": "rtmp", "serviceParam": {"server": "rtmp://server", "key": "xxx"}	协议参数需嵌套在serviceParam对象中
"syncStart": "true"	"syncStart": true	JSON中布尔值无需引号

📌 要点速记：配置文件采用JSON格式，通过GlobalMultiOutputConfig()全局管理。每个输出目标需指定唯一ID和协议类型，视频/音频配置可复用或单独定义，支持场景切换时动态调整推流参数。

【高级配置】跨平台优化与故障排查

三平台配置路径差异

• Windows：%APPDATA%\obs-studio\plugins\obs-multi-rtmp\config.json
• macOS：~/Library/Application Support/obs-studio/plugins/obs-multi-rtmp/config.json
• Linux：~/.config/obs-studio/plugins/obs-multi-rtmp/config.json

故障排查决策树

📌 要点速记：配置文件支持热更新，修改后无需重启OBS。常见问题中，"推流失败"多因协议参数错误，"不同步"需检查syncStart/syncStop标志，"CPU占用高"可尝试降低副流分辨率或启用硬件编码。

图：OBS中obs-multi-rtmp插件的多目标管理界面，支持开关控制与实时状态显示

官方文档：docs/Readme.md
核心配置源码：src/output-config.h

【免费下载链接】obs-multi-rtmp OBS複数サイト同時配信プラグイン 项目地址: https://gitcode.com/gh_mirrors/ob/obs-multi-rtmp