你可以将音视频通话或直播过程录制为单个或多个文件，并存储至指定的云存储平台，用于后续回放、存档、二次处理或分析。本文主要介绍如何快速使用云端录制及相关配置（如合流录制、单流录制、录制文件格式、录制文件存储等）。支持以下两种录制模式： * **合流录制**：将多路音视频流混合成一路，生成一个音视频文件。您可以自定义最终合成视频的布局、分辨率、码率等参数。 * **单流录制**：将订阅的每一路音视频流都单独录制成一个文件，不进行混合。录制文件的分辨率与原始流保持一致。 ## 适用场景 |**行业** |**场景** | |---|---| |在线教育 |录制在线课程的完整过程，方便学生课后点播回顾。 | |视频会议 |记录重要会议内容，自动生成会议纪要或作为凭证存档。 | |金融行业 |办理视频面签，远程见证等业务时，存档备查。 | ## 计费说明云端录制为收费功能，计费说明参见[云端录制计费](/docs/6348/1392577)。 ## 快速使用 ### 时序图 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d32dfa88e51e90670be66a118ed22dba.jpg =364x) ### 步骤 1：在控制台开启云端录制 1. 前往 [RTC 控制台-功能配置](https://console.volcengine.com/rtc/cloudRTC?from=doc)。 2. 在下拉框中选择你需要目标 RTC 应用，并在**云端录制**页签，**启用录制**。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/a812662529de475e84efb39581139103 =555x) ### 步骤 2（建议）：接收录制通知录制任务是异步的，建议开通[消息通知服务](https://www.volcengine.com/docs/6348/75110)，以便实时接收任务启动、停止、文件生成等事件。 ### 步骤 3：发起录制任务调用 `StartRecord` 发起单流或合流录制任务。 ```mixin-react return ( #### **核心参数** * \`RecordMode\`：保持为默认值 \`0\`。 * \`Layout\`：配置视频布局（自适应、垂直、并排或自定义）。详见[合流布局](/docs/6348/69818#f95e0045)。 * \`Encode\`：配置音视频编码参数，如分辨率、帧率和码率。 * \`StorageConfig\`：**必填**。配置录制文件的存储位置，如火山引擎 VOD、TOS 或第三方存储。 #### **请求示例** 以将 \`Room1\` 房间内的所有流存储至 TOS 为例。 \`\`\`JSON { "AppId": "Your_AppId", "RoomId": "Your_RoomId", "TaskId": "mixed_record_001", "RecordMode": 0, "Layout": {}, // 默认自适应布局 "Encode": { "VideoWidth": 1280, "VideoHeight": 720, "VideoFps": 15, "VideoBitrate": 0 // 0 为自适应码率 }, "FileFormatConfig": { "FileFormat": ["MP4"] }, "StorageConfig": { "Type": 0, // 0 代表火山引擎 TOS "TosConfig": { "AccountId": "Your_AccountId", "Bucket": "your-tos-bucket-name" } } } \`\`\` `}> #### **核心参数** * \`RecordMode\`：必须设置为 \`1\`。 * \`TargetStreams\`：可选。不传默认录制房间内所有流。 * \`StorageConfig\`：**必填项**。配置录制文件的存储位置。 #### **请求示例** 以录制 \`Room1\` 房间内 \`user_A\` 和 \`user_B\` 两路流，并将录制文件以 \`MP4\` 格式存储 VOD 为例。 \`\`\`JSON { "AppId": "Your_AppId", "RoomId": "Your_RoomId", "TaskId": "single_record_002", "RecordMode": 1, // 表示单流录制 "TargetStreams": { "StreamList": [ { "UserId": "user_A", "StreamType": 0 }, { "UserId": "user_B", "StreamType": 0 } ] }, "FileFormatConfig": { "FileFormat": ["MP4"] }, "StorageConfig": { "Type": 1, // 1 代表火山引擎 VOD "VodConfig": { "AccountId": "Your_AccountId", "Space": "your-vod-space-name" } } } \`\`\` `}>); ``` ### 步骤 4：更新、查询或停止录制任务 * 调用 [UpdateRecord](https://www.volcengine.com/docs/6348/1188214) 更新此前设定的云端录制配置参数。 * 当需要结束录制时，调用 [StopRecord](https://www.volcengine.com/docs/6348/1188200) 停止一个正在进行的录制任务。 * 调用 [GetRecordTask](https://www.volcengine.com/docs/6348/1188213) 查询合流转推任务状态，会收到任务开始时间、任务状态等返回信息。 ## 进阶使用 ### 自动录制你可以在控制台为指定 RTC 应用开启自动录制功能。开启后，当满足条件的用户进入房间并开始发送音视频流时，系统将自动为该用户启动一个单流录制任务。 :::warning * 自动录制目前仅支持对视频流（摄像头）进行录制，不支持屏幕流。如果用户仅发布屏幕流，不会触发自动录制。 * 房间解散或用户停止发送音视频，并超过最大空闲超时时间后，任务会自动结束。 ::: 1. 前往 [RTC 控制台-功能配置](https://console.volcengine.com/rtc/cloudRTC?from=doc)。 2. 在下拉框中选择目标 RTC 应用，并在**云端录制**页签，点击**添加自动录制**。 3. 配置录制规则： * **业务标识**：你可以为不同的业务场景设置不同的业务标识（`BusinessId`）。 * 若设置了业务标识，则只有通过 `StartRecord` API 传入相同 `BusinessId` 的用户才会触发自动录制。 * 若不设置业务标识，则默认对房间内所有发送音视频的用户进行单流录制。 * **存储位置**：录制文件可以存储到[视频点播（VOD）](https://console.volcengine.com/home)或[对象存储（TOS）](https://www.volcengine.com/product/tos)。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/784beb8a981e4afaaf811336cf80f18f =1650x) ### 合流布局合流录制提供三种预设布局模式。若预设布局不满足需求，可通过字段 `CustomLayout` 设置坐标自定义布局。 #### 自适应布局根据人数自动排布。若人数未满或仅有音频流，相应位置显示背景色。视频会自动裁剪以填满视窗。 * 2人： ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/60622290cbc24fa4b2c278a5a4db6c52~tplv-em5hxbkur4-noop.image?width=879&height=302 =879x) * 4人： ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/63cada588f894da89341a5c2d07c8b14~tplv-em5hxbkur4-noop.image?width=881&height=300 =881x) * 5~9 10~16人： ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/07f8666aad8c4c2cb5cb98f02148070b~tplv-em5hxbkur4-noop.image?width=884&height=295 =884x) * 17人： ![图片](https://lf3-volc-editor.volccdn.com/obj/volcfe/sop-public/upload_862770c510e68bcce9aafd815c07d0f4.png =600x) 自适应布局会遵循以下规则： * 具体布局会根据人数进行选择，遵循以上示意图。人数未达到布局适用的最多人数时，空缺窗口会显示背景色。 * 只发送音频的用户仍然会在整体布局上占据窗口，窗口会显示背景色。 * 如果实际视频流的宽高比与视窗的宽高比不一致，会自动对视频进行裁剪以适配窗口的大小。 #### 垂直布局 1 个大视窗（可指定用户）+ 侧边小视窗（按加入顺序排列）。大视窗可指定 UserID，否则随机展示。 ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/a0ccd66e1ff74c19b09dfdcd95f6d334~tplv-em5hxbkur4-noop.image?width=889&height=303 =889x) ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/d5c0ca1ad205472192d6dbae448c689f~tplv-em5hxbkur4-noop.image?width=895&height=307 =895x) 垂直布局会遵循以下规则： * 对于大窗口： * 如果未指定用户，大窗口会随机显示一个用户；如果指定用户未进入频道或进入频道未发布流，大窗口会显示背景色。 * 如果实际视频流的宽高比与窗口的宽高比不一致，窗口会按照显示区域的长宽比裁减视频，并等比拉伸或缩小视频，以占满显示区域。 * 对于小窗口： * 小视窗根据加入的顺序进行排列。如果某个用户退出频道，紧跟的后序用户会占据前序用户的窗口，并依次替补。 * 如果实际视频流的宽高比与视窗的宽高比不一致，视频会裁剪以适配视窗的大小。 * 人数未达到布局适用的最多人数时，空缺窗口会显示背景色。 * 只发送音频的用户仍然会在整体布局上占据窗口，窗口会显示背景色。 #### 并排布局各路画面等分平铺。 ![图片](https://p-vcloud.byteimg.com/tos-cn-i-em5hxbkur4/bd63e10de9c0412eab0e659cc894b42f~tplv-em5hxbkur4-noop.image?width=1256&height=276 =1256x) ### 录制文件名通过配置 `FileNameConfig`，您可以定义录制文件的存储路径（前缀）和文件名（`Pattern` **）** ，以便于归档和检索。文件名总长度不得超过 128 个字符。文件名中可以使用 `{}` 占位符来插入动态变量，例如 `{RoomId}`、`{UserId}` 等。 :::tip 自定义文件名格式中不包含文件扩展名（如 `.mp4`）。文件格式由 `FileFormatConfig` 参数控制。 ::: #### 单流录制 * **Pattern 默认格式**：`{TaskId}_{RoomId}_{UserId}_{Type}_{StartTime}_{Duration}_{Random}` * **可用变量**： |变量 |描述 | |---|---| |`TaskId` |云端录制任务 ID。 | |`RoomId` |房间 ID。 | |`UserId` |用户 ID。 | |`Type` |流类型，`C` 表示摄像头流，`S` 表示屏幕流。 | |`StartTime` |文件开始录制的 UTC 时间戳（毫秒）。 | |`Duration` |录制文件时长（秒），固定为 6 位字符，不足则补 0。 | #### 合流录制 * **Pattern 默认格式**：`{TaskId}_{RoomId}_{StartTime}_{Duration}_{Random}` * **可用变量**： |变量 |描述 | |---|---| |`TaskId` |云端录制任务 ID。 | |`RoomId` |房间 ID。 | |`StartTime` |文件开始录制的 UTC 时间戳（毫秒）。 | |`Duration` |录制文件时长（秒），固定为 6 位字符，不足则补 0。 | #### 自动录制自动录制为单流录制，其文件名格式固定为默认格式：`{TaskId}_{RoomId}_{UserId}_{Type}_{StartTime}_{Duration}_{Random}`。 :::warning 在自动录制模式下，`TaskId` 的值与 `UserId` 相同。 ::: ### 边录边传（HLS）若希望在录制进行中就能开始观看回放的场景，降低长视频录制的等待时间。可通过设置 `Control.EnableSyncUpload` 为 `true`，开启边录制边上传。 :::warning 此功能仅对 `HLS` 格式的录制文件生效。 ::: ### 查找或处理录制文件若你选择在火山引擎视频点播平台存储文件，你可以查找或处理录制文件： * [查找录制文件](https://www.volcengine.com/docs/4/181541#%E6%9F%A5%E6%89%BE%E5%BD%95%E5%88%B6%E6%96%87%E4%BB%B6) * [处理录制文件](https://www.volcengine.com/docs/4/181541#%E5%A4%84%E7%90%86%E5%BD%95%E5%88%B6%E6%96%87%E4%BB%B6) ### 录制文件切片 * **时长切片**：每当录制时长达到约 4 小时，系统会自动创建一个新的录制文件（切片）。多个文件按序号排列。若已配置云端录制回调，所有录制文件的信息可通过 `RecordStopped.RecordFileList` 回调获取。 * **断流切片**（仅单流录制）：当某路流中断时： * 中断时间小于 `MaxSilenceSeconds`（默认为 3600 秒），录制服务会补充相应时长的黑帧或最后一帧到当前文件中。 * 中断时间超过 `MaxSilenceSeconds`，录制服务会先结束当前文件，待视频流恢复后，再创建一个新的录制文件。 ### 任务控制参数在 `StartRecord` 请求中，你可以通过以下参数对录制任务进行更精细的控制： * `MaxIdleTime`：任务空闲超时时间（秒）。若任务启动后，在设定的时间内未订阅到任何目标流，任务将自动结束。默认为 `180` 秒。 * `MaxRecordTime`：最大录制时长（秒）。超过该时长任务将自动停止。默认为 `0`，表示不限制。 * `MaxSilenceSeconds`：（仅单流生效)）任务中断容忍时间（秒）。当流中断时，如果中断时间小于此值，系统会补帧；若大于此值，则可能生成新文件。 * `FrameInterpolationMode`：补帧模式。当视频流中断时，选择补充最后一帧 (`0`) 还是黑帧 (`1`)。 ## 常见问题 * **为什么自适应布局下，屏幕流录制效果不够清晰？** 自适应布局下，服务端默认不会设置超高码率。如果订阅屏幕流，为保证清晰度，建议自行设置高码率。不同场景下设置码率等视频发布参数，请参考[设置视频发布参数](/docs/6348/70122#videoprofiles)。 * **单流录制下，用户重新进房后前几秒录制文件为黑帧。** 单流录制下，用户重进房间后，若前几秒只发送音频流而未发送视频流，服务端会默认补充黑帧。

实时音视频