SuperAPI AI 工具集

video-loop

设计与创作

查看项目

更新于 10-15 20:28

技能介绍

用途:为网站准备背景视频循环素材,可选结尾到开头的交叉淡入淡出,输出 MP4(H.264)和 WebM(VP9),并可选提取海报帧。适合需要循环播放背景视频的网页交付场景。

主要能力与参数:所有 ffmpeg 工作由 scripts/video-loop.sh 完成,技能负责校验输入、帮助选择淡入淡出时长、调用脚本并把脚本摘要转为可读报告。参数:-d <seconds> 交叉淡入时长,默认 1.5;-q <crf> H.264 CRF,默认 26(18 为高质量,28 为更小文件);-w <crf> VP9 WebM CRF,默认 32;-o <dir> 输出目录,默认与输入相同;-p 额外提取首帧为 JPEG 海报;-C 禁用交叉淡入,仅优化与编码(-n 为已弃用别名)。无 -s/-S 保存模式标志,输出是可直接放入站点视频目录的网页资源。

使用方式:先确认 ffmpeg 与 ffprobe 可用(command -v ffmpeg ffprobe);缺失时停止并请用户安装(macOS:brew install ffmpeg,Debian/Ubuntu:sudo apt install ffmpeg),不要自动安装。可选地抽取首尾帧比较循环质量,再运行 bash "$SKILL_DIR"/scripts/video-loop.sh <input> [flags]。脚本输出形如 RESULT: key=value 的摘要行,据此生成体积对比表与可粘贴的 HTML 片段;WebM 放在前面,因为浏览器选择第一个支持的 source。

限制:交叉淡化放在输出开头而非结尾,边界处仍需实际播放验证;仅比较首尾帧不能确定运动连续性。脚本按源分辨率编码,不放大;不得对已编码输出再次编码;音频始终剥离(-an);脚本拒绝 -d >= 时长/2,也拒绝输出与源别名(包括 WebM 输出到自身目录),请用 -o 指定其他目录。重复处理时应回到原始源,避免叠加编辑。