yt-dlp项目中的NRK HDR视频下载问题解析

问题背景

在yt-dlp项目中，用户报告了一个关于挪威广播公司(NRK)网站HDR视频下载的问题。当尝试下载NRK平台上的HDR视频内容时，yt-dlp获取的视频片段无法正常播放，导致最终合并的视频文件损坏。

技术分析

问题根源

yt-dlp当前使用的API版本较旧，虽然返回的格式信息与新API相同，但提供的URL却存在差异。许多这些旧API返回的URL实际上无法提供有效数据，特别是对于HDR视频内容。

协议差异

通过对比新旧API返回的m3u8播放列表，可以发现关键区别：

1. 旧API端点：/index.m3u8

   • 返回EXT-X-VERSION:4
   • 使用小写字母的媒体片段路径(如sc-gaFEAQ/vc_index.m3u8)

2. 新API端点：/cmaf.m3u8

   • 返回EXT-X-VERSION:6
   • 使用大写字母的媒体片段路径(如sc-gaFEQg/Vc_index.m3u8)

影响范围

这一问题主要影响：

• 挪威地区的用户
• 下载HDR(高动态范围)视频内容
• 使用HEVC(hvc1)编码的视频流

解决方案

项目维护者通过修改代码，将默认的m3u8请求路径从/index.m3u8更新为/cmaf.m3u8，解决了这一问题。这一变更确保了yt-dlp能够获取到有效的HDR视频流数据。

技术细节

HLS协议版本

新端点返回的是HLS协议版本6，相比版本4提供了更好的兼容性和功能支持，特别是对于HDR内容。版本6支持：

• 更精确的带宽指示
• 改进的媒体片段索引
• 更好的HDR元数据处理

CMAF格式

新端点明确使用了CMAF(Common Media Application Format)格式，这是一种现代化的媒体容器格式，特别适合自适应比特率流媒体传输，能够更好地支持HDR内容。

用户影响

对于最终用户而言，这一修复意味着：

1. 可以成功下载NRK平台的HDR内容
2. 下载的视频文件能够正常播放
3. 保持了原有的视频质量选择能力

总结

这一问题的解决展示了yt-dlp项目对视频流媒体技术变化的快速响应能力。通过更新API端点，项目确保了用户能够继续无缝下载高质量的视频内容，特别是日益普及的HDR格式。这也提醒我们，在流媒体下载工具开发中，需要持续关注内容提供商的技术更新，及时调整实现方式以保持兼容性。