音视频录制
简介
在进行视频通话、直播、在线教学时，用户经常需要将视频录制保存下来，方便后续其他用户点播观看。ZEGO 提供了多种录制方案，满足不同场景下的录制需求。
| 录制方案 | 简介 | 适用场景 |
|---|---|---|
通过客户端 SDK 录制您（本地用户）的音视频，并保存到本地。 | 需要录制您（本地用户）的音视频，并保存到本地设备（手机、电脑等终端设备）中。不支持录制其他用户的音视频。 调用方式：通过调用客户端 SDK 接口开始录制。 | |
通过 ZEGO 云服务进行录制，并将音视频保存到您开通的云存储中。 |
调用方式：通过调用 ZEGO 服务端 API 接口开始录制。 | |
录制直播的音视频，并保存到 ZEGO CDN 上。 |
调用方式：您在 ZEGO 控制台 开通了 CDN 录制后，默认是全局录制，无需调用服务端 API 接口；如果您需要选择性录制，请调用 ZEGO 服务端 API 接口开始录制。 |
方案一：客户端本地录制
本文档暂不适用于 Web 平台。
本地媒体录制组件提供媒体本地录制的能力，把直播过程中的音视频数据录制存储到本地文件。
应用场景
- 纯本地录制：不推流情况下，本地预览进行录制。
- 边直播边录制：在推流的同时进行录制，把直播的全程录制保存到本地文件。
- 直播过程中录制短视频：直播过程中，可以随时录制一小段视频进行保存到本地。
支持格式
- 音视频：FLV、MP4
- 纯音频：AAC
示例源码下载
请参考 下载示例源码 获取源码。
相关源码请查看 “lib\topics\OtherFunctions\recording” 目录下的文件。
前提条件
在实现媒体播放器功能之前，请确保：
- 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
- 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
使用步骤
录制功能接口调用流程如下图所示：
设置录制回调
开发者需要设置 onCapturedDataRecordStateUpdate 和 onCapturedDataRecordProgressUpdate 回调以接收录制过程中的录制信息。
在调用 startRecordingCapturedData 开始录制之后才会收到所设置的录制回调信息。
// 设置录制回调
ZegoExpressEngine.onCapturedDataRecordStateUpdate = (ZegoDataRecordState state, int errorCode, ZegoDataRecordConfig config, ZegoPublishChannel channel){
// 开发者可以在这里根据错误码或者录制状态处理录制过程状态变更的逻辑，例如在界面上进行 UI 的提示等
...
};
ZegoExpressEngine.onCapturedDataRecordProgressUpdate = (ZegoDataRecordProgress progress, ZegoDataRecordConfig config, ZegoPublishChannel channel){
// 开发者可以在这里根据录制进度处理录制过程进度变更的逻辑，例如在界面上进行 UI 的提示等
...
};开始录制
开发者需要调用 startRecordingCapturedData 以开始录制。
-
ZegoPublishChannel 指定录制的媒体通道，若只推一条流或只做本地预览预览应使用 ZegoPublishChannel.Main。
-
ZegoDataRecordConfig 指定录制的配置，可以指定录制的路径以及录制的类型 ZegoDataRecordType。
若希望录制音视频则应指定为 ZegoDataRecordType.Default 或 ZegoDataRecordType.AudioAndVideo，若希望只录制音频则选择 ZegoDataRecordType.OnlyAudio，若只录制纯视频则选择 ZegoDataRecordType.OnlyVideo。
- 在 ZegoDataRecordConfig 指定录制的配置中，文件路径的后缀名必须是 “.mp4”、“.flv” 或 “.aac” 结尾以指定录制文件的格式。
- 录制的类型 ZegoDataRecordType 与文件的后缀名无关。
// 登录房间、开始推流、启动预览等接口调用
...
// 创建录制配置
// 例如需要录制 mp4 格式
var filePath = "path.mp4";
// 例如使用默认的方式录制
var recordType = ZegoDataRecordType.Default;
var config = ZegoDataRecordConfig(filePath, recordType);
// 开始录制，使用主通道录制
ZegoExpressEngine.instance.startRecordingCapturedData(config, channel: ZegoPublishChannel.Main);停止录制
开发者需要调用 stopRecordingCapturedData 来结束录制。
在录制过程中，若退出房间 logoutRoom，SDK 内部会主动停止录制。
ZegoExpressEngine.instance.stopRecordingCapturedData(channel: ZegoPublishChannel.Main);播放录制文件
录制文件的播放，可选两种方式进行播放。
-
调用系统默认的播放器进行播放。
-
调用 ZegoExpressEngine 中的 ZegoMediaPlayer 组件进行播放，详情可参考 媒体播放器。
常见问题
- 本地音视频录制支持什么格式的打包文件？
目前音视频已支持 FLV 和 MP4，纯音频已支持 AAC，通过文件路径的后缀名指定格式。其中 FLV 格式只支持 H.264 编码，MP4 格式支持 H.264 和 H.265 编码，不满足会导致没有画面或者没有音频。
- 存储的路径有什么要求？
存储的路径为应用有权限读写的文件路径即可，如果传入目录路径，则会在回调中返回写文件失败。
- 录制过程如何获取到录制文件的大小？
录制进度回调 onCapturedDataRecordProgressUpdate 中可以获取得到录制时长和录制文件大小。
- 传递一个已存在文件的文件路径，SDK 如何处理？
不会出错，但原文件内容将被清空后再写入。
- 使用外部采集时的录制需要注意什么？
使用外部采集时，也需要在录制之前调用 SDK 的 startPreview 方法来启动。
- 为什么录制出来的视频会有绿边？
使用者需要注意在开启录制的过程中不要修改视频编码分辨率，开启流量控制（开启时会依据网络环境动态调整编码分辨率）。
- 为什么录制过程中结束推流，录制出的视频会在这时有一瞬间的卡顿？
SDK 内部处理方式的问题，目前暂时无法解决，需要用户尽量避免出现这种操作的情况。
- 本地媒体录制支持录 “ZegoMediaPlayer/ZegoAudioPlayer/混音功能” 的声音吗？
可以录制以上输入源的声音，但是只有混入推流中的声音才会被录制，如果仅本地播放，则不会被录制进文件。
方案二：云端录制
云端录制，即通过调用 ZEGO 服务端 API 录制音视频，并保存到您指定的 CDN 上，支持录制视频通话或者直播中任意一个用户的音视频流，并且提供各种容灾、安全机制。
适用场景
适用于各种需要录制功能的场景，包括但不限于音视频通话、直播、在线课堂、在线会议等。
使用步骤
请参考 云端录制。
方案三：CDN 录制
CDN 录制，是指将正在通过 CDN 直播的内容保存到相应 CDN 上。需要将音视频推到 CDN 进行直播后，才能使用该方式进行录制。
适用场景
开发者需要将音视频推到 CDN 进行直播后，才能使用该方式进行录制。如果开发者只是进行视频通话或者连麦，并未将音视频推到 CDN，则无法使用此功能。
您在 ZEGO 控制台 开通了 CDN 录制后，默认是全局录制，无需调用服务端 API 接口；如果您需要选择性录制，请调用 ZEGO 服务端 API 接口开始录制。
使用步骤
请参考 开始 CDN 录制。