音视频通话

本地录制

功能介绍

用户可以对通讯过程进行录制并保存到终端设备。

  • 录制画面可以根据业务场景自由拼接组合,包括本地摄像头、远端摄像头、远端共享的屏幕、影音播放、图片。支持同时启动多个录制。
  • 录制格式支持 mp4、ts、flv,如果选择了 flv 和 ts 两种格式,即使录制过程中程序出现异常了,崩溃之前的录像仍然可用。
  • 对于金融双录等安全性要求高的特定领域,支持对录制的文件进行加密,录制后直接把录像传到标准 http 服务器、OSS 或者 SDK 服务器。
  • 本地加密过的录像只能通过 SDK 提供的播放器播放。

本地时间戳水印请使用 MIXVTP_TEXT + text: '%timestamp%',并将水印放在混流内容列表末尾(最上层)。iOS 上不要使用 MIXVTP_TIMESTAMP(4)(会按图片资源处理,未注册时易花屏)。背景建议全透明 #00000000,避免半透明黑底在低码率下出现边缘噪点。

1. 创建混图器

如下代码为创建自己摄像头,并在左上角叠加时间戳水印的示例。

import {
  CrSDK,
  CR_MIXER_VCONTENT_TYPE,
  type CrMixerCfg,
  type CrMixerCotentRect,
} from '@cr/react-native-rtc';

const mixerId = '1';
const myUserId = 'userA';

const cfg: CrMixerCfg = {
  width: 360,
  height: 640,
  frameRate: 15,
  bitRate: 500000,
  defaultQP: 26,
  gop: 15,
};

const contents: CrMixerCotentRect[] = [
  // 混视频(主画面)
  {
    userId: myUserId,
    camId: -1,
    type: CR_MIXER_VCONTENT_TYPE.MIXVTP_VIDEO,
    left: 0,
    top: 0,
    width: cfg.width,
    height: cfg.height,
  },
  // 远端小窗等其它视频层可插在中间……
  // 时间戳水印放在最后,保证绘制在最上层
  {
    type: CR_MIXER_VCONTENT_TYPE.MIXVTP_TEXT,
    text: '%timestamp%',
    color: '#FFFFFF',
    backgroundColor: '#00000000',
    fontSize: '14',
    textMargin: '5',
    left: 0,
    top: 0,
    width: 175,
    height: 32,
  },
];

const sdkErr = await CrSDK.instance.createLocMixer(mixerId, cfg, contents);
if (sdkErr === 0) {
  // 创建混图器成功
} else {
  // 创建混图器失败
}

相关 API 请参考:

相关结构定义请参考:

2. 添加输出到录像文件

请使用 getMoviesStorageDirectory() 获取平台可用的录像目录,不要硬编码 /sdcard/ 等路径。

import { CR_MIXER_OUTPUT_TYPE } from '@cr/react-native-rtc';

const dir = await CrSDK.instance.getMoviesStorageDirectory();
// 目录末尾通常已带分隔符;若没有请自行拼接
const fileName = `${dir}2026-07-09_10-46-38_RN_iOS_64190664.mp4`;

const sdkErr = await CrSDK.instance.addLocMixerOutput(mixerId, [
  {
    type: CR_MIXER_OUTPUT_TYPE.MIXOT_FILE,
    fileName,
  },
]);
if (sdkErr === 0) {
  // 添加输出成功
} else {
  // 添加输出失败
}

相关 API 请参考:

相关结构定义请参考:

3. 录像回调处理

通过 CrSDKNotifier 订阅混图器输出与状态事件,可获得录像文件时长、大小、异常等信息。

import {
  CrSDKNotifier,
  NOTIFIER_EVENT,
  CR_MIXER_OUTPUT_STATE,
  type CrMixerOutputInfo,
} from '@cr/react-native-rtc';

class RecordListener extends CrSDKNotifier {
  locMixerOutputInfo(info: CrMixerOutputInfo) {
    if (info.state === CR_MIXER_OUTPUT_STATE.OUTPUT_ERR) {
      // 录制出错
      return;
    }
    if (info.state === CR_MIXER_OUTPUT_STATE.OUTPUT_CLOSED) {
      // 录制结束,可读取 info.fileSize 等
      return;
    }
  }

  locMixerStateChanged(state: { mixerID: string; state: number }) {
    // 混图器状态变化
  }
}

const listener = new RecordListener();
listener.addCrNotifierListener([
  NOTIFIER_EVENT.locMixerOutputInfo,
  NOTIFIER_EVENT.locMixerStateChanged,
]);

相关 API 请参考:

4. 更新图像内容

远端进出房或布局变化时,可更新混图内容(时间戳水印仍建议放在列表末尾)。

const sdkErr = await CrSDK.instance.updateLocMixerContent(mixerId, contents);
if (sdkErr === 0) {
  // 更新成功
} else {
  // 更新失败
}

相关 API 请参考:

5. 结束录制

销毁混图器后,输出会自动结束。

const sdkErr = await CrSDK.instance.destroyLocMixer(mixerId);
if (sdkErr === 0) {
  // 销毁成功
} else {
  // 销毁失败
}

相关 API 请参考: