直播录制

功能定位

直播录制 用于把外部直播页面转成可管理的录制任务。业务人员登记直播地址、平台、清晰度和目标网关后，云端会通知本地网关执行录制，并持续跟踪任务状态和 MP4 合并状态。

它适合这些场景：

• 客户直播间日常录制留档。
• 直播复盘素材沉淀。
• 后续剪辑、脚本分镜拆分和成片制作的视频源准备。
• 多平台直播内容统一归档。

创建任务时要填什么

• 直播地址：直播页面地址，例如抖音直播间页面。
• 平台：当前常见支持抖音、淘宝、快手、小红书等口径，具体以部署环境和平台解析能力为准。
• 录制清晰度：原画、超清、高清、标清等字典项。
• 录制时长：填 0 表示手动停止，填具体分钟数表示到时自动结束。
• 目标网关：选择执行录制的本地网关，留空时走默认配置。

任务状态怎么看

直播录制重点看两类状态：

• 录制状态：待派发、启动中、录制中、停止中、完成、失败、取消。
• 合并状态：未合并、待合并、合并中、完成、失败。

实际使用时还要同时关注：

• 转文本状态：用于判断录制完成后字幕或转写是否已就绪。
• 弹幕回写情况：用于判断直播评论是否已经回到云端详情页。

只有录制完成且合并完成后，通常才可以把 MP4 当作稳定素材继续使用。

标准操作流程

1. 确认直播地址和平台正确。
2. 创建直播录制任务。
3. 观察任务是否进入录制中。
4. 按业务需要等待自动结束，或手动停止。
5. 等待 MP4 合并完成。
6. 如环境启用了转文本，继续观察转写是否完成。
7. 查看任务详情，确认录制文件名、路径、大小、开始结束时间和弹幕情况。
8. 将录制结果进入素材库、脚本分镜拆分或剪辑任务。

飞书和本地网关联动

直播录制可以通过本地网关回写状态，也存在飞书消息解析和通知能力。实际是否启用取决于当前环境配置。

如果客户需要从飞书发起或接收直播录制通知，实施时要确认：

• 飞书应用配置是否完整。
• 相关用户是否已绑定飞书账号。
• 本地网关是否能访问直播页面和共享盘。
• 云端回调地址是否能被本地网关访问。

当前链路里常见的飞书通知包括：

• 创建直播录制任务。
• 录制完成。
• 转文本完成或失败。
• 录制失败。

当前平台能力口径

平台	录制	转文本	弹幕
抖音	支持	支持	支持
淘宝	支持	支持	支持
快手	支持	支持	不支持
小红书	支持	支持	不支持

抖音直播通常依赖有效的 F2 Cookie 才能稳定解析直播流和弹幕。淘宝直播支持短链、直播页 URL 和分享文案解析，会优先选择 HLS 流录制，并通过淘宝评论接口采集弹幕。

平台能力会随平台反爬、页面结构和 Cookie 状态变化，现场排查时要同时看平台解析日志、直播是否仍在开播、以及网关所在机器是否能访问目标页面。

直播提前结束怎么处理

录制时长是业务期望，不代表直播一定会持续到这个时间。如果直播提前下播，本地网关应把它当成正常场景处理：

• 已经产生有效分片时，进入停止和合并流程。
• 合并成功后，主录制任务可以完成。
• 弹幕采集和转文本属于附属流程，失败时不应把已录制成功的视频误判为失败。
• 没有任何有效分片时，才更可能是直播未开播、解析失败或流不可用。

因此，看到“设定 1 小时但半小时下播”时，先检查是否已有 index.m3u8、segment_*.ts 和合并后的 MP4，而不是直接把任务判为异常。

常见异常

一直待派发或启动中

优先检查目标网关是否在线、网关 ID 是否正确、直播地址是否可访问。

录制中断或失败

优先检查直播是否已结束、平台是否限制访问、网关所在机器网络是否正常。

MP4 合并失败

优先检查录制切片是否完整、共享盘空间是否足够、合并进程是否正常。

转文本长时间无结果

优先检查转写执行器是否正常、录制文件是否已经合并完成、音轨是否可用。

有录制文件但没有弹幕

优先检查平台当前是否支持弹幕采集、平台 Cookie 是否有效，以及本地弹幕回调是否成功。

录制完成但素材库看不到

直播录制任务完成不一定等同于业务归档完成。需要确认是否已有入库或登记动作，以及当前账号是否有素材库目录权限。

关键日志

排查本地网关直播录制时优先看：

• ffmpeg-record.log：直播流拉取和录制阶段。
• ffmpeg-merge.log：MP4 合并阶段。
• worker 日志里的 live recording danmaku batch sent：本地弹幕批次是否已回调。
• 云端日志里的 直播录制弹幕批次入库完成：云端是否已写入弹幕。

如果任务卡在停止中或合并中，先确认录制目录里是否有播放列表、分片和合并日志，再判断是直播提前结束、ffmpeg 失败还是共享盘写入异常。