DistroAV：OBS Studio音视频传输插件全攻略

▌DistroAV作为OBS Studio的NDI®（网络设备接口协议）扩展插件，实现了跨平台的高质量音视频流传输能力。该插件支持Windows、MacOS和Linux操作系统，通过NDI协议可在局域网内实现低延迟的音视频信号共享，为直播、远程协作等场景提供专业级解决方案。

功能探秘：三大核心能力解析

跨设备NDI源接收系统

▌在OBS Studio中通过"添加源"功能选择"NDI Source"，插件会自动扫描局域网内的NDI发送设备。用户可直接选择目标设备的音视频流，无需手动配置IP地址。该功能支持多通道同时接收，适合多机位直播场景的信号整合。

NDI协议音视频信号接收流程图，展示OBS扩展插件与网络设备的通信架构

低延迟NDI输出功能

▌通过OBS顶部菜单栏的"工具"→"NDI输出设置"，可将当前场景或指定源的音视频流通过NDI协议发送到网络。输出参数支持自定义分辨率、帧率和码率，默认配置下延迟可控制在100ms以内，满足实时互动需求。

音频分离NDI过滤输出

▌在"滤镜"设置中添加"NDI Filter"，可单独提取特定源的音频信号并通过NDI传输。该功能在音频后期处理、多轨录音等专业场景中尤为实用，配置界面位于src/forms/output-settings.ui。

环境搭建：三步完成部署

1. 获取项目代码

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

2. 执行安装脚本

   • Linux/MacOS系统：

     cd obs-ndi && tools/InstallOBS-NDI.sh
     

   • Windows系统：双击运行tools/InstallOBS-NDI.cmd

3. 验证安装结果 重启OBS Studio后，检查"来源"面板是否出现"NDI Source"选项，或在"工具"菜单中找到"NDI Output Settings"。

OBS扩展插件功能入口界面，显示NDI源和输出设置的访问路径

场景落地：三大应用方案

远程协作直播系统

▌主控制台通过DistroAV接收各远程机位的NDI流，实现异地团队的实时画面切换。关键设备发现功能由src/ndi-finder.cpp实现，支持每30秒自动刷新设备列表。

教育互动教学方案

▌教师端通过NDI输出教学内容，学生端使用OBS接收后添加标注、弹幕等互动元素。系统默认采用H.264编码，建议网络带宽不低于5Mbps以保证720p/30fps的流畅传输。

多会议室信号互联

▌将视频会议画面通过虚拟摄像头导入OBS，再通过NDI协议分发到各会议室显示设备。高级用户可修改config.h中的MAX_BUFFER_SIZE参数调整缓存策略。

问题排查：常见故障解决

▌设备发现失败怎么办？

确认发送端已开启NDI输出功能，所有设备处于同一局域网。可通过"工具"→"NDI Finder"手动刷新设备列表，相关实现代码位于[src/ndi-finder.cpp#L45-L60](https://gitcode.com/gh_mirrors/ob/obs-ndi/blob/a45a3fffdbf2cfd12e88ee667be7da7f3bc80320/src/ndi-finder.cpp?utm_source=gitcode_repo_files)。

▌传输画面卡顿如何处理？

优先检查网络连接，建议使用有线网络；降低输出分辨率至1280x720或调整码率至4Mbps以下；修改[config.h](https://gitcode.com/gh_mirrors/ob/obs-ndi/blob/a45a3fffdbf2cfd12e88ee667be7da7f3bc80320/src/config.h?utm_source=gitcode_repo_files)中的`NETWORK_TIMEOUT`参数延长超时等待时间。

▌音视频不同步如何解决？

在"高级设置"中调整音频缓冲区大小，建议设置为200-300ms；确保发送端和接收端系统时间同步；检查网络延迟，理想状态应控制在50ms以内。

▌DistroAV作为开源项目持续接受社区贡献，代码仓库包含完整的构建脚本和多语言支持文件。项目本地化配置位于data/locale/目录，支持14种语言界面切换，满足全球用户需求。