文档简介:
简述视频拖拉的支持方式和配置建议。
功能介绍
视频点播网站或应用,通常都会提供视频拖拉能力,用户可以随意拖动播放器进度条到想要的位置。使用CDN加速后,您可以通过配置视频拖拉功能,支持用户的视频拖拉请求。
用户在点播网站对视频进行拖动时,会向服务器端发起形如:http://www.test.com/a.mp4?start=5 格式的请求,此时CDN节点如开启了视频拖拉功能,则会返回离第5s最近的关键帧开始,到视频文件末尾的音视频数据文件。
适用场景
需支持flv或mp4视频拖拉功能的视频点播网站。
注意事项
1、源站视频必须带有meta信息以及关键帧,如无,则视频拖拉功能无效,返回原始文件。
2、如视频拖拉请求携带的起始参数越界,例如start参数对应的字节位置超过文件大小,默认返回4xx状态码。
3、如视频拖拉请求携带的结尾参数越界,默认返回从起始参数开始到文件结尾位置的内容。
4、支持MP4文件moov头在尾部的视频拖拉。
5、在开启视频拖拉之前,请确认源站支持range请求,且能返回206状态码和range范围内的文件。
使用说明
该功能暂不支持客户自助配置,如需使用,请通过提交工单给天翼云客服,由其人工操作开启。
提交工单时,请附带如下信息:
视频文件格式 | 拖拉参数 | URL示例 |
---|---|---|
mp4 |
1、支持按时间拖拉;请说明具体起始参数和结尾参数 ;默认起始和结尾参数为start和end,单位为s。 2、请说明拖拉时是前向还是后向查找起始参数的最近关键帧, 默认是后向查找,如需前向查找, 请具体说明;例如start=5,则默认返回离第5s最近的后向关键帧。 |
http://www.test.com/a.mp4?start=5表示从a.mp4 文件的第5s开始返回音视频内容。 |
flv |
1、支持按字节或时间拖拉;请说明具体是按字节还是按时间拖拉。 2、请说明起始参数和结尾参数,其中起始参数是必须项; 默认字节拖拉起始和结尾参数为begin和stop, 对应区间为左闭右开(可按需调整为左闭右闭,如需调整请说明); 默认时间拖拉起始和结尾参数为start和end,对应区间为左闭右闭。 3、时间拖拉时,如用户请求携带时间拖拉参数的同时有range请求头, 可支持忽略range头, 或在时间拖拉范围内取相对range,即先基于时间拖拉参数得到新文件 (包含meta头和拖拽区间), 再在新文件基础上取range;默认为忽略range头, 如需在时间拖拉范围内取相对range,请具体说明。 4、flv拖拉请求除返回拖拉对应的音视频外,还会返回flv媒体头, 默认为flv header; 如需返回flv header+script tag(metadata) + 首个video tag +首个audio tag, 请说明选择meta头作为flv媒体头;如需返回flv header+ 首个video tag+首个audio tag, 请说明选择media头作为flv媒体头。 |
1、请求url:http://www.test.com/a.flv?start=5&end=15, 如为时间拖则返回flv媒体头加上从a.flv文件的第5s开始, 截止到15s结束的内容。 2、请求url:http://www.test.com/a.flv?begin=100&stop=1000, 如为字节拖拉, 则返回flv媒体头加上从a.flv文件的第100个字节开始, 截止到第999个字节的内容。 |