tencent cloud

リアルタイムなサウンドイコライザ
PDFファイルをダウンロード
最終更新日:2024-01-18 15:47:47
リアルタイムなサウンドイコライザ
最終更新日: 2024-01-18 15:47:47
PDFファイルをダウンロード
開発者がTencent Cloud GME製品のAPIを容易にデバッグして導入するために、このドキュメントではGMEリアルタイムなサウンドイコライザの導入を紹介します。




シナリオ

GMEイコライザ機能は、GME SDKで収集したオーディオストリームをリアルタイムでイコライザ調整することができます。この機能はオンラインのカラオケシーンに使用されます。プレイヤーが歌い始めた後、GME SDKのイコライザインターフェースを呼び出して、プレイヤーのリアルタイムの音声ストリームに対し音の美化効果を調整することができます。

前提条件

リアルタイムボイスサービスを有効にしました：サービス有効化ガイドをご参照ください。
GME SDK導入済み：コアインターフェースとリアルタイム音声インターフェースの導入が含まれます。詳細については、Native SDKのクイック導入、Unity SDKクイック導入、Unreal SDKクイック導入をご参照ください。

Demo体験

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)
パラメータ
タイプ
意味
pEqualizer
ITMG_VOICE_TYPE_EQUALIZER
帯域利得
pReverb
ITMG_VOICE_TYPE_REVERB
HARMONICとREVERBを含む

構造体の詳細

ITMG_VOICE_TYPE_EQUALIZERの構造体メンバーはfloatタイプで、数値の範囲は-12から12です。
ITMG_VOICE_TYPE_EQUALIZER
意味
EQUALIZER_32HZ
32HZ帯域に加えた利得
EQUALIZER_64HZ
64HZ帯域に加えた利得
EQUALIZER_128HZ
128HZ帯域に加えた利得
EQUALIZER_250HZ
250HZ帯域に加えた利得
EQUALIZER_500HZ
500HZ帯域に加えた利得
EQUALIZER_1KHZ
1KHZ帯域に加えた利得
EQUALIZER_2KHZ
2KHZ帯域に加えた利得
EQUALIZER_4KHZ
4KHZ帯域に加えた利得
EQUALIZER_8KHZ
8KHZ帯域に加えた利得
EQUALIZER_16KHZ
16KHZ帯域に加えた利得
EQUALIZER_MASTER_GAIN
全体的な音量
ITMG_VOICE_TYPE_REVERBの構造体メンバーはfloatタイプで、数値の範囲は0~1です。
ITMG_VOICE_TYPE_REVERB
HARMONIC_GAIN
HARMONIC_START_FREQUENCY
HARMONIC_BASS_CONTROL
REVERB_SIZE
REVERB_DEPTH
REVERB_GAIN
REVERB_ECHO_DEPTH

サンプルコード

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オクターブに分けて調整することがよくあり、調律は大きく次のように分けられます。
帯域
領域
説明
20HZ - 32HZ
サブサウンドと超低音域
大部分の周波数帯は人の耳の聴覚の下限を下回って、触覚で感知することが多い。音楽の超大型パイプオルガンと映画の中の爆発と雷の効果音はこの周波数に達することができ、人の声はこの周波数帯に達することができません。一般的なVOIP通話はzの最低に調整し、直流の干渉を除去し、信号のエネルギーを他の周波数帯に残すことをお勧めします。
32HZ - 64HZ
重低音域
主にドラムとベースのダウンを調整するために使用され、音調が目立たないように感じられ、一部のバス音域はこの周波数帯に達することができます。VoIP通話の人の声の調律は一般的に低くし、周波数干渉を除去し、エネルギーを他の周波数帯に残すことをお勧めします。
64HZ - 125HZ
低音域
ほとんどの管弦楽器の基本周波数の範囲です。打楽器の強さも決定します。
125HZ - 250HZ
低音域
人の声の基本周波数の範囲です。人の声のトーンの知覚を決定します。重すぎると音が濁ることがあります。
250HZ - 500HZ
中低音域
人の声色の重要な低次高調波がある周波数帯を含み、男性の声の音色を調整するために使用され、これを適当に強化して人の声色を温かく、重厚になり、強めすぎて音が濁ります。
500HZ - 1KHZ
中音域
女声の音色を調整し、それをより豊かにします。高すぎると鼻音が重くなります。携帯電話などのモバイル再生機器のフォルマントはこの周波数帯にあり、調整が高すぎて構造振動雑音が発生しやすいことを避けることをお勧めします。
1KHZ - 2KHZ
中音域
人の耳の敏感な領域で、響きと臨場感に影響し、適切に増強することができます。
2KHZ - 4KHZ
中高音域
人の耳が最も敏感な領域で、この判断を高めることで音の響きを高め、音声の理解度の相関を高めることができ、調整が高すぎると歯音が重すぎることになます。
4KHZ - 8KHZ
高音域
チャイナシンバルなどの高周波楽器や弦楽器の摩擦音などの音の細かい部分を表現します。唇歯音、摩擦音など、人の声の高周波数のディテールを決定します。通常増強しないでください。
8KHZ - 16KHZ
超高音や超音波領域
楽器の高周波オーバトーンです。調整が音声にあまり影響しません。
調整の詳細については、次の図をご参照ください。



この記事はお役に立ちましたか？
営業担当者に お問い合わせ いただくか チケットを提出 してサポートを求めることができます。
はい
いいえ

フィードバック