tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务(TUILiveKit)
Demo 体验
Demo 体验指引
跑通 Demo(TUILiveKit)
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手(Electron 桌面应用)
推流助手(Web 桌面浏览器)
直播监播
监播页面(Web 桌面浏览器 React 版)
监播页面(Web 桌面浏览器 Vue 版)
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播(TUILiveKit)
至臻画质(TUILiveKit)
输入媒体流进房(TUILiveKit)
礼物系统(TUILiveKit)
客户端 API
Android
iOS
Web
服务端 API(TUILiveKit)
账号系统
REST API
第三方回调
错误码(TUILiveKit)
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice

录制和回看

聚焦模式
字号
最后更新时间: 2025-06-24 18:07:07

功能介绍

录制回看是指您可以把用户整个直播过程录制下来,然后作为点播视频用于回看。
在 App 上线的初期阶段,由于主播数量比较少,所以在直播列表中加入录制回看,能够在一定程度上丰富 App 在观众端的信息量。即使到 App 成长起来主播数量形成规模以后,好的直播内容的沉淀依然是必不可少的一个部分,每个主播的个人介绍里除了有名字、照片和个人信息,历史直播的视频回看更是不可或缺的一个重要组成部分。

开启录制

录制回看功能依托于腾讯云的云点播服务支撑,如果您想要对接这个功能,首先需要在腾讯云的管理控制台 开通云点播服务。服务开通之后,新录制的文件就可以在云点播控制台的 视频管理 里找到它们。
开启录制的方法如下:
说明:
如需通过 API 对直播频道进行录制,详细请参见 创建录制任务
录制转点播后,文件自动存放于点播平台,故用户需在使用录制功能前,提前开通点播服务并购买相关空间和流量用于存放和播放录制后的视频文件,详细请参见 点播快速入门

基本步骤

在云直播控制台菜单栏内选择功能配置 > 直播录制,单击创建录制模板进行设置。设置完基本信息后,单击保存 。具体操作请参见 录制模板配置


配置项
配置描述
单个录制文件时长(分钟)
录制 HLS 格式最长单个文件时长无限制,如果超出续录等待时长则新建文件继续录制。录制 MP4、FLV 或 AAC 格式单个文件时长限制为1分钟 - 120分钟。
续录等待时长(秒)
仅 HLS 格式支持文件推流中断续录,续录等待时长可设置为0s - 1800s。
保存时长(天)
单个录制文件保存最大时长均为1500天,文件保存时长0为永久。可选择永久存储或指定时间。
指定点播应用/分类
支持录制至云点播 VOD 指定 子应用 的点播分类中,默认录制至账号主应用,仅支持写入状态为开启的子应用。
高级配置
视频存储策略
支持对录制至云点播上的媒资进行降冷操作,若录制文件不需要频繁访问,可以使用降冷功能来实现低频访问长期存储。若录制视频为正常业务回放需要,标准存储即可满足需求,默认为标准存储。
选择 标准存储 时,若目前选中的应用已开启降冷策略,录制文件会先生成标准存储文件后再根据降冷策略进行降冷,可 查看策略
选择 低频存储 时,若目前选中的应用/分类已开启降冷策略,录制文件会先直接生成低频存储文件后再判断是否执行点播降冷策略。
点播任务流处理
单击 选择绑定的任务流 可选择绑定点播子应用下已建立的任务流,或从当前点播任务流选择界面点击任务流名称前往点播控制台新增/修改任务流配置。绑定成功后,在生成录制文件后执行点播任务流模板,产生对应的 云点播费用

关联域名

创建好录制模板后,需在 域名管理 中,选择对应的推流域名,进入 模板配置 栏,单击 录制配置 > 编辑 为该域名指定录制模板后,单击 保存 即可。更多详情请参见 关联录制模板



获取文件

一个新的录制视频文件生成后,会相应的生成一个观看地址,您可以按照自己的业务需求对其进行处理。在小直播中,我们直接将录制的文件 URL 和房间列表拼在了一起,以弥补在线主播不足的窘境。
但您可以结合自己的业务场景实现很多的扩展功能,例如:您可以将其追加到主播的资料信息里,作为该主播曾经直播的节目而存在;或者将其放入回放列表中,经过专门的人工筛选,将优质的视频推荐给您的 App 用户。
如何才能拿到文件的地址,有如下两种解决方案:

方案1:被动监听通知

您可以使用腾讯云的 回调配置:您的服务器注册一个自己的回调 URL 给腾讯云,腾讯云会在一个新的录制文件生成时通过这个 URL 通知给您。
在云直播菜单栏内选择事件中心 > 直播回调,单击创建回调模板 。在回调设置弹框中填写完成回调信息,单击保存即可。更多详情请参见 创建回调模板


关联域名 创建好回调模板后,需通在 域名管理 中,选择对应的推流域名,进入模板配置栏,单击回调配置 > 编辑为该域名指定回调模板后,单击确定即可。

如下是一个典型的通知消息,它的含义是:一个 ID 为9192487266581821586的新的 FLV 录制文件已经生成,播放地址为:http://200025724.vod.myqcloud.com/200025724_ac92b781a22c4a3e937c9e61c2624af7.f0.flv
{
"channel_id": "2121_15919131751",
"end_time": 1473125627,
"event_type": 100,
"file_format": "flv",
"file_id": "9192487266581821586",
"file_size": 9749353,
"sign": "fef79a097458ed80b5f5574cbc13e1fd",
"start_time": 1473135647,
"stream_id": "2121_15919131751",
"t": 1473126233,
"video_id": "200025724_ac92b781a22c4a3e937c9e61c2624af7",
"video_url": "http://200025724.vod.myqcloud.com/200025724_ac92b781a22c4a3e937c9e61c2624af7.f0.flv"
}

方案2:主动查询获取

录制文件生成后自动存储到点播系统,您可以直接在点播系统查看,或直接通过点播 API 查询,详情请参见 录制文件获取

常见问题

1. 直播录制的原理是什么?



对于一条直播流,一旦开启录制,音视频数据就会被旁路到录制系统。主播的手机推上来的每一帧数据,都会被录制系统追加写入到录制文件中。
一旦直播流中断,接入层会立刻通知录制服务器将正在写入的文件落地,将其转存到点播系统中,并为其生成索引,这样您在点播系统中就会看到这个新生成的录制文件了。同时,如果您配置了录制事件通知,录制系统会将该文件的索引 ID在线播放地址等信息通知给您之前配置的服务器上。
但是,如果一个文件过大,在云端的转出和处理过程中就很容易出错,所以为了确保成功率,我们的单个录制文件最长不会超过120分钟,您可以通过 RecordInterval 参数指定更短的分片。

2. 一次直播会有几个录制文件?

录制 MP4、FLV 或 AAC 格式:单个文件时长限制为1分钟 - 120分钟。您可以通过 创建录制模板 接口中的 RecordInterval 参数指定更短的分片。
如果一次直播过程非常短暂,录制模块未启动就结束推流,那么系统会无法生成录制文件。
如果一次直播时间不算长(小于 RecordInterval),且中途没有推流中断的事情发生,那么通常只有一个文件。
如果一次直播时间很长(超过 RecordInterval ),那么会按照 RecordInterval 指定的时间长度进行分片,分片的原因是避免过长的文件在分布式系统中流转时间的不确定性。
如果一次直播过程中发生推流中断(之后 SDK 会尝试重新推流),那么每次中断均会产生一个新的分片。
录制 HLS 格式:最长单个文件时长无限制,如果超出续录超时时间则新建文件继续录制。续录超时时长可设置为0s - 1800s。

3. 如何知道哪些文件属于某一次直播?

准确来说,作为 PAAS 的腾讯云并不清楚您的一次直播是怎么定义的,如果您的一次直播持续了20分钟,但中间有一次因为网络切换导致的断流,以及一次手动的停止和重启,那么这算是一次直播还是三次呢?
对于普通的移动直播场景,我们一般定义如下的界面之间的这段时间为一次直播:


所以来自 App 客户端的时间信息很重要,如果您希望定义这段时间内的录制文件都属于这次直播,那么只需要用直播码和时间信息检索收到的录制通知即可(每一条录制通知事件都会携带 StreamID、开始时间和结束时间等信息)。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈