关于云端录制
最近更新时间：2024.04.19 16:08:08
首次发布时间：2021.06.30 14:44:10
功能简介
在教育、互娱、医疗、金融等领域中，你可能需要对某个音视频房间内的音频、视频进行录音或录像，你可以使用云端录制功能，将生成的文件存储在火山引擎视频点播、火山引擎对象存储TOS 或支持 S3 协议的第三方存储平台。
适用场景
你可能在多种行业的多种场景下使用到云端录制功能：
| 行业 | 场景 |
|---|---|
| 在线教育 | 一对一、小班课、大班课等场景下，录制课程回看、课堂精彩片段。 |
| 社交直播 | 直播回放、内容审核。 |
| 客服中心 | 录制服务记录，用于客服质量评估、后期用户调研。 |
| 金融行业 | 办理视频面签，远程见证等业务时，存档备查。 |
| 远程医疗 | 进行远程问诊、在线咨询时，录制咨询过程，方便复诊参考。 |
更新历史
更新历史，参看服务端 OpenAPI 发版说明。
计费说明
计费说明，参看计费规则。
实现云端录制
在使用云端录制功能前，你必须在RTC 控制台开启云端录制功能。
调用时序
具体步骤参看以下时序图：
- 在控制台开启云端录制功能。
- 【可选】开通消息通知服务获取录制相关任务状态的消息通知。
- 【可选】在控制台上添加自动录制。
- 调用StartRecord开始云端录制任务。
- 调用UpdateRecord更新此前设定的云端录制配置参数。
- 【可选】调用
[GetRecordTask](1188213)查询合流转推任务状态 ，会收到任务开始时间、任务状态等返回信息。 - 调用StopRecord结束云端录制任务。
功能说明
录制模式
- 单流录制：
- 针对房间内每个单独用户的音视频内容进行录制，即每个用户生成一个独立的音视频录制文件。录制过程中，可能会出现分辨率的变化，如进行屏幕共享，最后输出文件分辨率为录制过程中最大分辨率。小分辨率视频会按原始画面的高宽比缩放视频，在显示区域居中显示，空缺区域填充背景色。
- 录制文件的视频属性沿用房间内的视频发布参数。
- 合流录制
- 针对房间内所有或者指定用户的音视频内容进行混合录制，生成一个音视频录制文件。
- 你可以设置录制文件的视频属性，包括分辨率和帧率等，还可以设置合流布局，及屏幕（画布）的背景颜色。
录制事件通知
你可以开通消息通知服务，获得录制开始、结束和录制上传状态的通知。要开通此服务，参看开通消息通知服务。
在你开启了通知服务，并在RTC 控制台添加了录制开始与结束 和 录制上传状态事件，配置了回调地址，在录制开始、结束和任务上传状态发生变化时，你会收到 RTC 推送的关于录制文件的消息。
你可以根据成功上传的回调来获取文件在火山引擎视频点播平台的 Vid 或在TOS/第三方存储平台的完整路径，关于回调的详细示例可参看RecordStopped。
存储位置
你可以将录制结果存储在多种存储平台中。目前支持的存储平台包括：
点播平台播放地址有生效时间限制，默认为 60 分钟，详情请参看时间戳防盗链
设置空闲超时
请结合你的实际业务需求合理设置空闲超时时间。在空闲超时范围内，即使录制异常中断，录制仍会持续进行，并产生计费。
录制时默认设置空闲超时为 180s，可以自定义配置。
录制切片规则
每当录制时长超过 4 小时左右时，便会创建一个新的录制文件。多个录制文件会按照序号进行排列。
若生成多个录制文件，且你已配置云端录制相关回调事件，你可以在 RecordStopped.RecordFileList 回调中查看所有录制文件的相关信息。
单流录制下，若视频流中断：
- 中断一小时内，录制服务会补充相应时长的黑帧存储到文件中。
- 中断一小时以上，录制服务不会补黑帧，会将中断前的内容生成录制文件。在视频流恢复后，会创建一个新的录制文件。
查找处理录制文件
若你选择在火山引擎视频点播平台存储文件，你可以按以下步骤进行查找、处理录制文件：
关于查找点播录制文件，可参看查找录制文件。
关于处理点播录制文件，可参看处理录制文件。
自动录制
在启动录制后，你可以选择添加自动录制功能，对房间内的用户进行自动录制。关于自动录制，详情参看自动录制
常见问题
Q：为什么自适应布局下，屏幕流录制效果不够清晰？
A：自适应布局下，服务端默认不会设置超高码率。如果订阅屏幕流，为保证清晰度，建议自行设置高码率。不同场景下设置码率等视频发布参数,请参考设置视频发布参数。
Q：单流录制下，用户重新进房后前几秒录制文件为黑帧。
A：单流录制下，若用户退房重进后前几秒只发音频流，服务端会补黑帧而不是上一帧。