SuperAPI AI 工具集

ffmpeg-graceful-degradation

编程与开发

查看项目

更新于 10-16 05:51

技能介绍

用途:在 ffmpeg 编码因编解码器缺失、库版本不匹配或系统配置问题而失败时,提供系统化的回退策略,保证视频处理仍能完成。

主要能力:先探测可用编码器(ffmpeg -encoders | grep -E "libx264|libopenh264|mpeg4"),再用 5 秒短片验证编码是否可行,随后按顺序回退:copy 模式(-c:v copy -c:a copy,快速无损但不改编码格式)、mpeg4(-c:v mpeg4 -q:v 3 -c:a copy,兼容性广但文件更大)、最后用 moviepy(pip install moviepy,自带 ffmpeg 二进制,可处理单片段或 concatenate_videoclips 拼接)。

使用方式:先测试后批处理;失败时按上述顺序逐级尝试;moviepy 作为可靠兜底。常见错误包括 libopenh264.so: wrong ELF class(架构不匹配)、Encoder libx264 not found(未编译 x264)、Broken pipe、Invalid data found。

适用场景:处理用户上传的未知格式视频、编解码器支持有限的容器环境、失败代价高的批处理、ffmpeg 构建各异的跨平台部署。

限制:copy 模式不改变编码格式;mpeg4 文件体积较大;moviepy 需额外安装。具体性能与兼容性细节暂未提供。