音视频通话

云端录制

功能介绍

云端录制有两种模式:

模式 功能描述
单流模式 支持将房间内的部分或全部视频及音频直接转储成文件,各流独立生成音视频文件;服务器开销小;
合流模式 支持将房间内视频、屏幕共享、影音共享、白板、音频等混合录制成一个文件;服务器开销较大;

两种模式的一些特性对比:

对比项 单流模式 合流模式
开启方式 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 请参考: