文档

配置拖拽播放

更新时间:

当您播放视音频时,需要随意拖拽播放进度,而不影响视音频的播放效果,可以开启拖拽播放功能。通过本文您可以了解配置拖拽播放功能的操作方法。

背景信息

  • 拖拽播放功能是指在视音频点播场景中,如果您拖拽播放进度,则客户端会向服务器端发送URL请求。

    例如:如果文件格式为FLV,URL请求为www.aliyun.com/test.flv?start=10,服务端会向客户端响应从第10字节的前一个关键帧(如果start=10不是关键帧所在位置)的数据内容。 拖拽播放功能支持的文件和URL格式如下表所示。

    文件格式

    Meta信息

    Start参数

    举例

    MP4

    源站视频的meta信息必须在文件头部,不支持meta信息在尾部的视频。

    start参数表示时间,单位是秒,支持以小数表示,最多支持三位小数。例如start=1.01,表示开始时间是1.01秒。

    • 如果当前start不是关键帧所在位置,CDN会自动定位到start参数所表示时间的前一个关键帧(如果当前start不是关键帧所在位置)。

    • 如果当前start是关键帧所在位置,CDN会自动定位到start参数所表示时间的当前关键帧。

    URL请求为domain/video.mp4?start=10,表示从第10秒开始播放视频。

    FLV

    源站视频必须带有meta信息。

    start参数表示字节,不支持小数,虽然参数可以写小数,但是拖拽模块会把小数转为正整数,只舍不入。

    • 如果当前start不是关键帧所在位置,CDN会自动定位到start参数所表示字节的前一个关键帧。

    • 如果当前start不是关键帧所在位置,CDN会自动定位到start参数所表示字节的当前关键帧。

    URL请求为domain/video.flv?start=10,表示从第10字节的前一个关键帧开始播放视频。

  • 配置拖拽播放功能之前,需要确认源站支持Range请求。如果HTTP请求头中包含Range字段,则源站需要响应正确的206文件分片。

  • 开启拖拽播放功能后,将会增加首字节延迟,大概会增加30ms。

操作步骤

  1. 登录CDN控制台
  2. 在左侧导航栏,单击域名管理
  3. 域名管理页面,单击目标域名对应的管理
    域名管理
  4. 在指定域名的左侧导航栏,单击视频相关
  5. 拖拽播放区域,打开拖拽播放开关。

  6. (可选)开启FLV文件按时间拖拽。

    打开FLV按时间拖拽 开关。

  7. (可选)自定义开始和结束时间的参数名。

    1. 单击自定义参数 配置项对应的修改

    2. 拖拽播放自定义参数对话框,配置拖拽播放的开始和结束参数。

      说明
      • 开始参数默认为start,结束参数默认为end。

      • 自定义参数只能使用大小写字母、数字及下划线(_)。例如:123、aabbAABB、aa_BB123。

      • 如果仅开启拖拽播放开关,则开始和结束参数的单位为字节。

      • 如果同时开启拖拽播放FLV按时间拖拽 开关,则开始和结束参数的单位为秒。

    3. 单击确定