音视频通话

推送我的声音到房间

功能介绍

本节介绍如何将本端声音推送到房间,使其他参会者能听到自己说话,包括:

  • 入会后调用开麦接口,将麦克风采集的声音编码并送入房间
  • 麦克风设备选择与采集音量配置
  • 开麦/关麦操作及麦克风状态与回调
  • 可选:获取 WebRTC 音频流或 PCM 数据自行处理(如降噪、录制、二次编码等)

若需自行处理本端采集或推送链路中的音频,可使用 CRVideo_NotifyAudioStream 获取 WebRTC 音频流(aSide 为 0 表示本端),可配合 Web Audio API 或 audio 标签二次处理;也可通过 原始音频数据获取 获取麦克风侧 PCM。

注意:

须在成功进入房间后,方可开麦、关麦及查询麦克风状态。

1. 打开麦克风

入会成功后,若要将自己的声音推送给房间内其他人,需要调用 开麦 接口。开麦后,SDK 会从当前选定的麦克风设备采集声音,编码后发送到服务器,房间内其他参会者即可听到。

  • 开麦流程:调用 CRVideo_OpenMic(UID) 打开指定用户(通常为本端用户)的麦克风。先进入 AOPENING(状态码 4)状态,等服务器处理完成后变为 AOPEN(状态码 3),此时说话才会被采集并送入房间。
  • 房间开麦数限制:一个房间最大开麦数为 8(如需超过 8,可联系商务定制),超出时新开麦请求会保持在 AOPENING 状态;有人关麦后不会自动补位,需要再次调用 CRVideo_OpenMic。
  • 关麦:调用 CRVideo_CloseMic(UID) 可立即关麦,本地会立即停止采集,房间内所有人会收到麦克风状态变化通知。

开麦/关麦示例:

var UID = myUID;  // 本端用户 ID

// 打开本端麦克风,将声音推送到房间
CRVideo_OpenMic(UID);

// 关闭本端麦克风,停止向房间推送声音
CRVideo_CloseMic(UID);

打开麦克风失败时,会收到 CRVideo_OpenMicFailed 通知(如设备被占用、用户未授权、无可用设备等)。

相关 API 与常量请参考:

2. 麦克风设备与音量

开麦后,采集使用的麦克风设备与音量由 音频设备管理 与 CRVideo_AudioCfg 控制,仅影响本端送出的声音大小与音质,不影响房间内其他人是否听到(只要已开麦即可听到)。

  • 麦克风设备:通过 CRVideo_GetAudioCfg / CRVideo_SetAudioCfg 设置 micID(设备 ID 来自 CRVideo_GetAudioMicNames)。设备枚举与选择详见 音频设备管理。
  • 采集处理:autoGainControl(自动增益)、echoCancellation(回声消除)、noiseSuppression(噪声抑制)等布尔开关,用于控制浏览器侧采集处理。
  • 采集音量:micVolume 为麦克风静态增益;须在关闭 autoGainControl 时生效。0 表示静音,100 为正常音量,0~100 为降低音量,>100 为增大音量。
var cfg = CRVideo_GetAudioCfg();
cfg.autoGainControl = true;
cfg.echoCancellation = true;
cfg.noiseSuppression = true;
cfg.micVolume = 100;
CRVideo_SetAudioCfg(cfg);

相关 API 请参考:

3. 麦克风状态与回调

监听麦克风状态变化示例:

CRVideo_AudioStatusChanged.callback = function(UID, oldStatus, newStatus, opID){
    // UID:状态变化的用户;opID:操作者
    // 根据 newStatus 更新 UI
}

相关 API 与常量请参考: