接口咨询 020-3886 5521

多线路播放器接口

一条播放地址挂了,用户就流失。多线路播放器接口把同一部片的 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 需要播放器侧支持。