变声
功能介绍
变声功能允许在实时音视频通话中改变指定用户的语音音色(如中性女声、低沉男声、娃娃音等),适用于娱乐、匿名或角色扮演等场景。
实现方式:变声在服务器端完成处理,因此具有以下特点:
- 实际会议中:其他参会者听到的和云端录制的是经变声处理后的声音,效果按 setVoiceChange 等配置生效。
- 本地侧:本地录制、本地语音环回测试(startEchoTest)时,听到或录到的均为未变声的原始声音;若需验证变声效果,需在会议中由其他端收听或通过云端录制回放。
1. 设置变声类型
对指定用户(通常为本端用户)设置变声类型。支持预定义类型与自定义音高。
- 预定义类型:见 CRVOICECHANGE_TYPE,如原声、中性女声/男声、甜美女声、低沉男声、娃娃音等。
- 自定义变声:type 取值 100~200,150 为原声,<150 为降调,>150 为升调。
调用示例:
RTCMeeting *meeting = [RTCMeeting shareInstance];
// 设置为甜美女声(预定义)
[meeting setVoiceChange:myUserID type:CRVSDK_VOICETYPE_SWEETFEMALE];
// 自定义:略升调(例如 160)
[meeting setVoiceChange:myUserID type:160];
// 恢复原声
[meeting setVoiceChange:myUserID type:CRVSDK_VOICETYPE_NULL];
相关 API:
2. 查询变声类型
查询某用户当前使用的变声类型,便于 UI 展示或逻辑判断。
- 返回值:预定义类型参见 CRVOICECHANGE_TYPE;自定义变声为 100~200 的整数值。
调用示例:
RTCMeeting *meeting = [RTCMeeting shareInstance];
int type = [meeting getVoiceChangeType:targetUserID];
// type 为 CRVOICECHANGE_TYPE* 或 100~200
相关 API:
3. 变声状态变化通知
当房间内某用户的变声类型被设置或修改时,SDK 会通过回调通知应用,便于同步 UI 或记录操作者。
- 需在 CRVideoSDKMeetingCallBack 派生类中实现 notifySetVoiceChange。
- 参数:userID 为被设置变声的用户,type 为新的变声类型,oprUserID 为执行该操作的用户 ID。
相关 API:
4. 变声类型常量
预定义变声类型及取值见:
5. 使用注意事项
- 调用线程:变声相关接口非线程安全,请在 SDK 主线程中调用。
- 与环回测试的关系:变声为服务器端实现,本地 语音环回测试 时听到的是未变声效果;实际会议中变声仍按上述配置生效。
- 与本地录制的关系:本地录制得到的是未变声的原始声音;若需带变声效果的录制,请使用云端录制等服务器侧能力。