云端录制
功能介绍
云端录制有两种模式:
| 模式 | 功能描述 |
|---|---|
| 单流模式 | 支持将房间内的部分或全部视频及音频直接转储成文件,各流独立生成音视频文件;服务器开销小; |
| 合流模式 | 支持将房间内视频、屏幕共享、影音共享、白板、音频等混合录制成一个文件;服务器开销较大; |
两种模式的一些特性对比:
| 对比项 | 单流模式 | 合流模式 |
|---|---|---|
| 开启方式 | createCloudMixer 参数 CloudMixerCfg 的 mode 配置为 1。 | createCloudMixer 参数 CloudMixerCfg 的 mode 配置为 0。 |
| 图像内容 | 房间内视频。 如果需要录制桌面,可以用桌面摄像头的方式。 请参见 CloudMixerCfg 中 videoFileCfg.subscribeVideos 的相关描述。 |
房间内视频、屏幕共享、影音共享、白板等。 在 CloudMixerCfg 中 videoFileCfg.layoutConfig 列表中添加布局项。 |
| 内容布局 | 不支持。 | 支持自由布局。 layoutConfig 列表中靠前的元素在图像底层;left、top、width、height 控制位置和大小。 |
| 添加水印 | 不支持。 只能在源端视频侧添加水印。 |
使用 MIXVTP_TEXT + mutiMixerContentParams.text: '%timestamp%' 等。 |
| 添加音频 | 可以在视频录像中添加自己或房间内所有人的声音。 参见 videoFileCfg.aStreamType。 |
可以添加房间内所有人/指定人员声音,也可左右声道。 参见 aChannelType、aChannelContent。 |
| 独立音频文件 | 参见 audioFileCfg。 | 参见 audioFileCfg。 |
| 任务数量 | 只需要启一个录制任务,就可为房间内全部视频或指定视频列表各生成一个录像文件。 | 可以开启多个合流任务,每个合流任务生成一个录像文件。 |
| 录像质量 | 不支持。 只能通过调整源端发出图像质量来控制录像质量。 |
可以控制录像分辨率、帧率、码率等参数(vWidth、vHeight、vFps、vBps、vQP)。 |
| 更新内容 | 录制中可以调整录制的视频列表。 | 录制中可以修改图像内容、水印等,可以调整内容布局。 |
| 服务器开销 | 视频不重新编解码,CPU、内存开销小。 | 录制内容将解码混图再编码,CPU 开销大。 |
| 第三方存储 | 默认存储在 SDK 服务器上;可通过 storageConfig 存到第三方。 | 同左。 |
使用说明
本文主要以 SDK 端发起云端录制为例。应用服务器侧可参考 WEB API(开启/停止/更新云端录制、状态回调、文件查询等)。
1.开通云端录制服务
- 请确保您已成功 注册 账号。
- 请联系商务为对应账号开通“云端录制服务”。
结束云端录制请调用 destroyCloudMixer(mixerID),并等待输出状态到上传成功后再退房间,避免断线导致文件未上传。
2. 开始云端录制
合流模式:自己摄像头 + 左上角时间戳示例。
import {
CrSDK,
CR_CLOUDMIXER_MODE,
CR_MIXER_VCONTENT_TYPE,
CR_KEEP_ASPECT_RATIO,
type CrCloudMixerCfg,
type CrMutiMixerContent,
} from '@cr/react-native-rtc';
const myUserId = 'userA';
const layoutConfig: CrMutiMixerContent[] = [
{
type: CR_MIXER_VCONTENT_TYPE.MIXVTP_VIDEO,
left: 0,
top: 0,
width: 360,
height: 640,
keepAspectRatio: CR_KEEP_ASPECT_RATIO.KEEP,
mutiMixerContentParams: { camid: `${myUserId}.-1` },
},
{
type: CR_MIXER_VCONTENT_TYPE.MIXVTP_TEXT,
left: 0,
top: 0,
width: 175,
height: 32,
keepAspectRatio: CR_KEEP_ASPECT_RATIO.KEEP,
mutiMixerContentParams: { text: '%timestamp%' },
},
];
// 合流
const cloudMixerCfg: CrCloudMixerCfg = {
mode: CR_CLOUDMIXER_MODE.CONFLUENCE,
videoFileCfg: {
svrPathName: '2026-07-09/demo.mp4',
vWidth: 360,
vHeight: 640,
vFps: 15,
layoutConfig,
},
};
// 单流示例(按需改用):
// const singleCfg: CrCloudMixerCfg = {
// mode: CR_CLOUDMIXER_MODE.SINGLE,
// audioFileCfg: {
// svrPath: 'xxx/',
// svrFileNameSuffix: '.mp3',
// subscribeAudios: ['_cr_all_'],
// },
// videoFileCfg: {
// svrPath: 'xxx/',
// svrFileNameSuffix: '.mp4',
// subscribeVideos: ['_cr_all_'],
// aStreamType: 1,
// },
// };
const mixerId = await CrSDK.instance.createCloudMixer(cloudMixerCfg);
3. 云端录制事件通知
import { CrSDKNotifier, NOTIFIER_EVENT } from '@cr/react-native-rtc';
class CloudRecordListener extends CrSDKNotifier {
createCloudMixerFailed(mixerID: string, sdkErr: number) {
// 启动失败
}
cloudMixerStateChanged(state: {
mixerID: string;
operatorID: string;
state: number;
exParam: string;
}) {
// 状态变化
}
cloudMixerInfoChanged(mixerID: string) {
// 配置变化
}
cloudMixerOutputInfoChanged(info: { mixerID: string; jsonStr: string }) {
// 输出/上传进度等(jsonStr 为输出信息 JSON)
}
}
const listener = new CloudRecordListener();
listener.addCrNotifierListener([
NOTIFIER_EVENT.createCloudMixerFailed,
NOTIFIER_EVENT.cloudMixerStateChanged,
NOTIFIER_EVENT.cloudMixerInfoChanged,
NOTIFIER_EVENT.cloudMixerOutputInfoChanged,
]);
相关 API 请参考:
4. 更新云端录制内容
const sdkErr = await CrSDK.instance.updateCloudMixerContent(mixerId, {
mode: CR_CLOUDMIXER_MODE.CONFLUENCE,
videoFileCfg: { layoutConfig },
});
相关 API 请参考:
5. 获取云端录制状态
// 返回 JSON 字符串,字段含义见 CloudMixerInfo
const infoJson = await CrSDK.instance.getCloudMixerInfo(mixerId);
相关 API 请参考:
相关结构定义请参考:
6.停止云端录制
停止云端录制会触发 onCloudMixerStateChanged。
await CrSDK.instance.destroyCloudMixer(mixerId);
相关 API 请参考: