AList项目中Google Photo视频文件访问问题的分析与解决

问题背景

在AList v3.36.0版本中，用户在使用Google Photo存储驱动时遇到了视频文件无法正常播放和复制的问题。具体表现为：

1. 当尝试从Google Photo批量复制约20,000个照片和视频到阿里云存储时，操作会在处理到第322页后失败
2. 视频文件播放功能同样失效
3. 调试日志显示系统在访问视频文件时返回404错误

技术分析

通过深入分析，发现问题根源在于AList对Google Photo API的调用方式存在缺陷。根据Google官方文档，访问媒体项目时应使用特定的URL格式：

1. 当前实现中，AList使用了包含"=m37"结尾的URL格式来访问视频文件
2. 这种格式实际上是Google Photo的旧版API参数
3. 根据Google Photos Library API最新规范，访问视频文件应使用"dv"参数而非"w"和"h"等旧参数

解决方案

针对这一问题，开发者进行了以下修复：

1. 将视频访问URL的参数从旧格式改为使用"dv"参数
2. 这一修改使得：
   • 批量复制操作能够顺利完成
   • 视频在线播放功能恢复正常
3. 该修复已通过本地测试验证

技术细节

Google Photo API的媒体访问URL有以下特点：

1. 不同类型的媒体项目需要不同的基础URL参数
2. 对于视频文件：
   • 旧方法：使用"=m[数字]"格式指定视频质量
   • 新方法：使用"dv"参数表示默认视频质量
3. 新方法更稳定且符合Google当前API规范

影响范围

该问题影响：

1. 所有使用Google Photo存储驱动的AList用户
2. 特别是需要处理大量视频文件的场景
3. 版本v3.36.0及之前版本

总结

AList项目中对Google Photo API的调用方式需要与时俱进，遵循API提供方的最新规范。这次问题的解决不仅修复了视频访问功能，也为后续的API集成提供了更好的实践参考。对于开发者而言，定期检查第三方API的变更并及时更新集成代码是保证系统稳定性的重要措施。