DistroAV 装完就报 ERR-401 / ERR-425NDI Runtime 缺失与版本不兼容的完整修复指南【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi刚把 DistroAVOBS-NDI 插件装进 OBS Studio重启后弹窗直接砸过来Error-401NDI Runtime Not Found或者Error-425Plugin requires NDI 6.3.0 or higher。别急着卸载重装这两个报错九成指向同一个东西NDI Runtime 没装对或没装全。这篇文章不按现象→分析→解决的老套路走而是给你一条分岔路先花两分钟在日志里确认自己的错误码再按对应的岔路走每一步做完有验收点最后用一份可勾选的清单收尾。第一步先花两分钟对号入座别猜打开 OBS菜单栏帮助 → 日志文件 → 查看日志文件搜ERR-。日志里写着哪个编号你就走哪条岔路日志里的错误码真实含义你要走的岔路ERR-401 / ERR-404找不到或加载不了 NDI 库岔路一装 RuntimeERR-425有 Runtime但版本低于 6.3.0岔路二清旧装新ERR-403检测到老插件 OBS-NDI 还在岔路三先卸旧房客ERR-406库初始化失败通常 CPU 太老硬件门槛查官方 CPU 要求这里有个关键点报错编号就藏在日志里比你在论坛描述一开 OBS 就崩高效一百倍。先确认编号再动手。分岔路一ERR-401 / ERR-404——翻译机压根没装NDI Runtime 可以理解成一台翻译机DistroAV 负责把你的画面和声音打包Runtime 负责翻译成所有 NDI 设备都听得懂的协议语言。插件装了、翻译机没装当然哑火。这一步就干一件事装翻译机。按平台来Windowswinget install --exact --id DistroAV.DistroAV走官方装配线安装时勾选为所有用户安装装完重启一次电脑让环境变量生效macOSbrew install --cask distroav/distroav/distroav装完打开终端确认/Library/NDI/目录下有新运行时文件LinuxUbuntu 用sudo apt install distroav依赖通常自动带进来Flatpak 方案也一般把运行时一并处理好验收点重启 OBS日志里搜到NDI Library Version detected:一行说明翻译机已经被找到了进入最后的验证清单还报 401往分岔路二走。分岔路二ERR-425——翻译机太旧底线是 6.3.0DistroAV 对 Runtime 的最低要求写死在源码里src/plugin-main.h中的PLUGIN_MIN_NDI_VERSION值就是6.3.0。报 ERR-425说明检测到版本比这个低。最常见的根因不是没升级而是系统里赖着一个旧版本没走。原则一句话先清后装装完重启。Windows设置 → 应用把所有带 NDI 字样的组件全部卸载干净再装新版macOS手动检查/Library/NDI/下有没有旧版残留文件一并清理Linux发行版包管理器里升级对应依赖包别硬搜网上的万能解法验收点日志里NDI Library Version detected: 6.3.0或更高并且出现NDI library version detected (...) is compatible这一关就过了。分岔路三ERR-403——旧房客 OBS-NDI 赖着不走这是很多人忽略的一条岔路。OBS-NDI 就是 DistroAV 的前身但两者现在是互相独立的插件不能共存。系统里残留老版 OBS-NDIDistroAV 会直接拒绝加载源码里明确写了这个检查见src/plugin-main.cpp开头的 ERR-403 分支。解法粗暴但有效关掉 OBS把 OBS-NDI 插件卸载干净再启动 DistroAV。别留着万一还能用的心思——源码逻辑是宁可整个插件不加载也不跟旧房客挤一间房。都走完了还报错看一眼这两行如果三条岔路都走完还报错日志里通常只剩两种可能ERR-406NDI 库能加载但初始化失败源码注释写得很直白usually due to unsupported CPU。这是硬件门槛去官方文档查 CPU 要求软件层面救不了ERR-424OBS 版本低于31.1.1Qt6 门槛把 OBS 升到稳定版再回来另外提醒一句版本检查的完整逻辑在src/plugin-main.cpp想较真的读者可以直接翻源码逻辑就 300 行上下比看任何二手教程都准。验证清单六个勾打满才算修好修没修好不看感觉照这个清单逐项打勾启动 OBS 后不再弹出 ERR-401 / ERR-425 错误框日志能搜到NDI Library Version detected:且版本号 ≥ 6.3.0日志出现NDI library version detected (...) is compatible工具菜单里能看到DistroAV NDI Settings入口来源面板能添加NDI 源并扫到局域网里的其他 NDI 设备双向传输都通你能看到别人别人也能看到你的输出六个勾全打上DistroAV 满血复活。卡在第五、六个勾上那是防火墙和网络配置的另一个话题跟 Runtime 无关了。有个开发者后门普通人别碰最后说一个只给开发调试用的东西。DistroAV 提供两个命令行参数--distroav-check-ndilib-ignore跳过 NDI 版本检查--distroav-check-ndilib-forcefail强制让检查失败用于自动化测试定义在src/config.cpp。跳过检查确实能让插件看起来能开但翻译机对不上功能大概率残缺甚至崩溃。这个参数是给自动化测试准备的普通用户请老老实实把 Runtime 装对别走后门。下一步往哪走想深入了解检查逻辑源码src/plugin-main.cpp、src/plugin-main.h以及命令行参数定义src/config.cpp自己从源码编译部署项目tools/目录下有install-windows.ps1和install-macos.sh一键把编译产物放进 OBS 插件目录高频疑问就一条主线先看日志错误码再对号走岔路装完重启再验证。记住两个数字——NDI ≥ 6.3.0、OBS ≥ 31.1.1排查时能省一半时间【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
