OBS的NDI插件一装就报Runtime错误？DistroAV安装与排障一篇讲透

OBS的NDI插件一装就报Runtime错误？DistroAV安装与排障一篇讲透

【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi

开播倒计时五分钟，画面调好了、BGM放上了，直播软件却突然弹出一个灰底白字的对话框：NDI Runtime Not Found。如果你正在用 DistroAV（原 OBS-NDI）给 OBS 加 NDI 网络传输能力，这行英文大概率就是它"作妖"的结果。别慌，这篇文章不打算按"第一步第二步"的说明书格式来写，而是把你最常撞见的报错摆到台面上，从结果倒着追根因，再给出能立刻动手的处置顺序——读完你就能自己判断：到底是没装对、版本不搭，还是压根没装上。

先对号入座：你撞上的是哪一种"Runtime 病"

报错文本长得像，病因却未必相同。多数人栽在同一个坑里：一看报错就卸载重装，结果装了三遍还是老样子。这是因为"Runtime 缺失"只是表象，底下至少有三种不同的状况：

先判断自己是哪一类，再往下查，能少走一大半弯路。这也是我踩过的坑：第一次直接冲着重装插件去，折腾一晚上，最后发现只是 Runtime 版本比 OBS 要求的旧了 0.1。

倒查根源：Runtime 到底卡在哪一环

要理解这个报错，先弄明白 DistroAV、OBS、NDI Runtime 三者的关系。把 OBS 想象成一家餐厅，DistroAV 是招牌菜，而 NDI Runtime 是后厨——菜品能不能端上桌，取决于后厨是否正常运转。插件负责提供"把画面接进来、送出去"的菜单，真正干活的是 Runtime 这个底层运行环境。

所以排查的核心只有一句话：Runtime 和 OBS 是否对齐。对齐要看三件事：

• 版本：NDI Runtime 一般要求 6.3.0 及以上，DistroAV 需要较新的 OBS（参考项目说明，建议 31.1.1 以上）。老 Runtime 配新 OBS，或反过来，都会报错。
• 位数：64 位 Runtime 必须配 64 位 OBS。位数不一致是"重装无效"的头号元凶，而且很难从界面上看出来。
• 加载时机：Runtime 安装包需要管理员权限完整写入，中途弹窗被拦下、或安装没跑完就打开 OBS，都会导致"看起来装了、其实没生效"。

这张图可以直观理解 NDI 的运作方式：每个设备是网络上的一个"节点"，NDI 要做的就是把画面从 A 节点实时搬运到 B 节点，而 Runtime 就是连接这些节点的那根"管道"。管道没铺好，节点再多也是孤岛。

报错后第一件事不是重装，而是先查这三点

很多人（包括我）的第一反应是删了重装，其实按下面的顺序查，多半比重装快：

1. 先查版本号对没对上。打开 Runtime 的版本信息，再对照 OBS 的版本，看是否落在要求区间。这是零成本的一步，却常常被跳过。
2. 再确认位数是否一致。在系统信息里看 OBS 是 32 位还是 64 位，Runtime 必须跟它同位数，缺一不可。
3. 最后看它是否真的活着。在系统服务列表里找 NDI 相关服务，状态应该是"运行中"；如果服务不存在，说明安装没落盘，直接回到安装环节。

提示：所谓"重装无效"的案例里，绝大多数都是前两步没做对。版本和位数不解决，装十遍也一样报错。

验证 NDI 是否生效的三种方法

装完先别急着开播，用下面三种方法由浅入深地验证，任一种通过都说明环境基本就绪：

• 看菜单：启动 OBS 后，来源面板点"+"，列表里出现NDI Source选项，说明插件被识别到了。
• 看工具：菜单栏里出现"NDI 输出设置"或类似入口，说明插件的输出功能可用。
• 看回环：在同一台电脑上，先用 NDI Output 把自己画面送出去，再添加一个 NDI Source 接收自己。能收到自己，就是一次完整的端到端自检。

这里有个常被忽略的细节：装完 Runtime 后务必重启一次系统（或至少完全退出并重新启动 OBS）。Runtime 服务、环境变量是在启动阶段注册的，不重启就可能读到旧状态。我见过不少"装完立刻打开就报错、重启后一切正常"的情况。

重装一遍前，先把四个准备动作做对

如果你确认版本和位数都没问题，那就回到安装环节，把下面四点做扎实：

1. 完全退出 OBS。不是关窗口，是确认进程彻底退出，否则文件被占用，安装会静默失败。
2. 用管理员权限跑安装包。右键"以管理员身份运行"，不要从压缩包里直接双击解压出来的文件。
3. 接受默认设置。Runtime 安装过程里保持默认选项即可，自作聪明改路径常常埋雷。
4. 先装 Runtime，再装插件，最后重启。顺序乱了，插件先装也不会有问题，但排查时容易分不清是谁没装好。

不同系统的安装入口也不一样，简单罗列一下：Windows 可以用包管理器直接装，macOS 走 Homebrew，Linux 用 Flatpak 装完 Studio 后再装 DistroAV 插件。无论走哪条路，上面四条准备动作都是通用的。

DistroAV 在 OBS 里提供的正是"接进来、送出去"两种能力，而连接这两个方向的枢纽，就是我们一路在排查的那个 Runtime。

装好之后，这三样功能分别怎么用

环境跑通只是开始，DistroAV 的三个核心功能才真正决定你的工作流怎么搭：

• NDI Source（收）：把另一台电脑、手机或 NDI 摄像机上的画面拉进当前工程。典型场景：多机位拍摄时，副机位画面走网络进主机；异地连麦时，对方的画面实时出现在你的场景里。
• NDI Output（发）：把整个 OBS 节目画面推给网络上的其他设备。典型场景：导播间把成片推给大屏、推给另一台做录制的机器。
• NDI Filter（单发）：只把某个源或场景单独送出去，而不是整台机器的节目画面。典型场景：某一路摄像头素材需要单独分发，或想把单个源直接交给另一个软件处理。

一句话记忆法：Source 是"拿来"，Output 是"全给"，Filter 是"挑着给"。选哪个取决于你想让什么内容、以什么粒度在网络上传送。

今天就能做的下一步

关掉这篇文章，打开 OBS，来源面板点"+"，先确认能看到 NDI Source。如果手边暂时没有第二台设备，就用我前面说的"回环自检"：NDI Output 送出自己，再 NDI Source 接收自己，几分钟就能确认整条链路是通的——这也是验证安装是否彻底生效的最快方式。跑通之后，建议持续关注 DistroAV 的项目动态，新版本通常会同步适配最新版的 OBS 与 NDI Runtime，升级插件前先看一眼更新说明，能避开不少"升级后突然报错"的坑。

【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi