发布音视频流

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

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

摄像头视频预览和发布

您可以调用 startLocalPreview 接口打开摄像头预览，此时 SDK 会打开摄像头采集，当开始本地渲染第一帧数据时会回调 first-video-frame-rendered 事件。
如果您希望控制摄像头的采集参数，可以通过调用 setVideoEncoderParam 来设置采集宽、高等参数，推荐在开启预览之前调用，当然也支持动态设置摄像头采集参数。

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


// 设置大流推送视频编码参数
this.client.setVideoEncoderParam({
  bandWidth: 500,
  width: 640,
  height: 480,
  frameRate: 15
})
// 打开双路流模式，设置小流视频编码参数
this.client.enableEncSmallVideoStream(true, {
  bandWidth: 70,
  width: 160,
  height: 120,
  frameRate: 15
})
// 设置编码时视频旋转180度
this.client.setVideoEncoderRotation(BRTCCloud.BRTCVideoRotation.BRTC_VIDEO_RATATION_180)
// 关闭远端镜像功能
this.client.setVideoEncoderMirror(false)
// 设置网络流控策略为保流畅
this.client.setNetworkQosParam({preference: BRTCCloud.BRTCVideoQosPreference.BRTC_VIDEO_QOS_PREFERENCE_SMOOTH})
// 设置网络流控策略为保清晰
//this.client.setNetworkQosParam({preference: BRTCCloud.BRTCVideoQosPreference.BRTC_VIDEO_QOS_PREFERENCE_CLEAR})

// 开启本地视频预览画面
this.client.startLocalPreview();
this.client.muteLocalVideo(false);

// 开启本地视频采集和上行推流，设置音频音质为音乐高音质
//this.client.startLocalAudio(BRTCCloud.BRTCAudioQuality.BRTC_AUDIO_QUALITY_MUSIC);
// 开启本地视频采集和上行推流，设置音频音质为默认音质
this.client.startLocalAudio(BRTCCloud.BRTCAudioQuality.BRTC_AUDIO_QUALITY_DEFAULT);
// 开启本地视频采集和上行推流，设置音频音质为流畅音质
//this.client.startLocalAudio(BRTCCloud.BRTCAudioQuality.BRTC_AUDIO_QUALITY_SPEECH);
this.client.muteLocalAudio(false);

// 停止本地的视频采集和预览
this.client.stopLocalPreview()
this.client.muteLocalVideo(true)
this.client.stopLocalAudio()
this.client.muteLocalAudio(true)

麦克风音频采集和发布

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

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

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

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

// 开启麦克风采集示例，并设置当前场景为：音乐模式（适合需要高保真传输音乐的场景）
//this.client.startLocalAudio(BRTCCloud.BRTCAudioQuality.BRTC_AUDIO_QUALITY_MUSIC);
// 开启麦克风采集，并设置当前场景为：默认音质，介于通话和音乐之间
this.client.startLocalAudio(BRTCCloud.BRTCAudioQuality.BRTC_AUDIO_QUALITY_DEFAULT);
// 开启麦克风采集示例，并设置当前场景为：语音模式（适合语音通话为主的场景）
//this.client.startLocalAudio(BRTCCloud.BRTCAudioQuality.BRTC_AUDIO_QUALITY_SPEECH);
this.client.muteLocalAudio(false);
this.audioOn = audioOn;

// 停止本地的音频频采集和预览
this.client.stopLocalAudio()
//停止发布音频流
this.client.muteLocalAudio(true)

角色切换后发布流

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

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

var roomID = "123456";
var sig = "9sdw9sssq";
var userId = "111111";
this.client.enterRoom(roomId, userId, sig)
this.client.on('switch-role',  (code, name) => {
    console.log('\n 用户切换角色成功: ${name} , event: switch-role')
    if(this.isAnchor){
      // 切换为主播后，打开音频和视频设备，开始推流
      this.client.muteLocalAudio(false)
      this.client.muteLocalVideo(false)
    }
  }
)
// 切换为主播
this.client.switchRole(BRTCCloud.BRTCRoleType.BRTC_ROLE_ANCHOR)
// 切换为观众
//this.client.switchRole(BRTCCloud.BRTCRoleType.BRTC_ROLE_AUDIENCE)