多线路播放器接口
一条播放地址挂了,用户就流失。多线路播放器接口把同一部片的 3 到 5 条线路排序后一起返回,按失败次数自动降级,切换过程在播放器内部完成,用户看到的只是画面卡了半秒。
接口参数
| 接口版本 | MacCMS V10 播放组兼容,vod_play_from 用 $$$ 分组 |
|---|---|
| 输出格式 | JSON:线路数组,含线路名、优先级、测速结果、地址 |
| 并发配额 | 标准套餐 150 QPS,扩容 600 QPS;测速请求单独计 |
| 字段覆盖 | 14 项,含 lines、priority、rtt_ms、fail_count、codec |
| 兼容性 | 苹果CMS V10 自带播放器、DPlayer、自定义 hls 播放器 |
| 部署方式 | 公网接口加前端脚本,脚本 6KB,不依赖框架 |
| 数据合规 | 线路地址与测速结果,不记录用户播放行为 |
| SLA 响应 | 全线失败超过 10 分钟触发值班,15 分钟内给替代线路 |
| 切换策略 | 单线路连续 3 次失败即切下一条,切回需稳定 60 秒 |
参数按 多线路播放器接口 的交付口径写,实际配额以控制台显示为准。
三个实际使用场合
晚间高峰的线路降级
20:00 到 22:00 是高峰,主线路延迟从 40ms 涨到 300ms。接口按 rtt_ms 排序,前端取最快的一条,卡顿投诉从每天 20 多条降到 3 条。
选集后的秒开
切集时不必重新测速,接口按剧集维度缓存线路结果 2 分钟,切集首帧平均 1.1 秒。
单线路被封后的兜底
某条线路被源站封了 referer,连续 3 次 403 后自动切到下一条,用户端只看到一次重连提示。
选型建议
线路数量不是越多越好。实测超过 5 条以后,前端测速耗时会盖过收益,用户等待反而变长。3 到 4 条是合理区间:一条主用、两条备用、一条低码率兜底。另外要看测速口径,按首字节时间排比按 ping 排更贴近真实播放体验。
客户为什么选这一条,而不是隔壁那家
三条可验证的差异
- 按首字节时间排序:不是按 ping,rtt_ms 取的是首个切片返回时间,更接近用户体感。
- 切换状态机在前端:线路切换不重载页面,播放进度保留,切完从原位置继续。
- 失败计数会衰减:单线路失败计数 10 分钟后减半,避免一次抖动被永久降权。
交付周期与售后条款
| 阶段 | 时间与内容 |
|---|---|
| 测试 key | 当天开通,含 2000 次试调用 |
| 播放器接入 | 1 个工作日,交付脚本与示例页 |
| 正式上线 | 第 3 个工作日,可先切 20% 用户 |
线路全挂时提供替代线路清单,30 分钟内到位;前端脚本兼容问题 48 小时内修;不承担源站自身故障导致的播放中断责任。
这一类里的其他接口
相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见播放解析转码,完整字段说明在对接文档。
常被问到的问题
能自己加线路吗
能,控制台可加自有线路,最多 8 条,测速逻辑复用。
测速会消耗流量吗
会,每次测速取首个切片前 1MB,按测速次数单独计配额。
支持 HLS 以外的格式吗
支持 mp4 直链与 flv,flv 需要播放器侧支持。