Ant Media Server 2.14集群模式下WebRTC直播流名称缺失问题解析

在Ant Media Server 2.14.0版本的集群模式部署环境中，开发人员发现了一个关于WebRTC直播流元数据完整性的技术问题。具体表现为当通过WebRTC协议发布直播流时，系统触发的"liveStreamStarted"网络钩子(webhook)通知中缺少了关键的streamName字段。

这个问题特别值得关注，因为它只出现在WebRTC协议场景下。当使用RTMP协议发布相同streamId的直播流时，系统能够正常包含streamName字段在webhook通知中。这种协议差异性的表现暗示了问题可能存在于WebRTC处理流程中的特定环节。

从技术实现角度看，Ant Media Server的webhook机制是其与外部系统集成的重要接口。"liveStreamStarted"通知用于告知外部系统新直播流的创建事件，其中streamName字段对于许多业务场景都至关重要。例如，在需要显示友好直播名称的平台上，这个字段的缺失会导致用户体验问题。

问题的根本原因被定位在集群模式下的WebRTC流处理逻辑中。在修复过程中，开发团队发现当流通过WebRTC发布时，流名称信息没有正确地从客户端传递到集群的各个节点，导致最终生成的webhook通知缺少了这个字段。

这个问题的修复涉及到了Ant Media Server核心的流管理模块。开发团队通过修改WebRTC流的元数据处理流程，确保streamName能够被正确捕获并包含在所有相关事件通知中。值得注意的是，修复方案保持了向后兼容性，不会影响现有集成系统的正常运行。

对于使用Ant Media Server的开发者和系统管理员来说，这个问题的存在和修复具有以下启示：

1. 在升级到2.14.0版本时，如果依赖streamName字段的业务逻辑，需要特别关注WebRTC流的处理
2. 不同传输协议(RTMP vs WebRTC)可能在实现细节上存在差异，需要进行全面的测试
3. 集群模式下的状态同步机制需要特别关注，确保所有节点都能获取完整的流元数据

该问题的及时修复展现了Ant Media Server开发团队对产品质量的重视，也提醒我们在使用开源流媒体服务器时需要关注不同协议和部署模式下的行为一致性。对于依赖webhook通知的系统集成，建议在升级后进行全面测试，确保所有预期字段都能正确传递。