需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

人声音效

  • Electron

更新时间不可用

enableVoiceAITuner

开启或关闭 AI 调音器功能。

TypeScript
abstract enableVoiceAITuner(enabled: boolean, type: VoiceAiTunerType): number;

AI 调音器功能支持美化音质，调整音色风格。

适用场景

在线 K 歌、在线播客、秀场直播等对音质有较高要求的社交娱乐场景。

调用时机

加入频道前后均可调用。

参数

参数名描述
enabled

是否开启 AI 调音器功能：

  • true：开启 AI 调音器功能。
  • false：（默认）关闭 AI 调音器功能。
type

AI 调音器音效类型，详见 VoiceAiTunerType。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setAdvancedAudioOptions

设置音频的高级选项。

TypeScript
abstract setAdvancedAudioOptions(options: AdvancedAudioOptions): number;

如果你对音频处理有进阶需求，例如需要采集和发送立体声，可以调用该方法设置音频的高级选项。

注： 你需要在 joinChannel、enableAudio 和 enableLocalAudio 前调用该方法。

参数

参数名描述
options

音频的高级选项。详见 AdvancedAudioOptions。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setAINSMode

设置是否开启 AI 降噪功能并设置降噪模式。

TypeScript
abstract setAINSMode(enabled: boolean, mode: AudioAinsMode): number;

你可以调用开方法来开启 AI 降噪功能。该功能可以在保证语音质量的前提下，智能化检测并降低周围环境中多种稳态与非稳态噪声，使人声更加清晰。 稳态噪声指在任何时间点上都具有相同频率的噪声，常见的稳态噪声有：

  • 电视机噪声
  • 空调噪声
  • 工厂机器噪声等

非稳态噪声是指随时间而快速变化的噪声，常见的非稳态噪声有：

  • 雷声
  • 爆炸声
  • 破裂声等

适用场景

在语音连麦、在线教育、在线会议等场景中，如果周围环境比较嘈杂，AI 降噪功能可以在保证语音质量的前提下，识别并降低周围的稳态噪声和非稳态噪声，提高语音质量和体验。

调用时机

该方法在加入频道前后均可调用。

参数

参数名描述
enabled

是否开启 AI 降噪功能：

  • true：开启 AI 降噪功能。
  • false：（默认）关闭 AI 降噪功能。
mode

降噪模式，详见 AudioAinsMode。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setAudioEffectParameters

设置 SDK 预设人声音效的参数。

TypeScript
abstract setAudioEffectParameters(preset: AudioEffectPreset, param1: number, param2: number): number;

调用该方法可以对本地发流用户进行如下设置：

  • 3D 人声音效：设置 3D 人声音效的环绕周期。
  • 电音音效：设置电音音效的基础调式和主音音高。为方便用户自行调节电音音效，建议你将基础调式和主音音高配置选项与应用的 UI 元素绑定。

设置后，频道内所有用户都能听到该效果。为获取更好的人声效果，建议你在调用该方法前进行以下操作：

  • 调用 setAudioScenario 将音频场景设为高音质场景，即 AudioScenarioGameStreaming(3)。
  • 调用 setAudioProfile 将 profile 设为 AudioProfileMusicHighQuality(4) 或 AudioProfileMusicHighQualityStereo(5)。

注：

参数

参数名描述
preset

SDK 预设的音效，支持以下设置：

  • RoomAcoustics3dVoice，3D 人声音效。

    • 你需要在使用该枚举前将 setAudioProfile 的 profile 参数设置 为 AudioProfileMusicStandardStereo(3) 或 AudioProfileMusicHighQualityStereo(5)，否则该枚举设置无效。
    • 启用 3D 人声后，用户需要使用支持双声道的音频播放设备才能听到预期效果。

  • PitchCorrection，电音音效。

param1

  • 如果 preset 设为 RoomAcoustics3dVoice，则 param1 表示 3D 人声音效的环绕周期。取值范围为 [1,60]，单位为秒。默认值为 10，表示人声会 10 秒环绕 360 度。

  • 如果 preset 设为 PitchCorrection，则 param1 表示电音音效的基础调式：

    • 1: （默认）自然大调。
    • 2: 自然小调。
    • 3: 和风小调。
param2

  • 如果 preset 设为 RoomAcoustics3dVoice，你需要将 param2 设置为 0。

  • 如果 preset 设为 PitchCorrection，则 param2 表示电音音效的主音音高：

    • 1: A
    • 2: A#
    • 3: B
    • 4: (Default) C
    • 5: C#
    • 6: D
    • 7: D#
    • 8: E
    • 9: F
    • 10: F#
    • 11: G
    • 12: G#
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setAudioEffectPreset

设置 SDK 预设的人声音效。

TypeScript
abstract setAudioEffectPreset(preset: AudioEffectPreset): number;

调用该方法可以为本地发流用户设置 SDK 预设的人声音效，且不会改变原声的性别特征。设置音效后，频道内所有用户都能听到该效果。

注：

调用时机

加入频道前后均可调用。 为获取更好的人声效果，建议你在调用该方法前进行以下操作：

  • 调用 setAudioScenario 将音频场景设为高音质场景，即 AudioScenarioGameStreaming(3)。
  • 调用 setAudioProfile 将 profile 设为 AudioProfileMusicHighQuality(4) 或 AudioProfileMusicHighQualityStereo(5)。

参数

参数名描述
preset

预设的音效选项，详见 AudioEffectPreset。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setLocalVoiceEqualization

设置本地语音音效均衡。

TypeScript
abstract setLocalVoiceEqualization(
    bandFrequency: AudioEqualizationBandFrequency,
    bandGain: number
  ): number;

调用时机

加入频道前后均可调用。

参数

参数名描述
bandFrequency

频谱子带索引。取值范围是 [0,9]，分别代表音效的 10 个频带。对应的中心频率为 [31，62，125，250，500，1k，2k，4k，8k，16k] Hz。详见 AudioEqualizationBandFrequency 。

bandGain

每个 band 的增益，单位是 dB，每一个值的范围是 [-15,15]，默认值为 0。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setLocalVoiceFormant

设置共振峰比率以改变语音的音色。

TypeScript
abstract setLocalVoiceFormant(formantRatio: number): number;

共振峰比率是影响声音音色的一个参数，共振峰比率取值越小声音会更低沉，取值越大声音会更尖锐。设置共振峰比率后，频道内所有用户都能听到该效果。如果你想要在调整音色的同时改变音调，声网推荐你搭配 setLocalVoicePitch 一起使用。

适用场景

在语音直播、语聊房、K 歌房等场景中，你可以调用该方法设置本地语音的共振峰比率参数从而改变音色效果。

调用时机

加入频道前后均可调用。

参数

参数名描述
formantRatio

共振峰比率，取值范围为 [-1.0，1.0]。默认值为 0.0，即不改变原声的音色。

注： 声网推荐的取值范围为 [-0.4，0.6] ，超出此范围外音效听感可能不佳。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setLocalVoicePitch

设置本地语音音调。

TypeScript
abstract setLocalVoicePitch(pitch: number): number;

调用时机

加入频道前后均可调用。

参数

参数名描述
pitch

语音频率。可以 [0.5,2.0] 范围内设置。取值越小，则音调越低。默认值为 1.0，表示不需要修改音调。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setLocalVoiceReverb

设置本地音效混响。

TypeScript
abstract setLocalVoiceReverb(
    reverbKey: AudioReverbType,
    value: number
  ): number;

SDK 提供一个使用更为简便的方法 setAudioEffectPreset，直接实现流行、R&B、KTV 等预置的混响效果。

注： 该方法在加入频道前后都能调用。

参数

参数名描述
reverbKey

混响音效 Key。该方法共有 5 个混响音效 Key，详见 AudioReverbType。

value

各混响音效 Key 所对应的值。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setVoiceBeautifierParameters

设置预设美声效果的参数。

TypeScript
abstract setVoiceBeautifierParameters(preset: VoiceBeautifierPreset, param1: number, param2: number): number;

调用该方法可以设置歌唱美声效果的性别特征和混响效果。该方法对本地发流用户进行设置。设置后，频道内所有用户都能听到该效果。 为获取更好的人声效果，建议你在调用该方法前进行以下操作：

  • 调用 setAudioScenario 将音频场景设为高音质场景，即 AudioScenarioGameStreaming(3)。
  • 调用 setAudioProfile 将 profile 设为 AudioProfileMusicHighQuality(4) 或 AudioProfileMusicHighQualityStereo(5)。

注：

参数

参数名描述
preset

预设的音效：

  • SINGING_BEAUTIFIER: 歌唱美声。
param1

歌声的性别特征：

  • 1: 男声。
  • 2: 女声。
param2

歌声的混响效果：

  • 1: 歌声在小房间的混响效果。
  • 2: 歌声在大房间的混响效果。
  • 3: 歌声在大厅的混响效果。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setVoiceBeautifierPreset

设置预设的美声效果。

TypeScript
abstract setVoiceBeautifierPreset(preset: VoiceBeautifierPreset): number;

调用该方法可以为本地发流用户设置预设的人声美化效果。设置美声效果后，频道内所有用户都能听到该效果。根据不同的场景，你可以为用户设置不同的美声效果。

注：

调用时机

加入频道前后均可调用。 为获取更好的人声效果，建议你在调用该方法前进行以下操作：

  • 调用 setAudioScenario 将音频场景设为高音质场景，即 AudioScenarioGameStreaming(3)。
  • 调用 setAudioProfile 将 profile 设为 AudioProfileMusicHighQuality(4) 或 AudioProfileMusicHighQualityStereo(5)。

参数

参数名描述
preset

预设的美声效果选项，详见 VoiceBeautifierPreset。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

setVoiceConversionPreset

设置预设的变声效果。

TypeScript
abstract setVoiceConversionPreset(preset: VoiceConversionPreset): number;

调用该方法可以为本地发流用户设置 SDK 预设的变声效果。设置变声效果后，频道内所有用户都能听到该效果。根据不同的场景，你可以为用户设置不同的变声效果。

注：

调用时机

加入频道前后均可调用。 为获取更好的人声效果，建议你在调用该方法前进行以下操作：

  • 调用 setAudioScenario 将音频场景设为高音质场景，即 AudioScenarioGameStreaming(3)。
  • 调用 setAudioProfile 将 profile 设为 AudioProfileMusicHighQuality(4) 或 AudioProfileMusicHighQualityStereo(5)。

参数

参数名描述
preset

预设的变声效果选项: VoiceConversionPreset。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0：方法调用成功。
  • < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利