云端直播推流
功能介绍
用于多个主播实时连麦互动。技术实现上,我们会把房间里多个主播的音视频在服务器合成一路流后推流到CDN流媒体服务器,直播观众可以获取RTMP或HLS流观看直播。
互动直播架构图:
1.创建直播间并获得推流地址
- 创建直播间请参见:Web API 创建直播。
- 获取直播推流地址请参见:Web API 获取推流地址。
2.开始云端直播推流
- 直播左右布局示例图:

- 调用接口:
import { CRCloudMixerCfgObj } from '@cloudroom/harmony_rtcsdk';
//配置混图器编码参数:1280*720, 15帧, 推流到两个地方
const cloudMixerCfg: CRCloudMixerCfgObj = {
mode: 0,
videoFileCfg: {
svrPathName: "rtmp://A/xxx", //带路径的文件名,文件格式支持:mp4、flv、ts、avi、rtmp://、rtsp://,可选一个或多个,以“;”分隔;示例:”/xxx/xxx.mp4;rtmp://xxx1;rtmp://xxx2;”
vWidth: 1280, //视频宽度
vHeight: 720, //视频高度
layoutConfig: [{
type: 0, // 录制视频
left: 0, // 在混图画面中的区域(水平位置)
top: 0, // 在混图画面中的区域(垂直位置)
width: 640, // 在混图画面中的区域宽
height: 720, // 在混图画面中的区域高
param: { camid: 'userID1.-1' } //请见后面param支持的参数;
}, {
type: 0, // 录制视频
left: 640, // 在混图画面中的区域(水平位置)
top: 0, // 在混图画面中的区域(垂直位置)
width: 640, // 在混图画面中的区域宽
height: 720, // 在混图画面中的区域高
param: { camid: 'userID2.-1' } //请见后面param支持的参数;
},] //布局内容列表
}
}
//启动云端直播推流
const mixerID = sdk_engine.createCloudMixer(cloudMixerCfg);
//开启云端直播出错, 关注回调createCloudMixerFailed
sdk_engine.on("createCloudMixerFailed", (mixerID) => {
})
//通知云端录制/推流状态变化
sdk_engine.on("notifyCloudMixerStateChanged", (mixerID, state, exParam, operUserID) => {
})
相关API请参考:
3.更新互动直播内容
- 更新成画中画布局示例图:

- 接口调用:
import { CRCloudMixerCfgObj, CRVSDK_ERR_DEF } from '@cloudroom/harmony_rtcsdk';
const cloudMixerCfg: CRCloudMixerCfgObj = {
mode: 0,
videoFileCfg: {
svrPathName: "rtmp://A/xxx", //带路径的文件名,文件格式支持:mp4、flv、ts、avi、rtmp://、rtsp://,可选一个或多个,以“;”分隔;示例:”/xxx/xxx.mp4;rtmp://xxx1;rtmp://xxx2;”
vWidth: 1280, //视频宽度
vHeight: 720, //视频高度
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"
}
}]
}
}
//更新云端直播推流画面
const sdkErr = sdk_engine.updateCloudMixerContent(mixerID, cloudMixerCfg); //mixerID由createCloudMixer接口返回
if (sdkErr === CRVSDK_ERR_DEF.CRVSDKERR_NOERR) {
//没有错误
}
相关API请参考:
相关结构定义请参考:
4.观众观看直播
通过 播放器SDK观看直播。
5.停止互动直播
停止云端直播推流后,会触发事件notifyCloudMixerStateChanged
- 接口调用:
sdk_engine.destroyCloudMixer(mixerID)
相关API请参考:
6.回放点播
通过 点播API回放点播。