发布音视频流

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

摄像头视频预览和发布

您的应用必须向系统申请摄像头的使用权限，需要用户授权通过后才可以调用 startLocalPreview 接口打开摄像头预览。

📝 您可以借助各种 AI 智能体或者编程工具协助您完成一份兼容各种 Android 版本的申请摄像头权限的代码。

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

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

// （可选）本地图像渲染设置
BRTCDef.BRTCRenderParams localRenderParams = new BRTCDef.BRTCRenderParams();
localRenderParams.fillMode = BRTCDef.BRTCVideoFillMode.BRTCVideoFillMode_Fit;
localRenderParams.rotation = BRTCDef.BRTCVideoRotation.BRTCVideoRotation_0;
localRenderParams.mirrorType = BRTCDef.BRTCVideoMirrorType.BRTCVideoMirrorTypeDisable;
engine.setLocalRenderParams(localRenderParams);

// 使用前置摄像头，打开本地摄像头视频预览
engine.startLocalPreview(true, previewCanvas);
// 开始推视频流
engine.muteLocalVideo(false);

// 停止推视频流
engine.muteLocalVideo(true);
// 停止本地视频采集和预览
engine.stopLocalPreview();

麦克风音频采集和发布

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

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

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

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

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

// 停止推音频流
engine.muteLocalAudio(true);
// 停止麦克风采集
engine.stopLocalAudio();

角色切换后发布流

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

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

BRTC engine = BRTC.sharedInstance(context);
// 以观众角色进房（不指定角色参数，默认是主播）
BRTCDef.BRTCParams BRTCParams = new BRTCDef.BRTCParams(APP_ID, ROOM_ID, USER_ID, USER_SIG, BRTCDef.BRTCRoleType.BRTCRoleAnchor);
engine.enterRoom(BRTCParams);
// 切换为主播
engine.switchRole(BRTCDef.BRTCRoleType.BRTCRoleAnchor);
// 打开麦克风并开始推流
engine.startLocalAudio(BRTCDef.BRTCAudioQuality.BRTCAudioQualityDefault);
engine.muteLocalAudio(false);
// 打开摄像头并开始推流
engine.startLocalPreview(true, BRTCAdaptCanvas);
engine.muteLocalVideo(false);