AI 内容创作 / 系统课时
多平台编码与发布
多平台编码与发布
审核通过的成片不能直接复制成多个文件就结束交付。本课将从一个高质量母版生成横屏、竖屏、流媒体、封面和字幕版本,并通过命令行验证分辨率、编码、像素格式和播放列表,形成可重复的发布流程。
学习目标
- 设计“母版一次确认、分发版按平台派生”的输出结构。
- 使用 FFmpeg 生成横屏、竖屏、封面、字幕和 HLS 点播文件。
- 在上传前验证编码参数、画面安全区、字幕和播放完整性。
先保留母版再生成分发版
母版用于长期归档和重新派生,不应为了适配某个平台而提前裁切、压低码率或烧录固定字幕。每个平台版本都应从同一母版生成,并保留独立的参数记录,这样才能在平台规则变化或发现字幕错误时快速重做。

版型、字幕与封面策略
下面的参数是便于兼容和复核的交付基线,不代表任何平台的固定上限。正式发布前仍要查看目标平台当时的上传要求,先做本地回看。有明确授权后,再按项目要求用受限发布核对平台转码。
| 交付物 | 建议基线 | 关键检查 |
|---|---|---|
| 横屏视频 | MP4、H.264、AAC、1920×1080、yuv420p |
字幕轨、响度、首帧和尾帧 |
| 竖屏视频 | MP4、H.264、AAC、1080×1920、yuv420p |
人脸与字幕是否被中央裁切 |
| 流媒体点播 | HLS VOD 播放列表与分片 | 分片连续、可拖动、存在结束标记 |
| 字幕 | 保留 SRT,并派生 WebVTT 或平台要求格式 | 时间码、断句、角色名和安全区 |
| 封面 | 分别生成 16:9 与 9:16 版本 | 小尺寸可读、无关键文字贴边 |
本练习使用方形像素、恒定帧率且已正确标记色彩的逐行 SDR 母版。保留母版帧率,约每 2 秒放一个 IDR 以便 HLS 切片。关键帧只能落到实际帧上,分片长度还要查播放列表。HDR、VFR、色彩变换和平台特定 GOP 要单独设计与复核。
完整可运行示例
准备 master.mov 和 UTF-8 的 zh-CN.srt,并安装 Node.js、带 libx264 的 FFmpeg 和 ffprobe。下面脚本只在新的本地目录内生成文件。目录已存在会拒绝运行,失败后换一个新的版本目录重试。封面取各版本首帧作技术演示,正式封面需另审。
import { execFileSync } from "node:child_process";
import { copyFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
import { join } from "node:path";
const [input = "master.mov", captions = "zh-CN.srt", dest = "delivery-v001"] = process.argv.slice(2);
if (!/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(dest)) {
throw new Error("输出目录仅可用字母、数字、下划线和短横线");
}
if (!existsSync(input) || !existsSync(captions)) throw new Error("缺少母版或字幕");
const ff = args => execFileSync("ffmpeg", ["-hide_banner", "-v", "error", "-n", ...args], {
stdio: ["ignore", "ignore", "inherit"],
});
const probe = (file, fields, extra = []) => JSON.parse(execFileSync("ffprobe", [
"-v", "error", ...extra, "-show_entries", fields, "-of", "json", file,
], { encoding: "utf8" }));
// 非递归创建,已有目录会报错,绝不重用旧交付目录。
mkdirSync(dest);
mkdirSync(join(dest, "hls"));
const path = name => join(dest, name);
const variants = [
["landscape", 1920, 1080, "decrease", "pad"],
["vertical", 1080, 1920, "increase", "crop"],
];
for (const [name, width, height, fit, geometry] of variants) {
const filter = "scale=" + width + ":" + height + ":force_original_aspect_ratio=" + fit +
":force_divisible_by=2," + geometry + "=" + width + ":" + height + ",setsar=1,format=yuv420p";
ff(["-i", input, "-i", captions, "-map", "0:v:0", "-map", "0:a:0?", "-map", "1:0",
"-vf", filter, "-fps_mode", "passthrough", "-c:v", "libx264", "-preset", "veryfast",
"-crf", "21", "-sc_threshold", "0", "-flags", "+cgop", "-forced-idr", "1",
"-force_key_frames", "expr:gte(t,n_forced*2)", "-c:a", "aac", "-ar", "48000",
"-c:s", "mov_text", "-metadata:s:s:0", "language=zho", "-movflags", "+faststart", path(name + ".mp4")]);
ff(["-i", path(name + ".mp4"), "-map", "0:v:0", "-frames:v", "1", "-q:v", "2",
"-update", "1", path("cover-" + name + ".jpg")]);
const [stream] = probe(path(name + ".mp4"), "stream=codec_name,width,height,pix_fmt,avg_frame_rate",
["-select_streams", "v:0"]).streams;
if (stream.codec_name !== "h264" || stream.width !== width || stream.height !== height ||
stream.pix_fmt !== "yuv420p") throw new Error("视频规格不匹配");
console.log(name, stream.width + "x" + stream.height, stream.avg_frame_rate);
}
copyFileSync(captions, path("zh-CN.srt"));
ff(["-i", captions, path("zh-CN.vtt")]);
ff(["-i", path("landscape.mp4"), "-map", "0:v:0", "-map", "0:a:0?", "-c", "copy", "-f", "hls",
"-hls_time", "2", "-hls_playlist_type", "vod", "-hls_flags", "independent_segments",
"-hls_segment_filename", path("hls/segment-%03d.ts"), path("hls/index.m3u8")]);
const playlist = readFileSync(path("hls/index.m3u8"), "utf8");
const segments = playlist.split(/\r?\n/).filter(line => /^segment-\d+\.ts$/.test(line));
if (!playlist.includes("#EXT-X-ENDLIST") || segments.length === 0 ||
segments.some(name => !existsSync(path("hls/" + name)))) throw new Error("点播列表不完整");
ff(["-i", path("hls/index.m3u8"), "-f", "null", "-"]);
console.log("HLS segments:", segments.length);将代码存为 publish-variants.mjs 后运行。
node publish-variants.mjs master.mov zh-CN.srt delivery-v001预期输出:
landscape 1920x1080 24/1
vertical 1080x1920 24/1
HLS segments: 3上面输出以 5 秒、24 fps 的母版为例。脚本检查两版编码、尺寸和像素格式,也会完整解码本地 HLS 列表。核对输出时间戳、字幕文字和声道后,再做内容检查。HLS 样例只封装音画,WebVTT 是独立文件,接播放器时还要通过播放器支持的字幕配置加入。
验收不能只看 ENDLIST。另检查分片引用、目标时长和首尾帧、段内解码与跳转,并记录所测播放器。若某版需要生成内容显式标识,按实际派生版重新检查首屏、可见时间和字高,不能直接沿用横版的检查结果。
发布前验收
先在本地完整播放文件并记录内容、技术规格与权利检查。经项目授权送测时,另核对处理后的首帧、跳转、清晰度、同步、字幕与封面。
竖屏版本要重点复核中央裁切。自动裁切只保证画布尺寸,不保证人物始终处于安全区;镜头主体横向移动时,应改用逐镜头重构图或关键帧控制,不能仅靠一次固定裁切完成交付。
字幕应同时保留可编辑主文件和平台分发文件。若平台会移除 MP4 内嵌字幕轨,应单独上传 SRT;若字幕必须始终可见,则另做烧录字幕版本,并把它视为独立交付物,避免覆盖无字幕母版。
本课总结
- 母版负责长期复用,横屏、竖屏、流媒体、字幕和封面都应作为可重建的派生文件。
- 编码完成后必须用
ffprobe、播放列表检查和多设备回看共同验收,不能只看文件是否生成。 - 自动缩放与裁切解决尺寸问题,但人物构图、字幕安全区和平台回看仍需要人工确认。
下一课预告
下一章把本章的质量、合规和编码检查纳入综合项目需求书,再用明确的验收节点验证成片及派生版本。