发布音视频流

本文档主要介绍主播如何发布和取消发布本地音视频流。

摄像头视频预览和发布

您可以调用 startLocalPreview 接口打开摄像头预览，SDK 会尝试打开系统上查到的第一个摄像头设备。

• 如果您希望设置本地画面的渲染参数，可以通过调用 setLocalRenderParams 接口来设置本地预览的渲染参数。为防止先开启预览再设置预览参数会出现画面跳动，如果您需要设置预览参数，推荐在开启预览之前调用。
• 如果您希望控制摄像头的采集参数，可以通过调用 setVideoEncoderParam 来设置采集宽、高等参数，推荐在开启预览之前调用，当然也支持动态设置摄像头采集参数。

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

// 设置视频编码参数(可选)
BRTCVideoEncParam videoEncParams;
videoEncParams.bandWidth = 400;
videoEncParams.fps = 15;
videoEncParams.width = 640;
videoEncParams.height = 360;
m_pBrtc->setVideoEncoderParam(videoEncParams);

// 设置渲染参数(可选)
BRTCRenderParams renderParam;
renderParam.rotation = BRTCVideoRotation_0;
renderParam.fillMode = BRTCVideoFillMode_Fit;
renderParam.mirrorType = BRTCVideoMirrorTypeDisable;
m_pBrtc->setLocalRenderParams(renderParams);

// 打开本地摄像头视频预览
m_pBrtc->startLocalPreview(myView);
// 本地视频推送到服务端
m_pBrtc->muteLocalVideo(false);

// 停止本地视频采集和预览
m_pBrtc->stopLocalPreview();
m_pBrtc->muteLocalVideo(true);

麦克风音频采集和发布

您可以调用 startLocalAudio 来开启麦克风采集。您可以选择以下三种质量模式：

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

可以调用 stopLocalAudio 关闭麦克风音频的采集并释放对麦克风设备的占用。

注意：调用 startLocalAudio 并不会开始推送音频流，还需要您调用 muteLocalAudio 接口来完成音频流推送或取消推送。

// 开启麦克风采集，并设置当前场景为默认音质
m_pBrtc->startLocalAudio(BRTCAudioQualityDefault);
// 推音频流
m_pBrtc->muteLocalAudio(false);

// 停止推音频流
m_pBrtc->muteLocalAudio(true);
// 停止麦克风采集
m_pBrtc->stopLocalAudio();

角色切换后发布流

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

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

BRTCParams params;
params.appID = "klskd0sd8sdfooi7we";
params.roomID = "123456";
params.sign = "9sdw9sssq";
BRTCUser user;
user.userId = "111111";
params.user = user;
// 以观众角色进房
params.role = BRTCRoleAudience;
m_pBrtc->enterRoom(params);

// 切换为主播
m_pBrtc->switchRole(BRTCRoleAnchor);
// 打开音频和视频设备，开始推流
m_pBrtc->startLocalPreview(...);
m_pBrtc->muteLocalVideo(false);
m_pBrtc->muteLocalAudio(false);