M3U8解析接口
M3U8解析接口做三件事:读索引、拼切片、带 key。索引按 RFC 8216 解析,切片地址按相对路径还原成绝对地址,AES-128 的 key 请求由服务端代取,前端不用再处理跨域和 referer。
接口参数
| 接口版本 | REST 风格,POST /parse,返回 JSON;协议遵循 RFC 8216 |
|---|---|
| 输出格式 | JSON:切片数组、时长、加密方式、清晰度标记 |
| 并发配额 | 标准套餐 200 QPS,扩容套餐 800 QPS,按峰值计 |
| 字段覆盖 | 12 项,含 segments、duration、key_uri、bandwidth、codec |
| 兼容性 | HLS 标准播放器、hls.js 1.x、原生 Safari 播放器 |
| 部署方式 | 公网 HTTPS 接口,可选私有化部署到自有服务器 |
| 数据合规 | 只做地址解析,不转存切片内容,日志保留 7 天 |
| SLA 响应 | 解析失败率超过 3% 触发告警,30 分钟内响应 |
| 切片超时 | 单片 8 秒超时,超时后回明确错误码而不是空数组 |
参数按 M3U8解析接口 的交付口径写,实际配额以控制台显示为准。
三个实际使用场合
异地播放的跨域问题
切片域名不带跨域头,浏览器直连会被拦。走解析接口后由服务端取流再回给前端,跨域问题在服务端解决,前端只处理一个地址。
加密流的 key 代取
AES-128 加密流的 key 地址带时效签名,前端自己取容易过期。解析接口按请求时间重新签名,过期率从 12% 降到 1% 以内。
清晰度自动降级
同一部片有 1080P 与 720P 两套索引。解析接口按 bandwidth 排序,网络差时先给 720P,播放器切换不用重新拉全量索引。
选型建议
先确认播放串是不是标准 HLS。带 #EXT-X-STREAM-INF 的多码率索引需要解析器支持主列表,只做单码率的小解析器会在多码率流上直接报错。另一个判断点是加密:只有 AES-128 的需要代取 key,SAMPLE-AES 场景要单独评估,不能直接套这一条。
客户为什么选这一条,而不是隔壁那家
三条可验证的差异
- 错误码分 9 类:索引 404、切片超时、key 403、编码不支持各有独立码,排查不用翻日志。
- 相对路径自动还原:索引里写 ../seg/1.ts 这种相对路径也能拼成绝对地址,不用前端补。
- 解析结果带缓存头:同一索引 5 分钟内命中缓存,命中率约 78%,回源压力下降明显。
交付周期与售后条款
| 阶段 | 时间与内容 |
|---|---|
| 测试 key | 当天开通,含 1000 次试调用 |
| 链路联调 | 1 至 2 个工作日,交付调用示例 |
| 正式上线 | 第 4 个工作日,可灰度 10% 流量 |
解析错误按错误码归因,非我方原因(源站 404)不计入 SLA;接口版本升级保留旧版 30 天;不承诺任何片源的可播放性,只保证解析逻辑正确。
这一类里的其他接口
相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见播放解析转码,完整字段说明在对接文档。
常被问到的问题
能解析 mp4 直链吗
能,直链按单切片返回,时长字段可能为空。
支持 DRM 吗
不支持 Widevine 等 DRM,只做 HLS 常规加密。
能私有化部署吗
能,容器镜像交付,最低 2 核 4G,需要能访问源站。