变声
功能介绍
变声功能允许在实时音视频通话中改变指定用户的语音音色(如中性女声、低沉男声、娃娃音等),适用于娱乐、匿名或角色扮演等场景。
实现方式:变声在服务器端完成处理,因此具有以下特点:
- 实际会议中:其他参会者听到的和云端录制的是经变声处理后的声音,效果按 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 展示或逻辑判断。
- 返回值:预定义类型参见 CRVideo_VOICECHANGE_TYPE;自定义变声为 100~200 的整数值。
调用示例:
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 采集等链路听到/拿到的一般为未变声原始音频;会议中其他参会者听到的是变声后的效果。
- 云端录制:若需带变声效果的录制,请使用云端录制等服务器侧能力;本端自行录制的原始流通常不含变声效果。
- 与开麦的关系:变声作用于已送入房间的语音;请确保用户已 开麦 后,其他端才能听到变声效果。