云端录制
下载
聚焦模式
字号
本文档介绍视频会议 SDK 的云端录制功能。视频会议 SDK 已默认集成房间合流录制能力，无需自建后端调用 TRTC 云 API。您在控制台完成录制存储配置后，即可通过两种方式录制：开启全局自动录制，让房间自动录制；或由房主、管理员在会中一键录制。若默认能力不满足业务需求，请参见 TRTC 云端录制 自行接入。
说明：
前提条件
使用视频会议 SDK 云端录制前，请确认已完成以下步骤：
1. 已购买包含云端录制能力的视频会议 SDK 套餐，并获取 SDKAppID。
2. 已开通录制文件存储服务。录制文件可存储至云点播（VOD）、对象存储（COS）或 AWS S3，请在对应产品的控制台开通其中一种，并记录存储信息。
3. 在 实时音视频控制台配置页 顶部选择目标应用，单击配置。
在录制配置页面，根据所选的存储方式填写以下信息：
存储至云点播（VOD）：账号 UIN 和云点播应用 AppID。
存储至对象存储（COS）：存储桶名称（Bucket）、地域（Region）、AccessKey（即 SecretId）和 SecretKey。
存储至 AWS S3：存储桶名称（Bucket）、地域（Region，示例：
ap-southeast-1）、AWS Access Key ID 和 AWS Secret Access Key。4. 如需房间自动录制，请在同一配置页开启全局自动录制，并根据业务需求配置录制模板。
注意：
完成存储配置后，即可在视频会议 SDK 中一键开启录制。全局自动录制为可选配置，与会中一键录制产出的录制文件规则一致。
功能说明
视频会议 SDK 提供托管式云端录制方案，由 SDK 后台负责鉴权与录制任务管理。您完成存储配置后即可发起房间合流录制，录制的开始与停止状态会实时同步给房间内所有成员。
视频会议 SDK 支持以下两种发起方式：
发起方式 | 说明 | 适用场景 |
全局自动录制 | 在控制台开启后，通过视频会议 SDK 创建的房间会自动启动合流录制，房间结束或空闲超时后自动停止。 | 所有房间都需要录制，无需会中手动操作。 |
会中一键录制 | 房主或管理员在会中通过客户端接口或含 UI 集成组件发起、停止录制。 | 按会议实际情况选择是否录制。 |
注意：
录制效果
视频会议 SDK 房间录制默认采用合流录制模式，将房间内发布的音视频流混合为一份录制文件。全局自动录制与会中一键录制的规则一致，录制内容包括：
音频：房间内所有参会者的声音。
视频：所有开启摄像头或屏幕分享的画面。
录制布局会随会中状态自动切换，切换过程中不重启录制任务：
会中状态 | 混流布局 | 画面数量上限 |
无屏幕分享或白板 | 自动调整每个画面的大小，每路视频画面大小一致 | 最多 25 路视频画面 |
有屏幕分享或白板 | 屏幕分享或白板内容在屏幕左侧的大画面位置，其他视频画面自上而下依次垂直排列于右侧 | 最多 1 路屏幕分享或白板和 16 路视频画面 |
仅音频 | - | - |
说明：
录制期间，若房间内无任何音视频上行（参会者均未打开摄像头、麦克风或屏幕分享），录制文件仍会生成，但没有画面和声音。
会后文件获取
录制结束后，文件将存储到您配置的 VOD、COS 或 AWS S3 中。您可以通过以下方式获取：
若存储在云点播（VOD），请前往 实时音视频控制台 > 音视频管理，查看录制后的文件。
若存储在对象存储（COS）或 AWS S3，请前往对应存储桶查看。
与 TRTC 云端录制的区别
视频会议 SDK 房间录制与 TRTC 云端录制底层均基于同一套 TRTC 录制服务。视频会议 SDK 已针对会议场景预设合流录制参数；若您需要指定订阅主播、自定义合流布局或由服务端控制录制启停，请使用 TRTC 云端录制自行接入。二者主要区别如下：
对比项 | 视频会议 SDK 房间录制 | TRTC 云端录制 |
录制范围 | 适用于当前 SDKAppID 下通过视频会议 SDK 创建的房间。 | 适用于当前 SDKAppID 下所有 TRTC 房间（含其他 SDK 或 TRTC SDK 直接创建的房间）。 |
发起方式 | 在控制台开启全局自动录制，或由房主、管理员在会中通过客户端接口或含 UI 集成组件发起、停止录制。 | |
录制文件 | 默认合流录制，产出一份合流文件；布局随会中是否有屏幕分享或白板自动切换。 | 可选单流或合流录制，并支持自定义布局与订阅名单。 |
接入成本 | 在控制台配置存储地址即可，无需自建后端。 | 需自行集成 REST API 与回调。 |
任务管理 | 由 SDK 托管，不暴露 TaskId。 | 可通过 DescribeCloudRecording（需 TaskId）查询任务状态；同一房间可同时发起多个独立任务。 |
说明：
常见问题
多种录制方案可以同时使用吗？
可以。全局自动录制、会中一键录制与 TRTC 云端录制可以同时使用，但会产出多份录制文件，并产生额外 费用。其中全局自动录制与会中一键录制同属视频会议 SDK 房间录制，TRTC 云端录制为独立方案，两者的管理通道互不相通。若不需要多份录制产物，请只保留一种发起方式。
单击录制提示“录制配置不存在或未启用”怎么办？
该报错表示后台尚未完成录制配置，请按以下步骤排查：
1. 确认已在控制台完成 VOD、COS 或 AWS S3 存储配置，且存储信息填写正确。
2. 确认高级功能配置页的云端录制功能已启用。
3. 完成配置后重新进入房间再试。若仍报错，请联系技术支持并提供 SDKAppID。
录制结束后找不到录制文件怎么办？
请按以下步骤排查：
1. 确认录制期间是否有音视频上行：若参会者均未打开摄像头、麦克风或屏幕分享，录制文件仍会生成，但没有画面和声音。
2. 确认存储配置正确：检查控制台中配置的 VOD 应用 AppID、账号 UIN，或 COS、AWS S3 的 Bucket、Region、AccessKey 和 SecretKey 是否填写正确。
3. 确认查看的是目标方案产生的文件：若同时开启了多种录制方式，存储中会存在多份录制文件。
能否用 TRTC 服务端 API 查询或控制视频会议 SDK 的录制任务？
不能。视频会议 SDK 录制任务由 SDK 后台统一托管，不暴露 TRTC TaskId，无法通过
CreateCloudRecording、DescribeCloudRecording 等 TRTC 服务端 API 查询或控制。如需通过服务端 API 自主控制录制，请参见 TRTC 云端录制 自行接入。两者同时使用会产出多份录制文件，并产生额外费用。文档反馈