推送我的声音到房间
功能介绍
本节介绍如何将本端声音推送到房间,使其他参会者能听到自己说话,包括:
- 入会后调用开麦接口,将麦克风采集的声音编码并送入房间
- 麦克风设备选择与采集音量、软件音量缩放
- 开麦/关麦操作及麦克风状态与回调
- 可选:通过自定义音频采集向 SDK 送入 PCM 数据,由 SDK 编码后发送(参见 自定义音频采集/渲染)
1. 打开麦克风
成功进入房间后,若要将自己的声音推送给房间内其他人,需要调用 开麦 接口。开麦后,SDK 会从当前选定的麦克风设备采集声音,编码后发送到服务器,房间内其他参会者即可听到。
- 开麦流程:调用 openMic(userID) 打开指定用户(通常为本端用户)的麦克风。先进入 CRVSDK_AST_OPENING 状态,等服务器处理完成后变为 CRVSDK_AST_OPEN,此时说话才会被采集并送入房间。
- 房间开麦数限制:一个房间最大开麦数为 8(如果需要超过8,可以联系商务定制),超出时新开麦请求会保持在 CRVSDK_AST_OPENING 状态;有人关麦后不会自动补位,需要再次调用 openMic。
- 关麦:调用 closeMic(userID) 可立即关麦,本地会立即停止采集,房间内所有人会收到麦克风状态变化通知。
开麦/关麦示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
std::string myUserID = "12345678";
// 打开本端麦克风,将声音推送到房间
meeting.openMic(myUserID.c_str());
// 关闭本端麦克风,停止向房间推送声音
meeting.closeMic(myUserID.c_str());
相关 API 与常量请参考:
2. 麦克风设备与音量
开麦后,采集使用的麦克风设备与音量由 音频配置 与音量接口控制,仅影响本端送出的声音大小与音质,不影响房间内其他人是否听到(只要已开麦即可听到)。
-
麦克风设备:使用 设备管理 中的 getAudioCfg / setAudioCfg,通过 CRAudioCfg._micID 指定麦克风(空为系统默认麦克风)。
-
系统音量:setMicVolume(0~255) 设置当前麦克风设备的系统采集音量。
-
软件音量:setMicVolumeScaling(factor) 在系统音量基础上再乘以缩放系数,不修改系统设置,适合做“会议麦克风增益”等独立于系统音量的调节。
-
设置/获取麦克风音量示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
// 设置麦克风系统音量(0~255)
meeting.setMicVolume(200);
int micVol = meeting.getMicVolume();
// 设置麦克风音量缩放系数(不改变系统设置)
meeting.setMicVolumeScaling(1.0f); // 1.0 表示不缩放
float scaling = meeting.getMicVolumeScaling();
若需自动调节采集电平,可配合 音频 3A(如 AGC)使用。
相关 API 请参考:
麦克风设备枚举与选择详见 设备管理 - 默认音频设备与设备选择、设备选择。
3. 麦克风状态与回调
-
查询状态:getMicStatus(userID) 可查询指定用户当前麦克风状态(如 CRVSDK_AST_OPEN、CRVSDK_AST_OPENING、CRVSDK_AST_CLOSED 等)。
-
状态变化通知:房间内任何人开麦或关麦时,所有人都会收到 notifyMicStatusChanged(userID, oldStatus, newStatus, oprUserID) 回调,可在其中刷新 UI(如麦克风图标、静音状态)。
-
说话能量:若需展示“是否在说话”等 UI,可重写 notifyMicEnergy(userID, oldLevel, newLevel),根据能量变化做可视化。
-
监听麦克风状态变化示例:
// 在 CRVideoSDKMeetingCallBack 子类中重写
virtual void notifyMicStatusChanged(const char* userID,
CRVSDK_ASTATUS oldStatus,
CRVSDK_ASTATUS newStatus,
const char* oprUserID) override
{
// 根据 newStatus 更新 UI:如 userID 为本端则更新本地麦克风图标,
// 为远端则更新远端用户列表中的麦克风状态
}
相关 API 与常量请参考:
4. 自定义音频采集(可选)
若不由 SDK 从系统麦克风采集,而是由应用从第三方设备或音频文件获取 PCM 数据,可开启自定义音频采集。开启后,通过 pushCustomAudioDat 将 PCM 数据送入 SDK,由 SDK 编码后推送到房间。
具体步骤与格式要求见 自定义音频采集/渲染。
相关 API 请参考: