OBS-NDI插件中配置文件切换导致输出分辨率不更新的问题解析

问题背景

在OBS视频制作流程中，NDI技术常被用于在不同设备间传输高质量视频流。然而，在使用obs-ndi插件时，用户发现了一个影响工作流程的重要问题：当切换OBS配置文件时，如果新配置文件的输出分辨率与之前不同，NDI输出流不会自动更新到新的分辨率设置。

问题现象

具体表现为：

1. 用户创建了两个不同输出分辨率的OBS配置文件
2. 启用NDI输出功能并开始监控视频流
3. 切换配置文件时，NDI输出流仍保持原来的分辨率
4. 更严重的情况下，尝试手动禁用/启用NDI输出会导致后台NDI服务崩溃，需要重启OBS才能恢复

技术原因分析

经过开发团队深入调查，发现根本原因在于obs-ndi插件没有正确监听OBS的核心事件通知。具体来说：

1. OBS核心在配置文件切换时会触发"视频重置"事件(OBS_FRONTEND_EVENT_VIDEO_RESET)
2. 旧版obs-ndi插件没有注册对这个关键事件的监听
3. 因此当分辨率等视频参数改变时，插件无法做出相应调整
4. 这导致NDI输出流继续使用之前的编码参数，造成分辨率不匹配

解决方案

开发团队通过以下方式解决了这个问题：

1. 在插件代码中添加了对视频重置事件的监听处理
2. 当检测到配置文件切换时，自动停止当前所有NDI输出流
3. 使用新的视频参数重新初始化NDI输出
4. 确保输出流与当前配置文件的设置完全匹配

兼容性考虑

值得注意的是，这个修复依赖于OBS核心新增的事件类型。因此：

• 在新版OBS上使用新版插件可以完全解决问题
• 旧版OBS虽然不会报错，但也无法获得此修复带来的改进
• 建议用户同时升级OBS和obs-ndi插件以获得最佳体验

最佳实践建议

为避免类似问题，视频制作人员可以注意以下几点：

1. 定期检查并更新OBS和所有插件到最新版本
2. 在重要直播前，预先测试所有配置切换场景
3. 如果遇到NDI输出异常，可以尝试完全重启OBS而不仅是禁用/启用插件
4. 考虑在不同分辨率需求的工作中使用不同的场景集合而非配置文件

总结

这个问题的解决显著提升了obs-ndi插件在复杂制作环境中的可靠性，特别是对于需要频繁切换不同输出配置的专业用户。通过正确响应OBS核心事件，插件现在能够更智能地适应参数变化，确保视频流输出的稳定性和准确性。