变声
功能介绍
变声功能允许在实时音视频通话中改变指定用户的语音音色(如中性女声、低沉男声、娃娃音等),适用于娱乐、匿名或角色扮演等场景。
实现方式:变声在服务器端完成处理,因此具有以下特点:
- 实际会议中:其他参会者听到的和云端录制的是经变声处理后的声音。
- 本地侧:本地录制、本地语音环回测试(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: