发布音视频流

编辑文档更新于 2025-01-16 07:59:52

Android

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

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

摄像头视频预览和发布

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

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

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

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

//设置编码镜像模式
engine.setVideoEncoderMirror(false);
//本地图像渲染设置
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 来开启麦克风采集和上行推流，该接口需要您通过 quality 参数确定采集模式。

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

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

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

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

//停止发布音频流
engine.muteLocalAudio(true);
//关闭本地音频的采集和推流
engine.stopLocalAudio();

角色切换后发布流

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

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

engine = BRTC.sharedInstance(this);
engine.setListener(brtcListener);
BRTCDef.BRTCParams BRTCParams = new BRTCDef.BRTCParams(String.valueOf(GenerateTestUserSig.SDKAPPID),roomID, userID, uSig, BRTCDef.BRTCRoleType.BRTCRoleAudience);
engine.enterRoom(BRTCParams);
//切换为主播
engine.switchRole(BRTCDef.BRTCRoleType.BRTCRoleAnchor);
//打开音频和视频设备，开始推流
engine.muteLocalVideo(false);
engine.muteLocalAudio(false);