音视频通话

本地直播推流

功能介绍

用于1个或多个主播实时连麦互动,然后图像和声音将在SDK本地进行混合,然后直接向CDN流媒体服务器推流,直播观众就可以获取RTMP或HLS流观看直播了。

1. 创建混图器

  • 左右布局示例图

左右布局示例图

  • 接口调用:
//混图器参数配置
MixerCfg* mixerCfg = [[MixerCfg alloc]init];
mixerCfg.fps = 15;
mixerCfg.dstResolution = CGSizeMake(848,480);

// 图像内容集合 - 创建左右布局的摄像头录制内容,
NSMutableArray<RecContentItem *> *contents = [NSMutableArray array];
//自己的摄像头(左边布局), 设置摄像头录制视频大小,由于左右布局, 宽度只有录制布局的一半
CGRect leftRect = CGRectMake(0, 0, mixerCfg.dstResolution.width/2, mixerCfg.dstResolution.height);
// 添加到内容列表
RecVideoContentItem *leftVideoItem = [[RecVideoContentItem alloc] initWithRect:leftRect userID:myUserID camID:-1];
[contents addObject:leftVideoItem];

//其他人的摄像头(右边布局)
CGRect rightRect = CGRectMake(mixerCfg.dstResolution.width/2, 0, mixerCfg.dstResolution.width/2, mixerCfg.dstResolution.height);
RecVideoContentItem* rightVideoItem = [[RecVideoContentItem alloc] initWithRect:rightRect userID:otherUserID camID:-1];

// 添加到内容列表
[contents addObject:rightVideoItem];

MixerContent *recContent = [[MixerContent alloc]init];
recContent.contents = [contents copy];

// 创建混图器, 设置混图器编号为1
CRVIDEOSDK_ERR_DEF rslt = [[RTCMeeting shareInstance] createLocMixer:@"1" cfg:mixerCfg content:recContent];
if(rslt == CRVIDEOSDK_NOERR)
{
    //创建成功
}

相关API请参考:

相关结构定义请参考:

2. 开启直播推流

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

  • 接口调用:
NSMutableArray<OutputCfg*> *outputCfgs = [NSMutableArray array];

// A直播平台
OutputCfg* outputCfgA = [[OutputCfg alloc]init];
[outputCfgA setType:OUT_LIVE];
[outputCfgA setLiveUrl:@"rtmp://A/xxx"];
//添加配置A
[outputCfgs addObject:outputCfgA];

// B直播平台
OutputCfg* outputCfgB = [[OutputCfg alloc]init];
[outputCfgB setType:OUT_LIVE];
[outputCfgB setLiveUrl:@"rtmp://B/xxx"];
//添加配置B
[outputCfgs addObject:outputCfgB];

NSMutableDictionary<NSString*,MixerOutput*> *outputDic = [NSMutableDictionary dictionary];

MixerOutput* output = [[MixerOutput alloc]init];
output.outputs = outputCfgs;
[outputDic setObject:output forKey:_mixerID];

[[RTCMeeting shareInstance] addLocMixer:@"1" outputs:output];

相关API请参考:

3. 直播推流事件处理

录制过程中都会触发此事件。在此可以实时获得录像文件当前的时长、大小,以及录像文件异常等信息。

  • 回调通知:
-(void)locMixerOutputInfo:(NSString*)mixerID nameUrl:(NSString*)nameUrl outputInfo:(OutputInfo*)outputInfo
{
	if ( outputInfo.state==OUTPUT_ERR ){
        //录像文件出错,info.errCode中有错误原因
    }
}

相关API请参考:

4. 更新图像内容

  • 画中画布局示例图

画中画布局示例图

  • 接口调用:
// 图像内容集合 - 创建画中画布局的摄像头录制内容,
NSMutableArray<RecContentItem *> *contents = [NSMutableArray array];
//自己的摄像头(充满布局)
CGRect leftRect = CGRectMake(0, 0, mixerCfg.dstResolution.width, mixerCfg.dstResolution.height);
// 添加到内容列表
RecVideoContentItem *leftVideoItem = [[RecVideoContentItem alloc] initWithRect:leftRect userID:myUserID camID:-1];
[contents addObject:leftVideoItem];

//其他人的摄像头(右边布局)
CGRect rightRect = CGRectMake(0, 0, mixerCfg.dstResolution.width/5, mixerCfg.dstResolution.height/5);
RecVideoContentItem* rightVideoItem = [[RecVideoContentItem alloc] initWithRect:rightRect userID:otherUserID camID:-1];

// 添加到内容列表
[contents addObject:rightVideoItem];
MixerContent *recContent = [[MixerContent alloc]init];
recContent.contents = [contents copy];

// 更新图像内容
CRVIDEOSDK_ERR_DEF rslt = [[RTCMeeting shareInstance] updateLocMixerContent:@"1" content:contents];
if (rslt == CRVIDEOSDK_NOERR) {
    //更新配置成功
}

相关API请参考:

5.结束

  • 接口调用:
//混图器编号
NSString* mixerID = @"1";

//销毁混图器, 各输出自动结束
[[RTCMeeting shareInstance] destroyLocMixer:mixerID];

相关API请参考: