音頻效果直接決定了智能設備的用戶體驗，而EQ（均衡器）和DRC（動態范圍控制）是音頻調試中最核心的兩個環節。瑞芯微（Rockchip）為全系列芯片提供了原生的EQ/DRC音頻處理模塊，支持全局流綁定和動態應用兩種模式，配合官方調試工具可快速實現個性化音效調校。

本文基于瑞芯微官方《Android EQ/DRC開發指南V1.1.0》，結合實際開發經驗，從編譯集成、音效啟用、狀態驗證、參數調試四個維度，手把手教你完成RK平臺Android系統的音頻EQ/DRC全流程調試，適用于RK3588、RK3576等全系列芯片及所有Android內核版本。

整體調試全流程總覽

先通過一張總覽圖快速了解完整調試路徑，避免走彎路：

一、編譯：開啟EQ/DRC模塊編譯開關

在使用EQ/DRC功能前，首先需要在系統編譯階段開啟對應的模塊，確保硬件抽象層（HAL）的音效庫被正確編譯進固件。

編譯集成流程圖

1.1定位項目BoardConfig.mk文件

BoardConfig.mk的位置與你選擇的芯片型號和產品配置強相關，可通過以下命令快速確認：

# 進入Android源碼根目錄后執行echo$TARGET_PRODUCT

例如，若輸出為rk3588_u，則對應的BoardConfig.mk路徑為：

device/rockchip/rk3588/rk3588_u/BoardConfig.mk

1.2添加編譯開關

在上述BoardConfig.mk文件末尾添加以下配置，開啟EQ/DRC模塊編譯：

# 啟用Rockchip原生EQ/DRC音頻處理模塊BOARD_USE_AUDIO_EQDRC:=true

添加完成后，重新編譯系統固件，編譯系統會自動編譯hardware/rockchip/audio/eqdrc目錄下的源碼，生成librkeqdrc.so音效庫。

二、啟用：兩種綁定方式適配不同場景

編譯完成后，需要在系統中聲明并啟用EQ/DRC音效。瑞芯微提供了動態綁定和Stream HAL全局綁定兩種方式，可根據音效的應用范圍靈活選擇。

音效啟用流程圖

2.1第一步：全局聲明EQ/DRC音效

無論使用哪種綁定方式，都需要先在系統音效配置文件中聲明EQ/DRC音效。修改以下文件：

frameworks/av/media/libeffects/data/audio_effects.xml

在標簽內添加音效庫聲明：

<libraries>  <libraryname="rkeqdrc"path="librkeqdrc.so"/>libraries>

在標簽內添加音效實例聲明：

<effects>  <effectname="eqdrc"library="rkeqdrc"uuid="79fe72b2-4182-44c1-b2ea-0002a5d5c51b"/>effects>

注意：上述UUID是瑞芯微EQ/DRC音效的固定標識，不可修改，否則系統無法識別該音效。

2.2第二步：選擇音效綁定方式

方式一：Stream HAL全局綁定（推薦）

適用于需要對某一類音頻流全局生效的場景，例如所有音樂播放、通話語音都自動應用EQ/DRC效果。

在同一個audio_effects.xml文件中，找到或添加標簽，指定需要綁定的音頻流類型：

<postprocess>  <streamtype="music">   <applyeffect="eqdrc"/> stream>  <streamtype="voice_call">   <applyeffect="eqdrc"/> stream> postprocess>

目前支持綁定的所有音頻流類型如下：

方式二：應用層動態綁定

適用于僅需要在特定應用或特定音頻流中生效的場景，例如某個視頻播放器單獨使用自定義EQ效果。

在Android應用代碼中，通過RockchipEqualizer類動態綁定到MediaPlayer或AudioTrack的音頻會話：

importandroid.media.MediaPlayer;importandroid.media.audiofx.RockchipEqualizer;// 創建MediaPlayer實例MediaPlayermediaPlayer=newMediaPlayer();// 綁定EQ/DRC到當前音頻會話，第一個參數為優先級（0為默認）RockchipEqualizerequalizer=newRockchipEqualizer(0, mediaPlayer.getAudioSessionId());// 啟用EQ/DRC效果equalizer.setEnabled(true);

提示：如果已經通過Stream HAL方式全局綁定了EQ/DRC，應用層再創建的RockchipEqualizer實例將作為參數調整通道，不會重復創建音效處理實例。

三、驗證：確保音效正常注冊與綁定

配置完成后，必須通過系統命令驗證音效是否正常工作，避免后續調參無效。

音效驗證流程圖

3.1驗證音效注冊狀態

確認EQ/DRC音效庫已成功加載到AudioFlinger服務中：

adbshell dumpsys media.audio_flinger

在輸出結果中查找以下內容，說明音效已成功注冊：

Librariesloaded:path: /vendor/lib/soundfx/librkeqdrc.soEQDRC / Rockchip Electronics Co. Ltd.UUID:79fe72b2-4182-44c1-b2ea-0002a5d5c51bTYPE:34805d32-2e6d-4d1e-9296-0002a5d5c51bapiVersion:00020000flags:00820204

3.2驗證音效綁定狀態

先在設備上播放一段音頻（確保使用了綁定的流類型），然后再次執行上述dumpsys命令，查找以下內容：

Output thread 0xb40000784395ba60, name AudioOut_D, tid 642, type 0 (MIXER):I/O handle: 13Standby: no[...]1 Effect Chains1 effects for session 49[...]Effect ID 11:Session State Registered Enabled Suspended:00049 003 y y n[...]Descriptor:- UUID: 79fe72b2-4182-44c1-b2ea-0002a5d5c51b- TYPE: 34805d32-2e6d-4d1e-9296-0002a5d5c51b- name: EQ DRC- implementor: Rockchip Electronics Co. Ltd.

如果看到Registered: y和Enabled: y，說明EQ/DRC音效已成功綁定并啟用。

四、調參：兩種方式實現精準音效調校

音效啟用后，最關鍵的步驟是參數調試。瑞芯微提供了自定義App調參和PC工具調參兩種方式，其中PC工具調參效率更高，適合開發階段快速迭代。

PC工具調參流程圖（推薦）

App調參流程圖

4.1參數文件基礎

4.1.1默認參數文件

系統默認提供以下參數文件，按采樣率和通道數區分：

?rkaudio_effect_eqdrc_44100hz_2ch.bin（44.1kHz雙聲道）

?rkaudio_effect_eqdrc_48000hz_2ch.bin（48kHz雙聲道，最常用）

同時內置了4種預設參數：

?1：standard（標準模式）

?2：meeting（會議模式）

?3：classical（古典模式）

?4：classroom（教室模式）

4.1.2參數文件加載優先級

EQ/DRC模塊創建時會按以下順序加載參數文件：

1./data/vendor/audio/（App下發的自定義參數，優先級最高）

2./vendor/etc/（出廠默認參數，PC工具push的參數會保存到這里）

3.hardware/rockchip/audio/eqdrc/configs/（SDK源碼中的默認參數）

4.2方式一：PC工具調參（推薦）

PC工具調參支持實時修改參數并立即生效，無需重新編譯固件，是開發階段的首選方式。

4.2.1準備工作

1.確保設備固件為userdebug版本，且已開啟adb調試

2.工具位于SDK目錄：RKTools/windows/AudioEffect_Tool.rar，解壓后運行AudioEffect_tool.exe

3.執行以下adb命令獲取設備權限：

adbrootadb remountadb shell setenforce0# 臨時關閉SELinux，避免push失敗

4.2.2調參步驟

1.配置基礎參數：打開工具后，設置SampleRate（采樣率）和NumChan（通道數），必須與設備音頻硬件配置一致。可通過以下文件查看硬件配置：

hardware/rockchip/audio/tinyalsa_hal/

找到pcm_config結構體中的rate和channels字段。

2.拉取當前參數（可選）：點擊pull按鈕，將設備當前使用的參數文件保存到PC本地備份。

3.加載參數文件：點擊load按鈕，選擇要調試的參數文件（如默認的48kHz雙聲道參數）。

4.實時調試：在設備上播放音頻，調整工具中的EQ和DRC參數，調整完成后點擊push按鈕，參數會立即推送到設備并生效。

可通過logcat查看參數加載日志：adb logcat | grep eqdrc，看到reload profile from tuner說明參數已重新加載。

5.保存最終參數：效果滿意后，點擊save按鈕，將參數文件保存到SDK的hardware/rockchip/audio/eqdrc/configs/目錄，重新編譯固件即可固化參數。

4.3方式二：自定義App調參

如果需要在應用中提供用戶可調節的音效功能，可通過RockchipEqualizer的API實現參數調整。

以下是核心代碼示例：

// 獲取當前EQ/DRC配置RockchipEqualizer.Settingssettings=equalizer.getProperties();// 啟用10段EQsettings.setEq10Enabled(1);// 獲取所有聲道的EQ配置Collection<RockchipEqualizer.Settings.Eq> eqs=settings.getEqs();for(RockchipEqualizer.Settings.Eqeq : eqs) { // 獲取當前聲道的所有頻段 Collection<RockchipEqualizer.Settings.Eq.EqBand> bands=eq.getBands(); for(RockchipEqualizer.Settings.Eq.EqBandband : bands) {   // 設置頻段增益（單位：dB）    band.setBoost(3.0f);   // 設置濾波器類型：0=參數均衡，1=低架，2=高架，3=低通，4=高通    band.setFilter(0);   // 設置中心頻率（單位：Hz）    band.setFc(1000);   // 設置品質因數Q（參數均衡時范圍0.01-16，高低架時為斜率0.01-2）    band.setQ(1.0f);   // 啟用該頻段    band.setEnabled(1);  }}// 應用新配置equalizer.setProperties(settings);// 切換預設模式equalizer.usePreset(1);// 使用標準模式

注意：只有在preset=0（自定義模式）下，才能手動調整上述參數；切換到其他預設后，手動調整的參數會被覆蓋。

五、常見問題與注意事項

1.音效不生效：首先檢查BoardConfig.mk是否添加了編譯開關，然后通過dumpsys命令確認音效是否注冊和綁定成功。

2.PC工具push失敗：確保設備是userdebug版本，已執行adb root和adb remount，且臨時關閉了SELinux。

3.參數調整后無變化：確認采樣率和通道數設置與硬件一致，且正在播放的音頻流類型已綁定EQ/DRC。

4.多聲道支持：默認參數文件為雙聲道，如需支持更多聲道，可通過PC工具生成對應通道數的參數文件。

總結

瑞芯微RK平臺的EQ/DRC模塊提供了完整且易用的音頻處理解決方案，通過本文的步驟和流程圖，你可以快速完成從編譯集成到參數調試的全流程。在實際開發中，建議先通過PC工具快速調試出滿意的音效參數，再將參數固化到固件中；如果需要用戶自定義音效，可基于RockchipEqualizer API開發應用層調參功能。