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。下面脚本只在新的本地目录内生成文件。目录已存在会拒绝运行,失败后换一个新的版本目录重试。封面取各版本首帧作技术演示,正式封面需另审。

js
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 后运行。

bash
node publish-variants.mjs master.mov zh-CN.srt delivery-v001

预期输出:

text
landscape 1920x1080 24/1
vertical 1080x1920 24/1
HLS segments: 3

上面输出以 5 秒、24 fps 的母版为例。脚本检查两版编码、尺寸和像素格式,也会完整解码本地 HLS 列表。核对输出时间戳、字幕文字和声道后,再做内容检查。HLS 样例只封装音画,WebVTT 是独立文件,接播放器时还要通过播放器支持的字幕配置加入。

验收不能只看 ENDLIST。另检查分片引用、目标时长和首尾帧、段内解码与跳转,并记录所测播放器。若某版需要生成内容显式标识,按实际派生版重新检查首屏、可见时间和字高,不能直接沿用横版的检查结果。

发布前验收

先在本地完整播放文件并记录内容、技术规格与权利检查。经项目授权送测时,另核对处理后的首帧、跳转、清晰度、同步、字幕与封面。

竖屏版本要重点复核中央裁切。自动裁切只保证画布尺寸,不保证人物始终处于安全区;镜头主体横向移动时,应改用逐镜头重构图或关键帧控制,不能仅靠一次固定裁切完成交付。

字幕应同时保留可编辑主文件和平台分发文件。若平台会移除 MP4 内嵌字幕轨,应单独上传 SRT;若字幕必须始终可见,则另做烧录字幕版本,并把它视为独立交付物,避免覆盖无字幕母版。

本课总结

  • 母版负责长期复用,横屏、竖屏、流媒体、字幕和封面都应作为可重建的派生文件。
  • 编码完成后必须用 ffprobe、播放列表检查和多设备回看共同验收,不能只看文件是否生成。
  • 自动缩放与裁切解决尺寸问题,但人物构图、字幕安全区和平台回看仍需要人工确认。

下一课预告

下一章把本章的质量、合规和编码检查纳入综合项目需求书,再用明确的验收节点验证成片及派生版本。

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

目录与阅读设置

阅读设置

17

记录一个想法

多平台编码与发布

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

登录哪都通