游戏多媒体引擎 实时语音均衡器

一、使用场景

GME 均衡器功能，可以将 GME SDK 采集的音频流实时进行均衡器调整。该功能可应用于线上K歌场景，玩家开始唱歌后，调用 GME SDK 的 均衡器 接口，即可将玩家的实时语音流做声音美化效果方面的调整。

二、前提条件

·已开通实时语音服务：可参见 服务开通指引。

·已接入 GME SDK：包括核心接口和实时语音接口的接入，详情可参见 Native SDK 快速接入、Unity SDK 快速接入、Unreal SDK 快速接入。

三、下载 Demo

下载地址 >>

此体验 Demo 为一个 Windows 可执行程序，界面如下：

四、配置参数

在 Appid 和 Key 的输入框中填入自己申请的 GME AppID 以及 Key。

如果需要，你也可以输入目标房间号以及 OpenID。

五、使用方法

1. 进房打开麦克风扬声器流程如下：Init > EnterRoom > EnableCapture > EnablePlay > EnableSend > EnableRecv。

2. 进房成功之后，可以开启 EnableLoopBack 听到自己的声音。

3. 后续再调整红框中的 EQ 均衡器（EQ 是频段增益，Exditor 和 Reverb 是混响器）。

六、均衡器功能接入

使用此接口需要在进房成功的状态下，才能对本端采集的声音实现均衡器调节效果。

七、函数原型

int SetKaraokeType(ITMG_VOICE_TYPE_EQUALIZER* pEqualizer, ITMG_VOICE_TYPE_REVERB* pReverb)

八、结构体详细信息

ITMG_VOICE_TYPE_EQUALIZER 中结构体成员为 float 类型，数值范围为-12到12。

ITMG_VOICE_TYPE_REVERB 中结构体成员为 float 类型，数值范围为0到 1。

九、示例代码

void CTMGSDK_For_AudioDlg::OnVScroll(UINT nSBCode, UINT nPos, CScrollBar* pScrollBar){ if ((CWnd*)pScrollBar == (CWnd*)&m_SliderEQ1 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ2 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ3 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ4 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ5 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ6 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ7 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ8 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ9 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ10 || (CWnd*)pScrollBar == (CWnd*)&m_SliderEQ11 || (CWnd*)pScrollBar == (CWnd*)&m_SliderExGain || (CWnd*)pScrollBar == (CWnd*)&m_SliderExStartFrequency || (CWnd*)pScrollBar == (CWnd*)&m_SliderExBaseCtrl || (CWnd*)pScrollBar == (CWnd*)&m_SliderReverbSize || (CWnd*)pScrollBar == (CWnd*)&m_SliderReverbDepth || (CWnd*)pScrollBar == (CWnd*)&m_SliderReverbGain || (CWnd*)pScrollBar == (CWnd*)&m_SliderReverbEchoDepth ) { ITMG_VOICE_TYPE_EQUALIZER equalizer = { (m_SliderEQ1.GetPos() – 50) * 24.0f / 100, (m_SliderEQ2.GetPos() – 50) * 24.0f / 100, (m_SliderEQ3.GetPos() – 50) * 24.0f / 100, (m_SliderEQ4.GetPos() – 50) * 24.0f / 100, (m_SliderEQ5.GetPos() – 50) * 24.0f / 100, (m_SliderEQ6.GetPos() – 50) * 24.0f / 100, (m_SliderEQ7.GetPos() – 50) * 24.0f / 100, (m_SliderEQ8.GetPos() – 50) * 24.0f / 100, (m_SliderEQ9.GetPos() – 50) * 24.0f / 100, (m_SliderEQ10.GetPos() – 50) * 24.0f / 100, (m_SliderEQ11.GetPos() – 50) * 24.0f / 100 }; ITMG_VOICE_TYPE_REVERB reverb = { (m_SliderExGain.GetPos()) * 1.0f / 100.0f, (m_SliderExStartFrequency.GetPos()) * 1.0f / 100.0f, (m_SliderExBaseCtrl.GetPos()) * 1.0f / 100.0f, (m_SliderReverbSize.GetPos()) * 1.0f / 100.0f, (m_SliderReverbDepth.GetPos()) * 1.0f / 100.0f, (m_SliderReverbGain.GetPos()) * 1.0f / 100.0f, (m_SliderReverbEchoDepth.GetPos()) * 1.0f / 100.0f }; m_pTmgContext->GetAudioEffectCtrl()->SetKaraokeType(&equalizer, &reverb); } CDialogEx::OnVScroll(nSBCode, nPos, pScrollBar);}

十、均衡器使用指引

注意：此处仅提供指引，如果需要更加深入的使用 EQ 效果，需要专业的调音师协作。

人耳可以听到的声音范围大致为20HZ – 20KHZ，人耳对于各频段的感知呈现对数关系，因此混音工程中常将人的可听频段分成10个八度分别进行调整，调音大致分为如下几个区域：

具体调整也可以参考下图：