Ant-Media-Server中HLS分段上传S3的文件夹结构优化方案

在视频流媒体服务器Ant-Media-Server的开发过程中，团队发现了一个关于HLS(HTTP Live Streaming)分段文件上传至S3存储时的文件夹结构优化需求。本文将详细介绍这一技术改进的背景、设计方案及其实现思路。

背景与问题分析

在视频会议场景下，Ant-Media-Server默认配置会将所有参会者的HLS分段文件(.ts)上传至同一个S3文件夹中。这种存储方式存在以下问题：

1. 文件管理混乱：多个参会者的视频片段混合存储，难以区分
2. 检索效率低：需要额外处理才能获取特定参会者的视频数据
3. 权限控制困难：无法针对单个参会者的视频设置独立访问权限

解决方案设计

开发团队经过讨论，决定采用动态路径配置方案，类似于现有的fileNameFormat应用设置。新的subFolder设置将支持以下变量：

• %m：主轨道ID(Main track ID)
• %s：流ID(Stream ID)
• 自定义字符串：可直接在配置中指定的固定字符串

这种设计提供了极大的灵活性，管理员可以根据实际需求自定义S3存储路径结构。

实现示例

假设管理员进行如下配置：

subFolder: %m/%s

则生成的S3存储路径将呈现为：

streams/mainTrackId/streamId/1.ts

另一个配置示例：

subFolder: lastpeony/%m/%s

对应的存储路径为：

streams/lastpeony/mainTrackId/streamId/1.ts

技术优势

1. 灵活性高：支持多种变量组合，适应不同业务场景
2. 可读性强：路径结构清晰，便于人工识别和管理
3. 扩展性好：未来可方便地添加更多变量支持
4. 兼容性强：与现有系统无缝集成，不影响已有功能

实现要点

在实际开发中，需要注意以下技术细节：

1. 变量替换机制：需要建立高效的字符串替换逻辑，确保性能
2. 路径合法性检查：防止生成不合法的S3路径
3. 向后兼容：确保旧配置仍能正常工作
4. 性能优化：路径生成不应影响视频流处理性能

总结

Ant-Media-Server通过引入动态S3子文件夹配置，显著提升了HLS分段文件存储的灵活性和可管理性。这一改进特别适合视频会议等需要区分多路视频流的应用场景，为系统管理员提供了更强大的存储管理能力，同时也为后续的功能扩展奠定了良好基础。