云端录制
功能介绍
云端录制支持两种模式:
- 单流模式:可以为房间内指定人员或全部人员的摄像头和声音生成独立的录像文件;
- 合流模式:可以将房间内摄像头、屏幕共享、影音共享、白板、声音等内容混合录制成一个录像文件;(录制内容和布局支持自定义)
一个房间可以开启一个单流录制和多个合流录制, 录制文件存储支持:
- 存储到SDK服务器:可以通过WEB API下载和管理
- 存储到第三方网盘:可通过第三方网盘接口下载和管理;
1.开通云端录制服务
- 请确保您已成功注册了一个帐号。
- 请联系商务为对应帐号开通“云端录制服务”。
2.开始云端录制
- 录制左右布局示例图:

- 调用接口:
import { CRCloudMixerCfgObj } from '@cloudroom/harmony_rtcsdk';
//配置混图器编码参数:1280*720, 15帧
const cloudMixerCfg: CRCloudMixerCfgObj = {
mode: 0,
videoFileCfg: {
svrPathName: "/2024-09-14/2024-09-14_13-47-41_HarmonyOS_73542046.mp4",
vWidth: 1280,
vHeight: 720,
vFps: 15,
layoutConfig: [{
type: 0,
top: 180,
left: 0,
width: 640,
height: 360,
keepAspectRatio: 1,
param: {
camid: "userID1.-1"
}
}, {
type: 0,
top: 180,
left: 640,
width: 640,
height: 360,
keepAspectRatio: 1,
param: {
camid: "userID2.-1"
}
}]
}
}
const mixerID = sdk_engine.createCloudMixer(cloudMixerCfg);
如果录像需要保存到第三方云存储,请在createCloudMixer时,传storageConfig参数;
相关API请参考:
createCloudMixer
3.更新云端录制内容
- 更新成画中画布局示例图:

- 接口调用:
import { CRCloudMixerCfgObj } from '@cloudroom/harmony_rtcsdk';
//混图器内容:画中画布局(示例图如下, 底层1280*720, 上层400*225)
//底层为userID1的默认摄像头, 上层为userID2的默认摄像头
const cloudMixerCfg: CRCloudMixerCfgObj = {
mode: 0,
videoFileCfg: {
svrPathName: "/2024-09-14/2024-09-14_13-47-41_HarmonyOS_73542046.mp4",
vWidth: 1280,
vHeight: 720,
vFps: 15,
layoutConfig: [{
//大视频窗口
type: 0,
top: 0,
left: 0,
width: 1280,
height: 720,
keepAspectRatio: 1,
param: {
camid: "userID1.-1"
}
}, {
//小视频窗口
type: 0,
top: 495,
left: 880,
width: 400,
height: 225,
keepAspectRatio: 1,
param: {
camid: "userID2.-1"
}
}]
}
}
sdk_engine.updateCloudMixerContent(mixerID, cloudMixerCfg); //mixerID由createCloudMixer接口返回
相关API请参考:
updateCloudMixerContent
4.停止云端录制
停止云端录制后,也会触发事件notifyCloudMixerStateChanged
- 接口调用:
sdk_engine.destroyCloudMixer(mixerID);
相关API请参考:
destroyCloudMixer
5.云端录制回调通知
录制过程中都会录制状态变化事件、录制文件信息变化通知。在此可以实时获得录制状态、录制文件当前的时长、大小,以及录制异常等信息。
- 回调通知:
//云端录制状态变化通知
sdk_engine.on("notifyCloudMixerStateChanged", (mixerID, state, exParam, operUserID) => {
//状态处理
...
})
//云端录制输出内容变化通知
sdk_engine.on("notifyCloudMixerEvent", (mixerID, eventType, obj) => {
//状态处理, 文件时长、大小等处理
})
相关API请参考:
notifyCloudMixerStateChanged
notifyCloudMixerEvent
6.获取录像
录像停止后,录像文件会开始上传到录像文件存储服务器中(可关注notifyCloudMixerEvent通知,得到上传完成事件)。
可以通过WEB API进行录像文件查询、下载和删除等处理。
也可以登录管理后台,在管理页面上回放和下载录像:

如果将录像保存到第三方云存储上,请使用第三方提供的接口或管理页来获取。