一、前提条件
使用视频会议 SDK 云端录制前,请确认已完成以下步骤:
·已购买含云录制能力的视频会议 SDK 套餐并获取 SDKAppID 信息。
·已开通录制文件存储服务。录制文件支持存储至 云点播(VOD) 或 对象存储(COS)。
二、配置云端录制
1. 前往 实时音视频控制台 > 应用管理,选择目标应用,点击功能配置 > RoomKit 功能 > 配置房间录制。
2. 在录制配置页面,根据存储方式填写以下信息:
·存储至云点播(VOD):选择指定点播应用。
·存储至对象存储(COS):存储桶名称(Bucket)、地域(Region)、AccessKey(即 SecretId)和 SecretKey。
3. 如需房间自动录制,请在同一配置页开启全房间录制。
三、录制方式
视频会议 SDK 提供托管式云端录制方案,由 SDK 后台负责鉴权与录制任务管理。你完成存储配置后,即可使用全房间录制或会中一键录制进行房间合流录制。使用会中一键录制时,录制的开始与停止状态会实时同步给房间内所有成员。
视频会议 SDK 支持以下两种录制方式:
| 录制方式 | 说明 | 适用场景 |
| 全房间录制 | 在控制台开启后,通过视频会议 SDK 创建的房间会自动启动合流录制。房间结束或空闲超时后,系统自动停止录制。 | 所有房间均需录制,无需会中手动操作。 |
| 会中一键录制 | 房主或管理员在会中通过客户端接口或含 UI 集成组件发起、停止录制。 | 根据会议实际情况选择是否录制。 |
注意:全房间录制、会中一键录制与 TRTC 云端录制可以同时使用,但会产出多份录制文件,并产生额外 费用。若无需生成多份录制文件,请只启用一种录制方式。
四、录制效果
视频会议 SDK 房间录制默认采用合流录制模式,将房间内发布的音视频流混合为一份完整的录制文件。全房间录制与会中一键录制的规则一致,录制内容包括:
·音频:房间内所有参会者的声音。
·视频:所有开启摄像头或屏幕分享的画面。
录制布局会随会中状态自动切换,切换过程中不重启录制任务:
| 会中状态 | 混流布局 | 画面数量上限 |
| 无屏幕分享或白板 | 九宫格布局 | 最多 25 路视频画面。 |
| 有屏幕分享或白板 | 屏幕分享布局(共享为主画面) | 最多 1 路屏幕分享/白板 + 16 路视频画面。 |
| 仅音频 | – | — |
注意:说明:
注意:录制任务运行期间,若房间内无任何音视频上行(参会者均未打开摄像头、麦克风或屏幕分享),录制文件仍会生成,但文件中将没有画面和声音。
五、会后文件获取
录制结束后,文件将存储在你配置的 VOD 或 COS 中。你可以通过以下方式获取录制文件:
·前往 实时音视频控制台 > 应用管理,在 录制管理 > 录制文件管理 中查看存储于云点播(VOD)的录制文件。
·若存储在对象存储(COS),请前往 对象存储(COS)控制台 查看。
·详细的文件查找、接收、删除与回放操作,请参见 录制文件管理。
六、与 TRTC 云端录制的区别
视频会议 SDK 房间录制与 TRTC 云端录制底层均基于 TRTC 云端录制服务。SDK 已针对会议场景预设合流录制参数;若你需要指定订阅主播、自定义合流布局、由服务端控制录制启停等能力,可使用 TRTC 云端录制自行接入。二者主要区别如下:
| 对比项 | 视频会议 SDK 房间录制 | TRTC 云端录制 |
| 录制范围 | 适用于当前 SDKAppID 下,通过视频会议 SDK 创建的房间。 | 适用于当前 SDKAppID 下所有 TRTC 房间(含其他 SDK 或 TRTC SDK 直接创建的房间)。 |
| 发起方式 | 在控制台开启全房间录制,或由房主、管理员在会中通过客户端接口或含 UI 集成组件发起、停止录制。 | 由自建后端调用 REST API(例如 CreateCloudRecording)控制录制。 |
| 录制文件 | 默认合流录制,产出一份合流文件;布局随会中是否有屏幕分享或白板自动切换(九宫格最多25路,屏幕分享布局最多1路屏幕分享或白板和16路视频画面)。 | 可选单流或合流录制,并支持自定义布局与订阅名单。 |
| 接入成本 | 在控制台配置存储地址即可,无需自建后端。 | 需自行集成 REST API 与回调。 |
| 任务管理 | 由 SDK 托管,不暴露 TaskId;同一房间同时只能存在一个录制任务。 | 可通过 DescribeCloudRecording(需 TaskId)查询任务状态;同一房间可同时发起多个独立任务。 |
七、如何查看录制时长明细?
你可以在 实时音视频控制台 > 云端录制 查看录制的一些时长明细:
八、如何管理录制文件?
目前提供的 录制文件管理 主要有以下操作:
查找录制文件、接收录制文件、删除录制文件、回放录制文件。
九、如何自定义录制文件名?
目前暂不支持重命名录制文件名,仅支持使用 API 录制 自定义设置文件名称前缀:使用 API 录制 存储至云点播 VOD 时,可通过 TencentVod 中的 UserDefineRecordId 参数自定义文件名称前缀,前缀与自动生成的录制文件名之间用_UserDefine_u_分开。
十、点击录制提示“录制配置不存在或未启用”怎么办?
此报错(错误码 101072)表示视频会议 SDK 后台尚未完成录制配置,请按以下步骤排查:
1. 确认已在控制台完成 VOD 或 COS 存储配置,且存储信息填写正确。
2. 确认云端录制功能已启用。
3. 完成配置后重新进入房间。若仍提示错误,请联系技术支持并提供 SDKAppID。
十一、录制结束后找不到文件怎么办?
请按以下步骤排查:
1. 确认录制期间是否有音视频上行:若录制期间房间内参会者均未打开摄像头、麦克风或屏幕分享,录制文件仍会生成,但文件中将没有画面和声音。如需录制有内容的文件,请确认录制期间至少有一名参会者开启了摄像头、麦克风或屏幕分享。
2. 确认存储配置正确:检查控制台中配置的 VOD 应用 AppID、账号 UIN,或 COS 的 Bucket、Region、AccessKey(SecretId)和 SecretKey 是否填写正确。
3. 确认查看的是目标录制方式产生的文件:若同时启用了多种录制方式,存储服务中会存在多份录制文件。VOD 文件请前往 实时音视频控制台 > 应用管理 > 录制文件管理 查看;COS 文件请前往 对象存储(COS)控制台 查看。
十二、能否用 TRTC 服务端 API 查询或控制视频会议 SDK 的录制任务?
不能。视频会议 SDK 录制与 TRTC 云端录制是完全独立的两套方案,管理通道互不相通:
·视频会议 SDK 录制任务由 SDK 后台统一托管,不暴露 TRTC TaskId,无法通过 CreateCloudRecording、DescribeCloudRecording 等 TRTC 服务端 API 查询或控制。
·同一房间内同时只能存在一个 SDK 录制任务,重复发起会返回错误。
·如需通过服务端 API 自主控制录制(如指定订阅用户、自定义布局等),请参阅 TRTC 云端录制 自行接入,注意两套方案同时使用会产生多份录制文件和额外费用。
十三、更多文档
·实现云端录制与回放
·云端录制服务端事件回调
·云端录制计费说明