音视频通话

云端直播推流

功能介绍

用于多个主播实时连麦互动。技术实现上,我们会把房间里多个主播的音视频在服务器合成一路流后推流到CDN流媒体服务器,直播观众可以获取RTMP或HLS流观看直播。

互动直播架构图:

1.创建直播间并获得推流地址

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回放点播。