音视频通话

本地录制

功能介绍

用户可以对通讯过程进行录制并保存到终端设备,有以下特性:

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

1. 创建混图器

  • 左右布局示例图

左右布局示例图

  • 接口调用:
import { CRLocMixerCfgObj, CRMixerContentObj, CRVSDK_ERR_DEF } from '@cloudroom/harmony_rtcsdk';

const mixerID = '1'; //混图器唯一标识
//混图器参数配置
const mixerCfgObj: CRLocMixerCfgObj = {
	width: 1280,
	height: 720,
	frameRate: 15,
	bitRate: 1000000,
	defaultQP: 26,
	gop: 15,
}

const mixerContentsObj: CRMixerContentObj[] = [{
	type: 0,
	top: 0,
	left: 0,
	width: 640,
	height: 720,
	param: {
		camid: "userID1.-1"
	}
}, {
	type: 0,
	top: 0,
	left: 640,
	width: 640,
	height: 720,
	param: {
		camid: "userID2.-1"
	}
}]

// 创建混图器, 设置混图器编号为1
const sdkErr = sdk_engine.createLocMixer(mixerID, mixerCfgObj, mixerContentsObj);
if (sdkErr === CRVSDK_ERR_DEF.CRVSDKERR_NOERR) {
	//创建成功
}

相关API请参考:

相关结构定义请参考:

2. 添加输出到录像文件

import { CRVSDK_MIXER_OUTPUT_TYPE, CRVSDK_ERR_DEF } from '@cloudroom/harmony_rtcsdk';

const dir = getContext().getApplicationContext().tempDir;
const fileName = `/${dir}/2024-09-14_13-47-41_HarmonyOS_73542046.mp4`;

const mixerOutput: CRLocMixerOutputObj[] = [{
	type: CRVSDK_MIXER_OUTPUT_TYPE.CRVSDK_MIXER_OUTPUT_FILE,
	filename: fileName
}]

const sdkErr = sdk_engine.addLocMixerOutput(mixerID, mixerOutput);

if (sdkErr === CRVSDK_ERR_DEF.CRVSDKERR_NOERR) {
    //启动成功
}

相关API请参考:

相关结构定义请参考:

3. 录像回调处理

在此可获得录像文件的时长、大小、录像文件异常等信息

import { CRVSDK_LOCMIXER_OUTPUT_STATE } from '@cloudroom/harmony_rtcsdk';

sdk_engine.on("notifyLocMixerOutputInfo", (mixerID, nameOrUrl, outputInfo) => {
	if (outputInfo.state === CRVSDK_LOCMIXER_OUTPUT_STATE.CRVSDK_LOCMO_FAIL) {
		//录像文件出错,errCode中有错误原因
	}
})

相关API请参考:

相关结构定义请参考:

4. 更新图像内容

  • 画中画布局示例图

画中画布局示例图

  • 接口调用:
import { CRMixerContentObj, CRVSDK_ERR_DEF } from '@cloudroom/harmony_rtcsdk';

// 录制参数列表中,越靠后的元素会覆盖之前的元素
const mixerContents: CRMixerContentObj[] = [{
	//大窗的视频
	type: 0,
	top: 0,
	left: 0,
	width: 1280,
	height: 720,
	param: {
		camid: "userID2.-1"
	}
}, {
	//小窗口视频
	type: 0,
	top: 1280 - 256,
	left: 720 - 144,
	width: 256,
	height: 144,
	param: {
		camid: "userID1.-1"
	}
}]

// 更新混图器
const sdkErr = sdk_engine.updateLocMixerContent(mixerID, mixerContents);
if (sdkErr !== CRVSDK_ERR_DEF.CRVSDKERR_NOERR) {
	//更新成功
}

相关API请参考:

5. 结束录制

//停止混图器输出,录制文件将自动保存
sdk_engine.rmLocMixerOutput(mixerID, fileName)
//销毁混图器
sdk_engine.destroyLocMixer(mixerID);

相关API请参考: