You need to enable JavaScript to run this app.
导航
时移配置
最近更新时间:2024.10.29 17:41:18首次发布时间:2022.02.24 18:33:53

视频直播支持直播时移,其可将 HLS(HTTP Live Streaming)视频流切分为 TS(Transport Stream)分片并进行保存,从而实现对直播流任意时间点内容的回放。本文为您介绍如何通过视频直播控制台添加、管理时移配置。

背景信息

使用直播时移会产生相应的费用,详情请参见时移费用

前提条件

已完成域名添加

注意事项

生效条件:直播时移配置启动后,需要重新推流才会生效,对正在进行中的直播流,新设置的时移不生效。

操作步骤

添加时移配置

  1. 登录视频直播控制台

  2. 左侧导航栏选择功能管理 > 功能配置,选择时移配置页签。

  3. 在页面域名空间的下拉列表中选择域名空间。

  4. 单击添加配置按钮,打开添加时移配置对话框。

  5. 根据页面提示配置 AppName、时移时长和分发域名参数。

    参数说明如下表所示。

    参数说明
    AppName填写需要配置时移的 AppName,支持大小写字母、数字、-、_,最大长度不超过 30 位。
    StreamName设置开启时移的流名,同一 App 最多可开启 20 路流。
    时移天数观看时移的最长时间,支持选择 1天、3天、7天或 15天,到期后自动清理时移存储文件。
    分发域名选择的时移分发域名,下拉列表显示与当前域名空间关联的分发域名。
  6. 单击确定按钮,完成配置。可在列表中查看配置结果。

  7. 新增直播时移的状态为配置中,需等待 3~5 分钟配置会生效,该直播时移配置状态会更新为已启用

    说明

    直播时移配置启动后,需要重新推流才会生效,对正在进行中的直播流,新设置的时移不生效。

管理时移配置

在时移配置列表页面,您可以对时移配置进行以下管理操作。

  • 修改时移配置:单击待修改时移配置右侧的编辑按钮,您可以修改时移天数。
  • 删除录制配置:单击待删除时移配置右侧的删除按钮,在弹出的删除确认框中单击确定。

说明

删除时移配置,存储在视频直播中的文件不会被删除。

后续操作

拼接直播时移播放地址

完成时移配置并重新推流之后,需要手动拼接直播时移播放地址。拼接规则如下所示。

  • 相对时移:{PullDomain}/{AppName}/{StreamName}.m3u8?{鉴权参数}&timeshift={时间}
  • 绝对时移(回看模式):{PullDomain}/{AppName}/{StreamName}.m3u8?{鉴权参数}&start={UTC 时间/绝对时间/Human 时间}&end={UTC 时间/绝对时间/Human 时间}

参数说明如下表所示。

参数说明
{PullDomain}您配置直播时移时选择的拉流域名
{AppName}应用名称
{StreamName}流名称
m3u8固定字段,无需修改

{鉴权参数}

拼接鉴权信息。如果域名设置了播放鉴权,则播放时需要添加鉴权参数;反之,则可省略。
鉴权信息拼接格式为:volcTime={UnixTime}&volcSecret=md5("/{AppName}/{StreamName}{SecretKey}{volcTime}"),鉴权信息中需包含下列参数。

  • {UnixTime}:Unix 时间戳,需大于当前服务器时间;
  • {AppName}:应用名称;
  • {StreamName}:流名称;
  • {SecretKey}:鉴权秘钥,在 URL 鉴权配置时获取,可使用主 KEY 或副 KEY。

timeshift

相对时移时长,单位秒。取值范围为 (0,604800]
例如,timeshift 为 300,则表示观众可以看 5 分钟前的直播回放

start

时移的开始时间,支持 3 种时间格式。

  • UTC 时间:世界标准时间,例如,2019-05-18T09:15:00Z;
  • 绝对时间:Unix 时间,例如,1558167800;
  • Human 时间:人类可读的格式化日期,例如,20190518163900。
end时移的结束时间,时间格式同 start