音视频通话

本地直播推流

功能介绍

用于1个或多个主播连麦实时互动。技术实现上,SDK 会把房间里多个主播的音视频在本地合成一路流后推流到直播平台,直播观众就可以获取RTMP或HLS流观看直播了。

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

可以是SDK系统的直播平台,也可以是第三方的直播平台,以SDK系统的平台为例:

2.创建混图器

  • 左右布局示例图

左右布局示例图

  • 接口调用:

//混图器编号
string mixerID = "1";
//混图器尺寸为640*360,帧率为15,其他参数使用默认值
string mixerCfg = "{\"width\":640,\"height\":360,\"frameRate\":15}";
//混图器内容配置:混图对象来源为视频,保持图像原始比例
//left,top,width,height 在混图画面中的区域(相对于混图器尺寸)
//camid:视频设备编号
string mixerContents = "[\
{\"type\":0,\"keepAspectRatio\":1,\"left\":0,\"top\":0,\"width\":320,\"height\":180,\"param\":{\"camid\":\"usr1.-1\"}},\
{\"type\":0,\"keepAspectRatio\":1,\"left\":320,\"top\":0,\"width\":320,\"height\":180,\"param\":{\"camid\":\"usr2.-1\"}}\
]";

//创建混图器
CRVSDK_ERR_DEF err = g_sdkMain->getSDKMeeting().createLocMixer(mixerID, mixerCfg.c_str(), mixerContents.c_str());

相关API请参考:

3.开启直播推流

添加混图器输出后,会触发notifyLocMixerOutputInfo通知,如果输出异常,将自动停止推流。

  • 接口调用:
//混图器编号
string mixerID = "1";
//输出配置:内容推流到rtmp://xxx地址
string mixerOutput = "[{\"type\":1,\"liveUrl\":\"rtmp://xxx\"}]";
CRVSDK_ERR_DEF err = g_sdkMain->getSDKMeeting().addLocMixerOutput(mixerID, mixerOutput.c_str());
if ( err != CRVSDKERR_NOERR ) {
    //出错处理
    ...
}


相关API请参考:

4.直播推流事件处理

推流过程中都会触发此事件。在此可以实时获得推流的时长、数据大小等信息。

  • 回调通知:
//录制文件、直播信息通知
void LocalRecord::notifyLocMixerOutputInfo(const char* mixerID, const char* nameOrUrl, const char* outputInfo)
{
    ...
    //状态处理
}

相关API请参考:

5.更新图像内容

  • 画中画布局示例图

画中画布局示例图

  • 接口调用:
//混图器编号
string mixerID = "1";
//混图器内容:画中画布局(示例图如下, 底层640*360, 上层160*90),底层为user1的默认视频设备, 上层为user2的默认视频设备
string mixerContent = "[\
{\"type\":0,\"keepAspectRatio\":1,\"left\":0,\"top\":0,\"width\":640,\"height\":360,\"param\":{\"camid\":\"usr1.-1\"}},\
{\"type\":0,\"keepAspectRatio\":1,\"left\":475,\"top\":265,\"width\":160,\"height\":90,\"param\":{\"camid\":\"usr2.-1\"}}\
]";
//更新混图器内容
CRVSDK_ERR_DEF err = g_sdkMain->getSDKMeeting().updateLocMixerContent(mixerID, mixerContent.c_str());
if ( err != CRVSDKERR_NOERR ) {
    ...
}

相关API请参考:

6.结束

  • 接口调用:
//混图器编号
string mixerID = "1";
//销毁混图器, 各输出自动结束
g_sdkMain->getSDKMeeting().destroyLocMixer(mixerID);

相关API请参考: