云端录制 (TUIRoomKit)

最近更新时间:2024-03-22 15:46:32

我的收藏
本文将介绍如何快速使用 TUIRoomKit 云端录制功能,帮助开发者在视频会议、在线教育、直播互动等场景中,实现对重要内容进行存档、审核等多样化需求。我们提供了两个方案供开发者选择:自动录制方案 REST API 录制方案
说明:
TUIRoomKit 整合有多个腾讯云基础的 PaaS 服务,其中音视频相关能力依赖于 实时音视频 TRTC,因为 TUICallKit 的云端录制功能需要进入 实时音视频控制台 进行配置。

方案一:自动录制方案(推荐)

自动录制方案的优点是录制不需客户手动启动和停止,由 TRTC 后台自动管理录制任务:若检测到房间中有上行音视频后将触发启动录制任务,若房间内主播都退房且超过设置的等待续录时间后将触发停止录制任务。您可以通过如下几步快速完成配置:
1. 实时音视频控制台 > 应用管理 找到对应 SDKAppId 的应用,选择操作 > 配置,详见下图:


2. 点击左侧导航栏的录制管理,点击开通录制服务


3. 开通录制服务后,在配置页中打开启用云端录制功能,然后在全局自动录制模板中点击创建模板。


4. 配置全局自动录制模板可参考以下参数进行配置,您也可以根据自己的业务需求配置自定义录制模板,具体配置项说明参见:全局自动录制配置项说明
说明:
全局自动录制仅支持 单流录制(即每个主播单个录制一个文件),开启后只对新创建的房间有效,对开启自动录制功能之前已经创建的房间不生效。如需录制多路流混合后的画面,请使用REST API 录制方案
全局自动录制支持最多录制一个房间内的25个主播,如果超过25个主播将会按照进房时间由先到后排序,录制前25位主播(如需单流录制超过25位主播,请参见 REST API 录制方案)。




方案二:REST API 录制方案

如果您在业务上需要指定录制订阅房间内的主播、自定义合流布局、录制中途更新布局等自定义业务需求。您可以使用API 录制方案,相比自动录制方案会更加灵活、功能完备。
1. 实时音视频控制台 > 应用管理 找到对应 SDKAppId 的应用,选择操作 > 配置。
2. 点击左侧导航栏的录制管理,点击开通录制服务,此时默认勾选手动自定义录制,即 REST API 模式。


3. 点击左侧导航栏的回调配置,可通过配置并监听服务端的 房间与媒体回调 事件在您的后台服务调用 REST API (CreateCloudRecording)来控制启动云端录制的时机。详细操作说明请参考:
说明:
手动录制下,您可以前往控制台配置回调地址,以接受录制回调事件,请见 录制回调说明




常见问题

1. 两种录制方案可以同时使用吗?

自动录制方案 REST API 录制方案这两种方案并不冲突,可以同时使用两种录制方案,但会产生两份录制文件和 费用

2. 如何查看录制时长明细?

您可以在 实时音视频控制台 > 云端录制 查看录制的一些时长明细:



3. 如何管理录制文件?

目前提供的 录制文件管理 主要有以下操作:

4. 如何自定义录制文件名?

目前暂不支持重命名录制文件名,仅支持使用 API 录制 自定义设置文件名称前缀:使用 API 录制 存储至云点播 VOD 时,可通过 TencentVod 中的 UserDefineRecordId 参数自定义文件名称前缀,前缀与自动生成的录制文件名之间用_UserDefine_u_分开。

更多文档