编码与格式 / 系统课时

设计可复用命令模板

设计可复用命令模板

本课把固定的转码流程封装成可配置脚本:输入、输出和少量质量参数由调用方提供,其余参数集中维护。完成后,你可以复用同一模板处理不同文件,并减少引号、参数顺序和漏配选项造成的错误。

学习目标

  • 划分命令模板中的固定参数与可变参数
  • 使用 Bash 数组安全组装并执行 FFmpeg 命令
  • 通过打印命令和探测输出验证模板结果

先确定模板边界

可复用模板不应暴露 FFmpeg 的全部选项,而应只开放业务中经常变化的参数。本例固定使用 H.264 视频、AAC 音频和 MP4 容器,同时允许调用方调整 CRF、预设速度和音频码率。

参数 默认值 何时调整
CRF 23 数值越小通常画质越高、文件越大
PRESET medium 需要更快处理时改为 fast 或 veryfast
AUDIO_BITRATE 128k 音乐或高质量语音可提高到 160k、192k

输入路径和输出路径使用位置参数传入。这样既便于人工调用,也便于后续被批处理脚本、定时任务或应用程序复用。

编写可运行模板

将下面内容保存为 transcode-template.sh。脚本使用数组保存每个参数,执行时不会再次拆词,因此包含空格的文件名也能被正确处理。

bash
#!/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,然后赋予脚本执行权限并覆盖默认质量参数。

bash
chmod +x transcode-template.sh
CRF=21 PRESET=fast AUDIO_BITRATE=160k \
  ./transcode-template.sh "input.mp4" "output.mp4"

预期输出的第一行如下,后续 FFmpeg 编码日志中的速度、时间和文件大小会因机器与素材而变化。

text
执行命令: 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 会立即终止脚本,调用方也能据此识别失败。

验证模板输出

不要只检查文件是否存在,还应确认容器与编码器符合模板约定。

bash
ffprobe -v error \
  -show_entries stream=index,codec_type,codec_name \
  -of csv=p=0 "output.mp4"

对于包含一条视频轨和一条音频轨的输入,预期结果类似:

text
0,h264,video
1,aac,audio

轨道索引可能不同,但视频编码应为 h264,音频编码应为 aac。若输入本身没有音频轨,结果只会显示视频轨,这不是模板失效。

关键边界

不要把完整命令保存成字符串后再用 eval 执行。文件名中的空格、引号或特殊字符可能改变参数边界,甚至造成命令注入。数组能保持“一项一个参数”,更适合自动化场景。

模板还应明确覆盖策略。本例使用 -y 自动覆盖同名输出;生产环境若要求保留历史文件,应改用 -n,或在执行前生成带时间戳、任务 ID 的唯一输出路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计可复用命令模板

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通