发布音视频流

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

本文档主要介绍主播如何发布和取消发布本地音视频流。
相关函数接口在 c++-sdk 2.5.5 及以上版本支持。

摄像头视频预览和发布

您可以调用 startLocalPreview 接口打开摄像头预览，此时 SDK 会打开摄像头采集，当开始本地渲染第一帧数据时会回调 onFirstVideoFrame 事件。

如果您希望设置本地画面的渲染参数，可以通过调用 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->setVideoEncoderMirror(false);
BRTCNetworkQosParam qosParams;
qosParams.preference = BRTCVideoQosPreferenceClear;
// 设置网络 qos 参数，弱网情况下保清晰
m_pBrtc->setNetworkQosParam(qosParams);
// 启用音量大小提示
m_pBrtc->enableAudioVolumeEvaluation(300);

BRTCVideoEncParam param;
param.fps = 15;
param.bandWidth = 100;
param.width = 160;
param.height = 120;
// 打开双路编码功能
m_pBrtc->enableEncSmallVideoStream(true, param);
// 打开本地摄像头视频预览
m_pBrtc->startLocalPreview(myView);
// 本地视频推送到服务端
m_pBrtc->muteLocalVideo(false);

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

麦克风音频采集和发布

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

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

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

调用此方法，会停止传递本地麦克风音频数据给房间里其他用户，并释放对麦克风设备的占用。

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

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

角色切换后发布流

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

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

BRTCParams params;
params.appID = "klskd0sd8sdfooi7we";
params.roomID = "123456";
params.sign = "9sdw9sssq";
BRTCUser user;
user.userId = "111111";
params.user = user;
m_pBrtc->enterRoom(params);

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