音视频通话

变声

功能介绍

变声功能允许在实时音视频通话中改变指定用户的语音音色(如中性女声、低沉男声、娃娃音等),适用于娱乐、匿名或角色扮演等场景。

实现方式:变声在服务器端完成处理,因此具有以下特点:

  • 实际会议中:其他参会者听到的和云端录制的是经变声处理后的声音。
  • 本地侧:本地录制、本地语音环回测试(startEchoTest)时,听到或录到的均为未变声的原始声音。

1. 设置变声类型

对指定用户(通常为本端用户)设置变声类型。支持预定义类型与自定义音高。

const rtcsdk = new RTCSDK();

// 设置为甜美女声(预定义类型1)
rtcsdk.setVoiceChange(myUserID, 1);

// 自定义:略升调(例如 160,150为原声)
rtcsdk.setVoiceChange(myUserID, 160);

// 恢复原声
rtcsdk.setVoiceChange(myUserID, 0);

相关 API:

2. 查询变声类型

查询某用户当前使用的变声类型,便于 UI 展示或逻辑判断。

const rtcsdk = new RTCSDK();
const type = rtcsdk.getVoiceChangeType(targetUserID);

相关 API:

3. 变声状态变化通知

当房间内某用户的变声类型被设置或修改时,SDK 会通过回调通知应用。

rtcsdk.on('notifySetVoiceChange', (data) => {
    const { userID, type, operatorID } = data;
});

相关 API: