推送我的声音到房间
功能介绍
本节介绍如何将本端声音推送到房间,使其他参会者能听到自己说话,包括:
- 入会后调用开麦接口,将麦克风采集的声音编码并送入房间
- 麦克风设备选择与采集音量配置
- 开麦/关麦操作及麦克风状态与回调
- 可选:获取 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 与常量请参考:
- CRVideo_OpenMic
- CRVideo_CloseMic
- CRVideo_GetAudioStatus
- CRVideo_AudioStatusChanged
- CRVideo_OpenMicFailed
- CRVideo_ASTATUS
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_GetAudioStatus(UID) 可查询指定用户当前麦克风状态(如
AOPEN、AOPENING、ACLOSED等,见 CRVideo_ASTATUS)。 - 状态变化通知:房间内任何人开麦或关麦时,所有人都会收到 CRVideo_AudioStatusChanged 回调,可在其中刷新 UI(如麦克风图标、静音状态)。
- 说话能量:若需展示“是否在说话”等 UI,可使用 CRVideo_GetMicEnergy 或监听 CRVideo_MicEnergyUpdate(能量等级 0~10)。
监听麦克风状态变化示例:
CRVideo_AudioStatusChanged.callback = function(UID, oldStatus, newStatus, opID){
// UID:状态变化的用户;opID:操作者
// 根据 newStatus 更新 UI
}
相关 API 与常量请参考: