编码与格式 / 系统课时
设计可复用命令模板
设计可复用命令模板
本课把固定的转码流程封装成可配置脚本:输入、输出和少量质量参数由调用方提供,其余参数集中维护。完成后,你可以复用同一模板处理不同文件,并减少引号、参数顺序和漏配选项造成的错误。
学习目标
- 划分命令模板中的固定参数与可变参数
- 使用 Bash 数组安全组装并执行 FFmpeg 命令
- 通过打印命令和探测输出验证模板结果
先确定模板边界
可复用模板不应暴露 FFmpeg 的全部选项,而应只开放业务中经常变化的参数。本例固定使用 H.264 视频、AAC 音频和 MP4 容器,同时允许调用方调整 CRF、预设速度和音频码率。
| 参数 | 默认值 | 何时调整 |
|---|---|---|
CRF |
23 |
数值越小通常画质越高、文件越大 |
PRESET |
medium |
需要更快处理时改为 fast 或 veryfast |
AUDIO_BITRATE |
128k |
音乐或高质量语音可提高到 160k、192k |
输入路径和输出路径使用位置参数传入。这样既便于人工调用,也便于后续被批处理脚本、定时任务或应用程序复用。
编写可运行模板
将下面内容保存为 transcode-template.sh。脚本使用数组保存每个参数,执行时不会再次拆词,因此包含空格的文件名也能被正确处理。
#!/usr/bin/env bash
set -euo pipefail
input="${1:?用法:$0 <输入文件> <输出文件>}"
output="${2:?用法:$0 <输入文件> <输出文件>}"
crf="${CRF:-23}"
preset="${PRESET:-medium}"
audio_bitrate="${AUDIO_BITRATE:-128k}"
# 使用数组保存参数,避免 eval 和字符串拼接带来的转义问题。
cmd=(
ffmpeg -hide_banner -y
-i "$input"
-c:v libx264 -preset "$preset" -crf "$crf"
-c:a aac -b:a "$audio_bitrate"
-movflags +faststart
"$output"
)
printf '执行命令:'
printf ' %q' "${cmd[@]}"
printf '\n'
"${cmd[@]}"脚本中的固定参数体现统一规范;环境变量只覆盖少量可调项。-movflags +faststart 会把 MP4 元数据移动到文件前部,便于网络渐进播放。
执行并观察结果
准备一个带音视频轨道的 input.mp4,然后赋予脚本执行权限并覆盖默认质量参数。
chmod +x transcode-template.sh
CRF=21 PRESET=fast AUDIO_BITRATE=160k \
./transcode-template.sh "input.mp4" "output.mp4"预期输出的第一行如下,后续 FFmpeg 编码日志中的速度、时间和文件大小会因机器与素材而变化。
执行命令: ffmpeg -hide_banner -y -i input.mp4 -c:v libx264 -preset fast -crf 21 -c:a aac -b:a 160k -movflags +faststart output.mp4命令成功结束后,当前目录应生成 output.mp4。如果 FFmpeg 返回非零状态,set -e 会立即终止脚本,调用方也能据此识别失败。
验证模板输出
不要只检查文件是否存在,还应确认容器与编码器符合模板约定。
ffprobe -v error \
-show_entries stream=index,codec_type,codec_name \
-of csv=p=0 "output.mp4"对于包含一条视频轨和一条音频轨的输入,预期结果类似:
0,h264,video
1,aac,audio轨道索引可能不同,但视频编码应为 h264,音频编码应为 aac。若输入本身没有音频轨,结果只会显示视频轨,这不是模板失效。
关键边界
不要把完整命令保存成字符串后再用 eval 执行。文件名中的空格、引号或特殊字符可能改变参数边界,甚至造成命令注入。数组能保持“一项一个参数”,更适合自动化场景。
模板还应明确覆盖策略。本例使用 -y 自动覆盖同名输出;生产环境若要求保留历史文件,应改用 -n,或在执行前生成带时间戳、任务 ID 的唯一输出路径。