功能介绍
视频点播网站或应用,通常都会提供视频拖拉能力,用户可以随意拖动播放器进度条到想要的位置。使用CDN加速后,您可以通过配置视频拖拉功能,支持用户的视频拖拉请求。
用户在点播网站对视频进行拖动时,会向服务器端发起形如:http://ctyun.cn/a.mp4?start=5 格式的请求,此时CDN节点如开启了视频拖拉功能,则会返回离第5s最近的关键帧开始,到视频文件末尾的音视频数据文件。
适用场景
需支持flv或mp4视频拖拉功能的视频点播网站。
注意事项
- 源站视频必须带有meta信息以及关键帧,如无,则视频拖拉功能无效,返回原始文件。
- 如视频拖拉请求携带的起始参数越界,例如start参数对应的字节位置超过文件大小,默认返回4xx状态码。
- 如视频拖拉请求携带的结尾参数越界,mp4时间拖拉和flv时间拖拉默认返回从起始参数开始到文件结尾位置的内容,flv按字节拖拉默认返回416。
- 支持mp4文件moov头在尾部的视频拖拉。
- 在开启视频拖拉之前,请确认源站支持range请求,且能返回206状态码和对应range范围内的文件。
使用说明
- 登录CDN控制台。
- 单击左侧导航栏【域名管理】-【域名列表】。
- 在【域名列表】页面,找到目标域名,单击【操作】列的【编辑】。
- 单击右侧【视频拖拉】。
- 在【mp4拖拉】模块,开启功能并根据需求填写配置信息。
- 在【flv拖拉】模块,单击【增加规则】,弹出的对话框中,添加flv4拖拉。
- 单击【确定】,点击【保存】,完成配置。
视频文件格式 | 拖拉参数 | URL示例 |
---|---|---|
mp4 | 1.支持按时间拖拉;请说明具体起始参数和结尾参数;默认起始和结尾参数为start和end,单位为s。 2.请说明拖拉时是前向还是后向查找起始参数的最近关键帧,默认是后向查找,如需前向查找,请具体说明;例如start=5,则默认返回离第5s最近的后向关键帧。 |
http://ctyun.cn/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://ctyun.cn/a.flv?start=5&end=15,如为时间拖拉,则返回flv媒体头加上从a.flv文件的第5s开始,截止到15s结束的内容。 2.请求url:http://ctyun.cn/a.flv?begin=100&stop=1000,如为字节拖拉,则返回flv媒体头加上从a.flv文件的第100个字节开始,截止到第999个字节的内容。 |