Yattee视频播放请求中host参数缺失问题分析

在Yattee视频播放器与invidious-companion配合使用时，开发者发现了一个影响视频正常播放的关键问题。当启用通过Invidious实例代理视频时，Yattee发送的/videoplayback请求缺少必要的host参数，导致invidious-companion无法正确处理请求并返回视频片段。

问题背景

Yattee是一款优秀的开源视频播放应用，而invidious-companion是一个配套服务，用于代理和处理来自YouTube的视频请求。两者配合使用时，需要遵循特定的通信协议。其中/videoplayback是YouTube视频流传输的关键端点，负责提供实际的视频数据片段。

问题本质

核心问题在于Yattee构建/videoplayback请求时，没有包含host查询参数。而invidious-companion服务端对此参数有强制校验要求，缺少该参数会导致请求直接被拒绝。这种参数缺失属于协议不匹配问题，而非网络或配置错误。

技术细节分析

在HTTP视频流传输过程中，host参数通常用于标识原始视频源服务器。对于YouTube视频流，这个参数应该是"rX---sn-xxx.googlevideo.com"这样的格式，其中X代表区域编号，xxx是服务器标识。invidious-companion需要这个参数来正确路由请求并获取视频数据。

Yattee当前实现中，当启用Invidious代理时，应该从视频URL中提取主机名，并将其作为host参数附加到/videoplayback请求中。但实际代码中可能遗漏了这一步骤，导致参数缺失。

解决方案建议

修复此问题需要在Yattee的请求构建逻辑中添加host参数处理：

1. 当检测到使用Invidious代理时，从视频URL解析出主机名
2. 将主机名作为host查询参数添加到所有/videoplayback请求中
3. 确保参数编码符合URL规范

这种修改既保持了与现有Invidious实例的兼容性，又满足了invidious-companion的校验要求。

影响范围

该问题主要影响使用invidious-companion作为代理的用户，表现为视频无法开始播放。对于直接连接YouTube或使用其他代理方式的用户则不受影响。问题已在tvOS 18.0系统和Yattee build 174版本上确认存在。

总结

这个案例展示了在分布式系统中组件间协议一致性的重要性。Yattee作为客户端需要严格遵循服务端(invidious-companion)的接口规范，特别是对于关键参数的处理。修复这个问题将显著提升使用invidious-companion代理时的用户体验和系统可靠性。