音视频通话

推送我的声音到房间

功能介绍

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

  • 入会后调用开麦接口,将麦克风采集的声音编码并送入房间
  • 麦克风设备选择与采集音量
  • 开麦/关麦操作及麦克风状态与回调

1. 打开麦克风

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

  • 开麦流程:调用 openMic(userID) 打开指定用户(通常为本端用户)的麦克风。
  • 房间开麦数限制:一个房间最大开麦数为 8(如需更多可联系商务定制),超出时新开麦请求会保持等待状态。
  • 关麦:调用 closeMic(userID) 可立即关麦,本地会立即停止采集,房间内所有人会收到麦克风状态变化通知。

开麦/关麦示例:

const rtcsdk = new RTCSDK();
const myUserID = "12345678";

// 打开本端麦克风,将声音推送到房间
rtcsdk.openMic(myUserID);

// 关闭本端麦克风,停止向房间推送声音
rtcsdk.closeMic(myUserID);

相关 API 请参考:

2. 麦克风设备与音量

开麦后,采集使用的麦克风设备与音量由音频配置与音量接口控制,仅影响本端送出的声音大小与音质。

  • 系统音量:setMicVolume(0~255) 设置当前麦克风设备的系统采集音量。

  • 设置/获取麦克风音量示例:

const rtcsdk = new RTCSDK();

// 设置麦克风系统音量(0~255)
rtcsdk.setMicVolume(200);
const micVol = rtcsdk.getMicVolume();

麦克风设备选择详见 音频设备管理。

相关 API 请参考:

3. 麦克风状态与回调

  • 查询状态:getMicStatus(userID) 可查询指定用户当前麦克风状态。

  • 状态变化通知:房间内任何人开麦或关麦时,所有人都会收到 notifyMicStatusChanged 回调。

  • 说话能量:若需展示是否在说话等 UI,可监听 notifyMicEnergy 根据能量变化做可视化。

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

rtcsdk.on('notifyMicStatusChanged', (data) => {
    const { userID, oldStatus, newStatus } = data;
    // 根据 newStatus 更新 UI
});

rtcsdk.on('notifyMicEnergy', (data) => {
    const { userID, oldLevel, newLevel } = data;
    // 根据 newLevel 做可视化展示
});

相关 API 请参考: