终极指南：解决OBS-NDI插件NDI Runtime缺失故障的完整方案
项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi OBS-NDI插件（现更名为DistroAV）是OBS Studio实现NDI网络视频传输的核心工具，但用户常遇到"NDI Runtime缺失"错误导致功能无法使用。本文将提供从原因分析到一键修复的全方位解决方案，帮助新手用户快速恢复NDI功能。
关于DistroAV与NDI技术
DistroAV（原OBS-NDI）品牌标识，展示了网络视频传输的连接特性
DistroAV作为OBS Studio的NDI集成插件，允许用户通过局域网低延迟传输视频流。这种功能依赖NewTek开发的NDI®技术，需要专用的NDI Runtime组件支持。当系统提示"NDI Runtime not found"时，表示缺少这个关键组件。
NDI Runtime缺失的常见表现
- OBS启动时弹出错误窗口，提示"NDI Runtime not found"
- DistroAV插件功能灰色不可用
- 日志文件中出现"ERR-404 - NDI library not found"（可在OBS日志目录查看）
- 无法检测到网络中的NDI源设备
快速修复：三种安装NDI Runtime的方法
🚀 方法1：使用系统包管理器（推荐）
Windows用户可通过winget直接安装：
winget install -e --id NDI.NDIRuntime --accept-package-agreements --accept-source-agreements
如果出现"无法运行该命令"错误，请确保已安装Microsoft Store并更新到最新版本。
📦 方法2：手动下载安装
- 访问NDI官方下载页面获取最新Runtime安装包
- 关闭OBS Studio
- 运行安装程序并遵循向导指示
- 重启OBS后插件将自动检测到NDI组件
🔧 方法3：源码构建环境（开发者适用）
对于从源码编译DistroAV的用户，项目提供了自动获取NDI库的脚本：
# 位于项目根目录的CI脚本
CI/libndi-get.sh
故障排除进阶方案
检查插件冲突
如果系统提示"OBS-NDI is now DistroAV"错误，说明旧版OBS-NDI与新版DistroAV共存导致冲突。解决步骤：
- 完全退出OBS Studio
- 卸载旧版OBS-NDI插件
- 重新启动OBS Studio
验证文件完整性
确保NDI库文件存在于正确路径：
- Windows:
C:\Program Files\NewTek\NDI\NDI 5 Runtime\ - Linux:
/usr/local/lib/libndi.so - macOS:
/Library/Application Support/NewTek/NDI
查看详细日志
DistroAV的调试信息可在OBS日志中找到，搜索关键词"load_ndilib"获取加载过程详情，帮助定位具体问题。
预防未来问题
-
定期通过项目工具更新依赖：
tools/sha256-check.sh -
关注项目README.md获取最新兼容性信息
-
安装前关闭杀毒软件，避免误删NDI组件
通过以上方法，99%的NDI Runtime缺失问题都能得到解决。如果您遇到特殊情况，欢迎在项目Issue区提交详细错误报告获取帮助。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
