音视频通话

推送我的声音到房间

功能介绍

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

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

1. 打开麦克风

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

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

开麦/关麦示例:

import { CrSDK } from '@cr/react-native-rtc';

const myUserID = '12345678';

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

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

相关 API 与常量请参考:

2. 麦克风状态与回调

  • 查询状态:getAudioStatus(userID) 可查询指定用户当前麦克风状态(如 ASTATUS.OPEN、ASTATUS.OPENING、ASTATUS.CLOSED 等)。

  • 状态变化通知:房间内任何人开麦或关麦时,所有人都会收到 audioStatusChanged 回调,可在其中刷新 UI(如麦克风图标、静音状态)。

  • 说话能量:若需展示"是否在说话"等 UI,可重写 micEnergyUpdate,根据能量变化做可视化。

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

import { CrSDKNotifier, NOTIFIER_EVENT, CR_ASTATUS } from '@cr/react-native-rtc';

class AudioListener extends CrSDKNotifier {
  audioDevChanged() {
    // 音频设备变化
  }

  audioStatusChanged(asc: { userId: string; newStatus: CR_ASTATUS; oldStatus: CR_ASTATUS }) {
    // 麦克风状态回调
  }

  micEnergyUpdate(micEnergy: { userId: string; newLevel: number; oldLevel: number }) {
    // 麦克风能量回调
  }
}

const listener = new AudioListener();
listener.addCrNotifierListener([
  NOTIFIER_EVENT.audioDevChanged,
  NOTIFIER_EVENT.audioStatusChanged,
  NOTIFIER_EVENT.micEnergyUpdate,
]);

相关 API 与常量请参考: