Ant Media Server中WebHook播放认证负载的viewerInfo参数问题解析

在Ant Media Server的流媒体播放过程中，开发者经常需要通过WebHook机制来实现播放认证和授权控制。近期社区反馈了一个关于播放认证WebHook负载中缺少viewerInfo参数的问题，这个问题涉及到流媒体播放过程中的元数据传输机制，值得深入探讨。

问题背景

在Ant Media Server的WebRTC播放流程中，客户端可以通过WebSocket发送play命令来请求播放特定流。这个play命令可以携带viewerInfo参数，用于传递客户端的元数据信息。开发者期望这些元数据能够传递到WebHook的播放认证端点，以便基于这些信息进行播放权限验证。

技术实现细节

在标准实现中，当客户端发送play命令时，命令格式通常包含：

• command字段（固定为"play"）
• streamId字段（指定要播放的流ID）
• 可选的viewerInfo字段（包含JSON格式的客户端元数据）

然而，在WebHook的播放认证请求负载中，原本只包含以下字段：

• streamId
• mode
• appName
• origin
• token
• subscriberCode
• subscriberId
• metaData（广播元数据）

这里存在一个关键问题：客户端的viewerInfo元数据没有被包含在WebHook认证请求中，导致认证服务无法获取这些关键信息。

解决方案

开发团队已经实现了对这个问题的修复，主要变更包括：

1. 将play命令中的viewerInfo参数完整传递到WebHook认证端点
2. 在WebHook认证请求负载中新增viewerInfo字段，专门用于承载客户端传递的元数据
3. 保持原有的metaData字段不变，该字段仍然用于传递广播相关的元数据

这种设计实现了清晰的职责分离：

• viewerInfo：来自播放客户端的元数据
• metaData：与广播流相关的元数据

应用场景

这个改进对于需要精细播放控制的场景特别有价值，例如：

1. 订阅验证：可以通过viewerInfo传递订阅者ID和验证信息
2. 地理位置限制：可以包含客户端位置信息进行地域验证
3. 设备验证：传递设备类型和版本信息进行兼容性检查
4. 个性化服务：基于用户偏好提供不同的流媒体体验

技术建议

对于需要使用这一功能的开发者，建议：

1. 确保使用支持此功能的最新版本Ant Media Server
2. 在客户端代码中规范viewerInfo的格式，建议使用标准JSON
3. 在WebHook认证服务中正确处理viewerInfo字段
4. 考虑对敏感信息进行加密处理

这个改进显著增强了Ant Media Server的播放认证能力，为开发者提供了更大的灵活性和控制力，使得基于元数据的复杂播放授权场景成为可能。