音视频通话

变声

功能介绍

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

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

  • 实际会议中:其他参会者听到的和云端录制的是经变声处理后的声音,效果按 CRVideo_SetVoiceChange 配置生效。
  • 本地侧:通过 CRVideo_NotifyAudioStream、原始音频数据获取 等方式在本端获取的音频,一般为未变声的原始声音;若需验证变声效果,需在会议中由其他端收听或通过云端录制回放。
注意:

须在成功进入房间后,方可使用变声相关接口。

1. 设置变声类型

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

  • 预定义类型:见 CRVideo_VOICECHANGE_TYPE,如原声、中性女声/男声、甜美女声、低沉男声、娃娃音等。
  • 自定义变声:type 取值 100~200,150 为原声,<150 为降调,>150 为升调。

调用示例:

var UID = myUID;

// 设置为甜美女声(预定义,type 为 3)
CRVideo_SetVoiceChange(UID, 3).then(function(resObj){
    // 设置成功,resObj 含 errCode
}).catch(function(errObj){
    // 设置失败,errObj 含 errCode、errDesc
});

// 自定义:略升调(例如 160)
CRVideo_SetVoiceChange(UID, 160);

// 恢复原声(type 为 0)
CRVideo_SetVoiceChange(UID, 0);

相关 API:

2. 查询变声类型

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

调用示例:

var type = CRVideo_GetVoiceChangeType(UID);
// type 为 0~6 的预定义类型,或 100~200 的自定义值

相关 API:

3. 变声状态变化通知

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

CRVideo_NotifySetVoiceChange.callback = function(UID, type){
    // UID:变声类型发生变化的用户;type:新的变声类型
}

相关 API:

4. 变声类型常量

预定义变声类型及取值见:

5. 使用注意事项

  • 服务器端处理:变声在服务端完成,本端 NotifyAudioStream、PCM 采集等链路听到/拿到的一般为未变声原始音频;会议中其他参会者听到的是变声后的效果。
  • 云端录制:若需带变声效果的录制,请使用云端录制等服务器侧能力;本端自行录制的原始流通常不含变声效果。
  • 与开麦的关系:变声作用于已送入房间的语音;请确保用户已 开麦 后,其他端才能听到变声效果。