在互动娱乐（如 KTV、语聊房、游戏语音等）场景中，引入变声、混响、降噪等音频效果，能显著提升趣味性、优化用户听觉体验，并增强互动氛围。例如，主播通过立体声或 KTV 混响效果，可以让声音更具吸引力；而精准的降噪则能保证通话质量，让沟通更清晰。

前提条件

• 已集成 RTC SDK，实现了基本的音视频通话。
• 若需使用预设的变声特效，请确已集成音频技术插件。具体操作，参见按需集成插件以缩小应用体积。

功能实现

以下时序图以 Android SDK 中的 API 名称为例。不同端的 SDK 中 API 或回调名称可能略有不同，以 API 参考为准。

1. 创建并初始化 RTC 引擎

创建和初始化一个音视频引擎类。

如果你需要获取远端的音频数据，还需要加入房间并发布音频流，参考 构建 RTC 应用 获取详细步骤。

rtcVideo = RTCVideo.createRTCVideo(this, Constants.APP_ID, rtcVideoEventHandler, null, null);

self.rtcVideo = ByteRTCVideo.createRTCVideo(kAppID, delegate: self, parameters: [:])

bytertc::IRTCVideo *video = bytertc::createRTCVideo("app_id", handler, nullptr);

2. 开启本地音频采集

在对本地音频进行处理前，确保已开启音频采集。

rtcVideo.startAudioCapture();

self.rtcVideo?.startAudioCapture()

video->startAudioCapture();

3. 设置变声与混响特效

通过 setVoiceChangerType 和 setVoiceReverbType 选择 RTC SDK 提供的变声和混响效果。

// 设置变声特效
rtcVideo.setVoiceChangerType(type);
// 设置混响特效
rtcVideo.setVoiceReverbType(type);

// 设置变声特效
self.rtcVideo?.setVoiceChangerType(ByteRTCVoiceChangerType(type))
// 设置混响特效
self.rtcVideo?.setVoiceReverbType(ByteRTCVoiceReverbType(type))

int ret = 0;
//设置变声特效：原声、巨人、黄粟鼠、小黄人、颤音、机器人
ret = video->setVoiceChangerType(type);
//设置混响特效：原声、回声、演唱会、空灵、KTV、录音棚、虚拟立体声、空旷、3D人声 
ret = video->setVoiceReverbType(type);

其中，PC 端使用变声特效 setVoiceChangerType 需要传入音频技术 SDK 的 Token。

#ifdef  Q_OS_WINDOWS
    QJsonObject obj;
    QString sami_path = QApplication::applicationDirPath() + "/Resources/sami_effect";
    obj.insert("rtc.sami_app_key", QString::fromStdString(g_sami_key));
    obj.insert("rtc.sami_resource_path", sami_path);
    obj.insert("rtc.sami_token", QString::fromStdString(g_sami_token));

    QJsonDocument doc(obj);
    QString str = QJsonDocument(obj).toJson(QJsonDocument::Compact);
    std::string str_sami = str.toStdString();
    int ret = m_video->setRuntimeParameters(str_sami.c_str());
#endif //  Q_OS_WINDOWS

4. 自定义音调和混响效果

如果预设效果无法满足你的业务需求，你还可以通过 enableLocalVoiceReverb和 setLocalVoiceReverbParam 自定义人声效果。

// 设置变调，范围 [-12,12]
rtcVideo.setLocalVoicePitch(value);

// 开启本地音效混响效果
rtcVideo.enableLocalVoiceReverb(true);
// 设置本地采集音频的混响效果
rtcVideo.setLocalVoiceReverbParam(config);

// 设置变调，范围 [-12,12]
self.rtcVideo?.setLocalVoicePitch(value)

// 开启本地音效混响效果
self.rtcVideo?.enableLocalVoiceReverb(true)
// 设置本地采集音频的混响效果
self.rtcVideo?.setLocalVoiceReverbParam(config)