ninja-obs-plugin：VDO.Ninja 插件

项目简介

VDO.Ninja 的原生 OBS Studio 插件，把 WebRTC 推流与接收路径直接整合进 OBS 工作流。VDO.Ninja 是低延迟 WebRTC 平台，常用于直播制作、远程嘉宾、房间式信号接入与浏览器回传。过去这些流程通常只能借助浏览器源（Browser Source）配合 https://vdo.ninja/?push=YourStreamID 这类链接完成，本插件让相关操作更贴近 OBS 原生控制。

主要功能

• 直接从 OBS 输出设置向 VDO.Ninja 发布；插件通过 rtmp-services 目录兼容方式，在 OBS 推流服务列表里注入 VDO.Ninja 目标。
• 支持多观众推流，并已做端到端测试。
• 自动入站管理：可根据房间与数据通道事件创建或更新浏览器源。
• VDO.Ninja Source 默认使用浏览器型查看路径；开启 Use Native Receiver (Experimental) 后切换到实验性的原生 VP9/H.264/HEVC/AV1 视频与 Opus 音频接收路径。
• 配合支持双轨 VP9 alpha 的发送端，原生接收端可保留透明度；已测试的路径是用 Game Capture 发布启用 VP9 alpha 的 Spout2 头像/图形源。
• 可在插件设置中配置信令服务器、Salt、自定义 ICE/TURN 与包保护等高级选项。
• Tools -> VDO.Ninja Studio 面板提供基础推流设置、Go Live/Stop 控制、生成的链接与运行时对等连接统计。
• 语言文件缺失时回退到内置英文字符串。
• 推流编码支持 H.264、HEVC/H.265、AV1，取决于 OBS 中所选编码器实际产出的格式；观看端必须支持对应编码，修改观看链接无法转码。

安装与使用

从 Releases 下载与已安装 OBS 版本匹配的包：

平台	OBS 版本	发布包
Windows	32.2.x	obs-vdoninja-windows-x64-setup.exe（推荐）或 .zip
Windows	32.0.x / 32.1.x	文件名含 obs32.0-32.1 的包
Linux	32.2.x	obs-vdoninja-linux-x86_64.tar.gz
macOS（Apple silicon）	32.2.x	obs-vdoninja-macos-arm64.pkg（推荐）或对应 ZIP

Windows 一般使用 setup .exe 安装/卸载；便携版可在安装程序中浏览到其根目录或选择 obs64.exe。OBS 32.2 更换了内置 FFmpeg 运行时，32.0–32.1 与 32.2 的 Windows 二进制不可互换；本版本不提供 OBS 31.x 及更早的预编译包。安装细节见 INSTALL.md，首次使用见 QUICKSTART.md。

推流步骤：

1. OBS -> Settings -> Stream
2. 服务选择 VDO.Ninja
3. Server 保持默认 wss://wss.vdo.ninja:443；自建或排查信令时可用 wss://proxywss.rtc.ninja:443
4. 打开 Tools -> VDO.Ninja Studio，填写 Stream ID、密码与可选房间
5. 点击 Start Streaming

Stream Key 可填 URL 或紧凑格式：

https://vdo.ninja/?push=<StreamID>&password=<Password>&room=<RoomID>
<StreamID>|<Password>|<RoomID>|<Salt>|<WSS_URL>

观看端链接形如：

https://vdo.ninja/?view=<StreamID>

Studio 中独立的 Guest Return 控制会通过一条独立的 H.264/Opus 输出发送节目信号，可与普通公开推流同时进行；需在 OBS 高级音频属性里为回传选择不含该嘉宾的音轨。若配置了高级服务选项，请在 Settings -> Stream 保存后使用 OBS 的 Start Streaming；Studio 的 Go Live 会用面板基础字段和默认高级值重建服务。

注意事项

• 推流（OBS -> VDO.Ninja）是当前主要稳定路径；原生接收端仍标记为实验性。
• 远程控制 OBS 尚未成为完全加固的命令面。
• 便携版 OBS 从终端启动时，需在 bin\64bit 目录下运行 obs64.exe，否则可能出现 Failed to load theme。
• 插件每天静默检查一次 GitHub 稳定版更新，不弹窗、不自动下载、不自动安装；预发布版不触发更新提示。

---

本作品整理自 GitHub 开源项目 steveseguin/ninja-obs-plugin，原作者 @steveseguin，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。