本地录制
功能介绍
用户可以对通讯过程进行录制并保存到终端设备。
- 录制画面可以根据业务场景自由拼接组合,包括本地摄像头、远端摄像头、远端共享的屏幕、影音播放、图片。支持同时启动多个录制。
- 录制格式支持 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 请参考: