发布音视频流

本文档主要介绍主播如何发布和取消发布本地音视频流。进入房间后才可以启动摄像头预览和麦克风采集。 目前不支持再进入房间前启动摄像头和麦克风。

相关函数接口在 ios-sdk 2.8.20 及以上版本支持

摄像头视频预览和发布

您可以调用 startLocalPreview 接口打开摄像头预览，此时 SDK 会向系统申请摄像头的使用权限，需要用户授权通过后才会开启摄像头的采集流程。

如果您希望设置本地画面的渲染参数，可以通过调用 setLocalRenderParams 接口来设置本地预览的渲染参数。为防止先开启预览再设置预览参数会出现画面跳动，如果您需要设置预览参数，推荐在开启预览之前调用。

如果您希望控制摄像头的各种控制参数，可以通过调用 BRTCDeviceManager 接口来完成“切换前后摄像头”、“设置对焦模式“、“打开、关闭闪光灯”等一系列操作。

可以通过 stopLocalPreview 停止本地视频的采集和预览。

self.brtc = [BRTC sharedInstance];
self.brtc.delegate = self;
BRTCRenderParams *renderParams = [BRTCRenderParams new];
renderParams.fillMode = BRTCVideoFillMode_Fit;
//设置本地显示模式为fit模式
[self.brtc setLocalRenderParams:renderParams];
BRTCVideoEncParam *config = [BRTCVideoEncParam new];
config.bandWidth = 800;
config.fps = 15;
config.width = 480;
config.height = 360;
//设置编码参数
[self.brtc setVideoEncoderParam:config];
BRTCParams *params = [BRTCParams new];
params.appID = appID;
params.sign = sig;
params.roomID = tempRoomID;
params.userID = userId;
//进入房间
[self.brtc enterRoom:params];
//使用前置摄像头，打开本地摄像头视频预览
[self.brtc startLocalPreview:YES view:self.localPreviewView];
//本地视频发布到教室
[self.brtc muteLocalVideo:NO];

//停止本地视频采集和预览
[self.brtc stopLocalPreview];
[self.brtc muteLocalVideo:YES];

麦克风音频采集和发布

您可以调用 startLocalAudio 来开启麦克风采集和上行推流，该接口需要您通过 quality 参数确定采集模式。

• SPEECH
  • 该模式下的 SDK 音频模块会专注于提炼语音信号，尽最大限度的过滤周围的环境噪音，同时该模式下的音频数据也会获得较好的差质量网络的抵抗能力，适合语音通话为主的场景，比如在线会议，语音通话。
  • 流畅音质：采样率：16k；单声道；音频裸码率：16kbps
• MUSIC
  • 该模式下的 SDK 会采用很高的音频处理带宽以及立体式模式，在最大限度地提升采集质量的同时也会将音频的 DSP 处理模块调节到最弱的级别，从而最大限度地保证音质。适合需要高保真传输音乐的场景，比如K歌、音乐直播等。
  • 高音质：采样率：48k；双声道 + 全频带；音频裸码率：128kbps
• DEFAULT
  • 该模式下的 SDK 会启用智能识别算法来识别当前环境，并针对性地选择最佳的处理模式。不过再好的识别算法也会有不准确的时候，如果您非常清楚自己的产品定位，更推荐您在专注语音通信的 SPEECH 和 MUSIC 之间二选一。
  • 默认音质：采样率：48k；单声道；音频裸码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之

可以调用 stopLocalAudio 关闭麦克风音频的采集和上行推流。

• 调用此方法，会停止传递本地麦克风音频数据给房间里其他用户，并释放对麦克风设备的占用。
• 如果您没有通过 setSystemVolumeType 改变过默认系统音量类型，调用此接口会设置系统音量类型为媒体音量

//开启麦克风采集，并设置当前场景为：默认音质，介于通话和音乐之间
[self.brtc startLocalAudio:BRTCAudioQualityDefault];
//发布音频流
[self.brtc muteLocalAudio:NO];
//开启麦克风采集示例，并设置当前场景为：语音模式（适合语音通话为主的场景）
//[self.brtc startLocalAudio:BRTCAudioQualitySpeech];
// 开启麦克风采集示例，并设置当前场景为：音乐模式（适合需要高保真传输音乐的场景）
//[self.brtc startLocalAudio:BRTCAudioQualityMusic];

//停止发布音频流
[self.brtc muteLocalAudio:YES];
//关闭本地音频的采集和推流
[self.brtc stopLocalAudio];

角色切换后发布流

在BRTC中目前存在两个角色， 主播（Anchor）和观众（Audience）。 进入房间时需要设置角色，如果没有指定角色，目前用户进房间默认都是主播。

• 只有“主播（Anchor）”才有权限发布音视频流，“观众（Audience）”是不能发布音视频流的。
• 如果您在进房时使用的角色是“观众（Audience）”，需要先调用 switchRole 接口将角色切换成“主播（Anchor）”，才能发布音视频流（也就是俗称的“上麦”）。
• 以主播身份进房发布流后，调用此接口切换到观众，将会停止发布音视频流
• 以观众身份进房后，调用此接口切换到主播，SDK 并不会自动发布音视频流，需要您再调用 startLocalAudio, muteLocalAudio, muteLocalVideo 等接口来启动音频或视频推流。

self.brtc = [BRTC sharedInstance];
//设置回调接口
self.brtc.delegate = self;

BRTCVideoEncParam *videoConfig = [BRTCVideoEncParam new];
videoConfig.bandWidth = 1500;
videoConfig.width = 640;
videoConfig.height = 480;
videoConfig.fps = 25;
//设置视频编码参数
[self.brtc setVideoEncoderParam:videoConfig];

BRTCParams *params = [BRTCParams new];
params.appID = appID;
params.sign = sig;
params.roomID = roomID;
params.userID = userId;
params.role = (strongSelf.role == BRTCRoleAnchor) ? BRTCRoleAnchor : BRTCRoleAudience;
//进入房间
[self.brtc enterRoom:params];

//切换为主播
[self.brtc switchRole:BRTCRoleAnchor];
//打开音频和视频设备，开始推流
BRTCViewObject *obj = [self addView:self.userIDTextField.text];
[self.brtc startLocalPreview:YES view:obj.view];
[self.brtc muteLocalVideo:NO];
[self.brtc startLocalAudio:BRTCAudioQualityDefault];
[self.brtc muteLocalAudio:NO];

BRTCRenderParams *params = [[BRTCRenderParams alloc] init];
params.fillMode = BRTCVideoFillMode_Fill;
params.mirrorType = BRTCVideoMirrorTypeAuto;
//设置本地视频渲染模式
[self.brtc setLocalRenderParams:params];