用 VOD 文件搭建 24/7 HLS 频道:哪些地方会让视频流中断
用 VOD 媒资库搭建线性频道是很常见的需求:
- 电影俱乐部想在自己的网站上做一个晚间直播流
- 在线学校想让课程全天候循环重播
- 品牌想让自己的视频在门店屏幕上循环播放
他们都没有直播编码器,只有上传好的文件。但他们仍然想要这些:
- 所有观众在同一时刻看到同样的内容
- 某个节目在 20:00 开始
- 播放器旁边有一个“正在播出 / 即将播出”信息框
HLS 不过是由分片组成的播放列表。所以第一个想法很简单:先取第一个视频的分片,接着是第二个,然后是第三个。把它们作为一个直播播放列表提供出去,这个列表不断增长,永远不出现 #EXT-X-ENDLIST。只要分片源源不断,播放器并不关心分片从哪里来。
只要所有视频都一样、也没人改动节目,这个办法就行得通。下面讲的是面对真实的媒资库时,它在哪些地方出了问题,以及我们在 dodocast 的 24/7 频道里是怎么处理的。
我们的演示频道 Open Movies 24/7 运行在 dodocast 上:六部短片(Blender Foundation 以 CC BY 许可发布的开放电影和一段 NASA 视频)以 22 分钟为一轮循环播放,每天 20:00 UTC 开始一个名为 “Caminandes marathon” 的定时节目。这个流是公开的,下面的示例都用它。

主播放列表是整个会话的约定
在直播流中,播放器会反复重新读取媒体播放列表,而主播放列表只在开始播放时读取一次。从那以后,播放器就信任主播放列表声明的内容:各档画质(rendition)、分辨率、编解码器、音频组和字幕组。一个示意性的例子:
#EXTM3U
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="en",NAME="English",DEFAULT=YES,URI="audio/en.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",LANGUAGE="es",NAME="Español",URI="audio/es.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",LANGUAGE="en",NAME="English",URI="subs/en.m3u8"
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.640028,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2800000,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2",AUDIO="aud",SUBTITLES="subs"
720p/index.m3u8只有一个视频时,你根本注意不到这一点。而在频道里,播放过程中上线播出的每个视频都必须与主播放列表声明的内容一致。真实的媒资库并不一致:
- 有些视频上传的是 1080p,有些只有 720p
- 有一部电影是 2.39:1,其余都是 16:9
- 还有一部没有西班牙语音轨
如果播放器正在播 1080p,而下一个视频没有 1080p,播放器就没有东西可下载。
所以 dodocast 的频道有固定的格式。格式规定频道播出哪些画质(240p 到 1080p),并为所有画质规定同一个画面比例。不符合格式的视频不能进入节目。这比让所有正在观看的人遇到中断的流要好。控制台会显示原因:
| 标记 | 含义 |
|---|---|
| “missing 1080p” | 视频缺少频道声明的某个画质。 |
| “1080p encoding…” | 视频刚刚上传,1080p 转码还没完成。转码完成后就符合格式了。 |
| “too wide” | 视频画面比频道画面更宽,例如 16:9 频道中的 2.39:1 电影。 |
在 CODECS 中,avc1.640028 表示 H.264 High profile、level 4.0。浏览器读取这个字符串,判断自己的解码器能否处理该视频。如果频道只声明当前节目中视频的级别,之后加入一个要求更高的视频,就可能在某些设备上播放失败。所以频道声明的是一个留有余量的上限(控制台里叫 “Codec level headroom”,即编解码器级别余量)。播出中加入的视频不会超出这个上限。非常老旧的设备会拒绝较高的声明级别。如果你需要照顾这些设备,可以关闭余量,但这样一来,加入要求更高的视频时的风险就又回来了。
AUDIO 和 SUBTITLES 组也是同样的道理。假设频道声明了英语和西班牙语,而下一个视频只有英语。总得有人决定选了西班牙语的观众会听到什么。我们把这个决定交给了频道所有者。所有者设定频道承诺提供哪些语言。对于缺少这些语言的视频,所有者在两个选项中选一个:退回到视频的默认音轨,或者不让该视频播出。如果不声明任何字幕,即使视频带有字幕,播放器也不会显示。
出于同样的原因,格式、字幕语言和加密密钥只能在频道关闭时更改。
编辑节目而不中断播出
节目本身也会变化。人们会添加新视频、移除旧视频、调整其余视频的顺序,而且希望在播出中完成这些操作。如果编辑立即生效,正在看某个视频的观众会被跳到另一个视频的随机位置。
在 dodocast 中,每次编辑都会发布一个新版本的节目。新版本在下一个视频切换处生效,在此之前继续播放之前的版本。控制台会显示 “Edit takes effect at 9:36 PM”(编辑生效时间),并把视频标记为 “added”(已添加)或 “removed”(已移除)。观众看到的只是下一个视频开始播放。

循环之上的节目表
节目是一个永远运行的循环。但电视是按时钟运转的:20:00 的马拉松放映,工作日 9:00 的课程。所以定时节目放在循环之上的节目表里。
定时节目是在设定时间播出的一个视频或一整个播放列表:可以播一次、每天播或在选定的星期几播。定时节目的时长为 1 到 1,440 分钟。内容更长时,频道会截断;更短时,频道用填充内容补足剩余时间。定时节目不能重叠。
定时节目的时间使用频道的时区。所以“每天 20:00”在夏令时切换后仍然是 20:00,不会每年两次偏移一小时。
我们还得决定定时节目结束后循环怎么办。这个问题没有唯一正确的答案,所以它是一项频道设置:
| 选项 | 定时节目之后 | 适合 |
|---|---|---|
| From the start | 循环从头开始。 | 希望完整播出的较短填充节目 |
| Continue | 循环从被定时节目打断的位置继续。 | 较长的节目,重复播放开头会让人厌烦 |
| Background air | 循环一直在运行,定时节目只是覆盖在它上面播出。 | 背景按自己的时钟运行的“真正的电视”频道 |
节目表也可以在播出中编辑。频道会在一分钟内重新计算节目表,观众从下一次播出起看到更改。

EPG 与加密
网站上的频道几乎总是需要旁边有一个“正在播出”信息框或节目指南。频道以 JSON 格式发布当前状态和节目指南,并开放 CORS。所以你可以直接从浏览器请求,不需要从播放器里抓取数据。下面两个请求都可以对演示频道使用。

状态说明当前正在播哪个视频、下一个是哪个,以及下一个定时节目何时开始:
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI"精简后的响应:
{
"title": "Open Movies 24/7",
"state": "ON",
"currentItem": { "title": "Wing It!", "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
"nextItem": { "title": "Big Buck Bunny", "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
"nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 }
}完整响应
{
"code": "cBlTOROrQI",
"title": "Open Movies 24/7",
"description": null,
"tags": [],
"state": "ON",
"serverTimeMs": 1795088315571,
"itemCount": 6,
"totalDurationMs": 1324106,
"encrypted": false,
"poster": "https://stream.dodocast.com/preview/xOa9tZc7QO/cover.jpg?v=4ed796473e0a3fba01e92351074b25f147caa1eb3c33a090f026009ec0a356e1",
"currentItem": { "code": "xOa9tZc7QO", "title": "Wing It!", "durationMs": 237894, "startsAtMs": 1795088122186, "endsAtMs": 1795088360080 },
"nextItem": { "code": "x10F5HR9Zt", "title": "Big Buck Bunny", "durationMs": 634425, "startsAtMs": 1795088360080, "endsAtMs": 1795088994505 },
"currentShow": null,
"nextShow": { "title": "Caminandes marathon", "startsAtMs": 1795118400000, "endsAtMs": 1795118820000 },
"access": { "type": "PUBLIC", "granted": true, "requiresPassword": false },
"embedding": { "policy": "ALL", "domains": [] },
"theme": { "colorPrimary": "indigo", "colorNeutral": "zinc" },
"watchLayout": "LIVE_STAGE",
"sources": {
"mp4": "https://stream.dodocast.com/ch/mp4/cBlTOROrQI/master.m3u8",
"ts": "https://stream.dodocast.com/ch/ts/cBlTOROrQI/master.m3u8"
}
}下面的 CodePen 示例只用了这个请求和 hls.js。播放器播放演示频道,下方的信息框在每个视频结束时刷新。
在 CodePen 打开在线示例 →演示频道的播放器,以及根据频道状态 JSON 生成的“正在播出 / 即将播出”信息框(hls.js,无需 SDK)。节目指南只列出排定的定时节目,不包括循环中的视频。默认覆盖未来 24 小时;通过 from 和 to(毫秒级 Unix 时间)最长可以覆盖两周。下面请求的是未来七天:
FROM=$(date +%s)000; TO=$(( $(date +%s) + 7*86400 ))000
curl "https://stream.dodocast.com/public/ch/cBlTOROrQI/epg?from=$FROM&to=$TO"响应(七条中的前两条)
{
"code": "cBlTOROrQI",
"title": "Open Movies 24/7",
"serverTimeMs": 1795089367508,
"entries": [
{ "startsAtMs": 1795118400000, "endsAtMs": 1795118820000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] },
{ "startsAtMs": 1795204800000, "endsAtMs": 1795205220000, "title": "Caminandes marathon", "poster": "https://stream.dodocast.com/preview/V0bfQXjss9/cover.jpg?v=c8225aa7388e60b3bb82adc7856d621fb44a85a410c2e6fe338fa7eac95b2bf3", "subtitles": [] }
]
}Player SDK 封装了这些接口。getChannelState() 返回正在播出和即将播出的内容,getChannelGuide() 返回最长两周的节目指南,progress() 返回当前节目已经播到了哪里。
节目里也很容易混入加密和未加密的视频。如果每个视频都带着自己的密钥,播放器就要在每个切换处更换密钥。加密流中间夹着一个未加密的视频,会留下一个缺口。所以频道有自己的密钥。它忽略每个视频自身的加密设置,在分发时对分片进行加密。AES-128 和 SAMPLE-AES 能防止随手下载,但它们不是 DRM,网站上也是这么说明的。
频道目前还不支持的功能
- 接收摄像机或编码器的直播信号
- 在流中插入广告时段(SCTE-35)
- 让观众回看频道(DVR)
以 Premiere(首映)模式进行的单次直播允许观众回退到开头,但不能快进。
2 分钟了解 dodocast 在控制台里演示了上面这些内容。我们免费的 HLS 播放器 可以显示任意 HLS 流的内部内容:各档画质、CODECS 和轨道。它还可以用 hls.js 或浏览器内置播放器播放这个流,方便你比较两者。
我们在开发 dodocast,这是一个提供视频托管、24/7 频道和定时直播的视频平台。关于用 VOD 搭建线性 HLS 的问题,欢迎发邮件到 hello@dodocast.com。