本文档介绍视频会议 SDK 的云端录制功能。视频会议 SDK 已默认集成房间合流录制能力，无需自建后端调用 TRTC 云 API。您在控制台完成录制存储配置后，可以开启全房间录制，让房间自动录制；也可以由房主或管理员在会中一键录制。若默认能力不满足业务需求，请参见 与 TRTC 云端录制的区别，并参考 TRTC 云端录制 自行接入。
前提条件
使用视频会议 SDK 云端录制前，请确认已完成以下步骤：
已购买含云录制能力的视频会议 SDK 套餐并获取 SDKAppID 信息。
配置云端录制
1. 前往 实时音视频控制台 > 应用管理，选择目标应用，点击功能配置 > RoomKit 功能 > 配置房间录制。
2. 在录制配置页面，根据存储方式填写以下信息：
存储至云点播（VOD）：选择指定点播应用。
存储至对象存储（COS）：存储桶名称（Bucket）、地域（Region）、AccessKey（即 SecretId）和 SecretKey。
3. 如需房间自动录制，请在同一配置页开启全房间录制。
录制方式
视频会议 SDK 提供托管式云端录制方案，由 SDK 后台负责鉴权与录制任务管理。您完成存储配置后，即可使用全房间录制或会中一键录制进行房间合流录制。使用会中一键录制时，录制的开始与停止状态会实时同步给房间内所有成员。
视频会议 SDK 支持以下两种录制方式：
录制方式 | 说明 | 适用场景 |
全房间录制 | 在控制台开启后，通过视频会议 SDK 创建的房间会自动启动合流录制。房间结束或空闲超时后，系统自动停止录制。 | 所有房间均需录制，无需会中手动操作。 |
会中一键录制 | 房主或管理员在会中通过客户端接口或含 UI 集成组件发起、停止录制。 | 根据会议实际情况选择是否录制。 |
注意：
录制效果
视频会议 SDK 房间录制默认采用合流录制模式，将房间内发布的音视频流混合为一份完整的录制文件。全房间录制与会中一键录制的规则一致，录制内容包括：
音频：房间内所有参会者的声音。
视频：所有开启摄像头或屏幕分享的画面。
录制布局会随会中状态自动切换，切换过程中不重启录制任务：
说明：
录制任务运行期间，若房间内无任何音视频上行（参会者均未打开摄像头、麦克风或屏幕分享），录制文件仍会生成，但文件中将没有画面和声音。
会后文件获取
录制结束后，文件将存储在您配置的 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 云端录制 自行接入，注意两套方案同时使用会产生多份录制文件和额外费用。
更多文档
云端录制计费说明
