音頻效果直接決定了智能設(shè)備的用戶體驗(yàn)，而EQ（均衡器）和DRC（動(dòng)態(tài)范圍控制）是音頻調(diào)試中最核心的兩個(gè)環(huán)節(jié)。瑞芯微（Rockchip）為全系列芯片提供了原生的EQ/DRC音頻處理模塊，支持全局流綁定和動(dòng)態(tài)應(yīng)用兩種模式，配合官方調(diào)試工具可快速實(shí)現(xiàn)個(gè)性化音效調(diào)校。

本文基于瑞芯微官方《Android EQ/DRC開(kāi)發(fā)指南V1.1.0》，結(jié)合實(shí)際開(kāi)發(fā)經(jīng)驗(yàn)，從編譯集成、音效啟用、狀態(tài)驗(yàn)證、參數(shù)調(diào)試四個(gè)維度，手把手教你完成RK平臺(tái)Android系統(tǒng)的音頻EQ/DRC全流程調(diào)試，適用于RK3588、RK3576等全系列芯片及所有Android內(nèi)核版本。

整體調(diào)試全流程總覽

先通過(guò)一張總覽圖快速了解完整調(diào)試路徑，避免走彎路：

一、編譯：開(kāi)啟EQ/DRC模塊編譯開(kāi)關(guān)

在使用EQ/DRC功能前，首先需要在系統(tǒng)編譯階段開(kāi)啟對(duì)應(yīng)的模塊，確保硬件抽象層（HAL）的音效庫(kù)被正確編譯進(jìn)固件。

編譯集成流程圖

1.1定位項(xiàng)目BoardConfig.mk文件

BoardConfig.mk的位置與你選擇的芯片型號(hào)和產(chǎn)品配置強(qiáng)相關(guān)，可通過(guò)以下命令快速確認(rèn)：

# 進(jìn)入Android源碼根目錄后執(zhí)行echo$TARGET_PRODUCT

例如，若輸出為rk3588_u，則對(duì)應(yīng)的BoardConfig.mk路徑為：

device/rockchip/rk3588/rk3588_u/BoardConfig.mk

1.2添加編譯開(kāi)關(guān)

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

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

添加完成后，重新編譯系統(tǒng)固件，編譯系統(tǒng)會(huì)自動(dòng)編譯hardware/rockchip/audio/eqdrc目錄下的源碼，生成librkeqdrc.so音效庫(kù)。

二、啟用：兩種綁定方式適配不同場(chǎng)景

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

音效啟用流程圖

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

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

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

在標(biāo)簽內(nèi)添加音效庫(kù)聲明：

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

在標(biāo)簽內(nèi)添加音效實(shí)例聲明：

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

注意：上述UUID是瑞芯微EQ/DRC音效的固定標(biāo)識(shí)，不可修改，否則系統(tǒng)無(wú)法識(shí)別該音效。

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

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

適用于需要對(duì)某一類音頻流全局生效的場(chǎng)景，例如所有音樂(lè)播放、通話語(yǔ)音都自動(dòng)應(yīng)用EQ/DRC效果。

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

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

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

方式二：應(yīng)用層動(dòng)態(tài)綁定

適用于僅需要在特定應(yīng)用或特定音頻流中生效的場(chǎng)景，例如某個(gè)視頻播放器單獨(dú)使用自定義EQ效果。

在Android應(yīng)用代碼中，通過(guò)RockchipEqualizer類動(dòng)態(tài)綁定到MediaPlayer或AudioTrack的音頻會(huì)話：

importandroid.media.MediaPlayer;importandroid.media.audiofx.RockchipEqualizer;// 創(chuàng)建MediaPlayer實(shí)例MediaPlayermediaPlayer=newMediaPlayer();// 綁定EQ/DRC到當(dāng)前音頻會(huì)話，第一個(gè)參數(shù)為優(yōu)先級(jí)（0為默認(rèn)）RockchipEqualizerequalizer=newRockchipEqualizer(0, mediaPlayer.getAudioSessionId());// 啟用EQ/DRC效果equalizer.setEnabled(true);

提示：如果已經(jīng)通過(guò)Stream HAL方式全局綁定了EQ/DRC，應(yīng)用層再創(chuàng)建的RockchipEqualizer實(shí)例將作為參數(shù)調(diào)整通道，不會(huì)重復(fù)創(chuàng)建音效處理實(shí)例。

三、驗(yàn)證：確保音效正常注冊(cè)與綁定

配置完成后，必須通過(guò)系統(tǒng)命令驗(yàn)證音效是否正常工作，避免后續(xù)調(diào)參無(wú)效。

音效驗(yàn)證流程圖

3.1驗(yàn)證音效注冊(cè)狀態(tài)

確認(rèn)EQ/DRC音效庫(kù)已成功加載到AudioFlinger服務(wù)中：

adbshell dumpsys media.audio_flinger

在輸出結(jié)果中查找以下內(nèi)容，說(shuō)明音效已成功注冊(cè)：

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驗(yàn)證音效綁定狀態(tài)

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

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，說(shuō)明EQ/DRC音效已成功綁定并啟用。

四、調(diào)參：兩種方式實(shí)現(xiàn)精準(zhǔn)音效調(diào)校

音效啟用后，最關(guān)鍵的步驟是參數(shù)調(diào)試。瑞芯微提供了自定義App調(diào)參和PC工具調(diào)參兩種方式，其中PC工具調(diào)參效率更高，適合開(kāi)發(fā)階段快速迭代。

PC工具調(diào)參流程圖（推薦）

App調(diào)參流程圖

4.1參數(shù)文件基礎(chǔ)

4.1.1默認(rèn)參數(shù)文件

系統(tǒng)默認(rèn)提供以下參數(shù)文件，按采樣率和通道數(shù)區(qū)分：

?rkaudio_effect_eqdrc_44100hz_2ch.bin（44.1kHz雙聲道）

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

同時(shí)內(nèi)置了4種預(yù)設(shè)參數(shù)：

?1：standard（標(biāo)準(zhǔn)模式）

?2：meeting（會(huì)議模式）

?3：classical（古典模式）

?4：classroom（教室模式）

4.1.2參數(shù)文件加載優(yōu)先級(jí)

EQ/DRC模塊創(chuàng)建時(shí)會(huì)按以下順序加載參數(shù)文件：

1./data/vendor/audio/（App下發(fā)的自定義參數(shù)，優(yōu)先級(jí)最高）

2./vendor/etc/（出廠默認(rèn)參數(shù)，PC工具push的參數(shù)會(huì)保存到這里）

3.hardware/rockchip/audio/eqdrc/configs/（SDK源碼中的默認(rèn)參數(shù)）

4.2方式一：PC工具調(diào)參（推薦）

PC工具調(diào)參支持實(shí)時(shí)修改參數(shù)并立即生效，無(wú)需重新編譯固件，是開(kāi)發(fā)階段的首選方式。

4.2.1準(zhǔn)備工作

1.確保設(shè)備固件為userdebug版本，且已開(kāi)啟adb調(diào)試

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

3.執(zhí)行以下adb命令獲取設(shè)備權(quán)限：

adbrootadb remountadb shell setenforce0# 臨時(shí)關(guān)閉SELinux，避免push失敗

4.2.2調(diào)參步驟

1.配置基礎(chǔ)參數(shù)：打開(kāi)工具后，設(shè)置SampleRate（采樣率）和NumChan（通道數(shù)），必須與設(shè)備音頻硬件配置一致?？赏ㄟ^(guò)以下文件查看硬件配置：

hardware/rockchip/audio/tinyalsa_hal/

找到pcm_config結(jié)構(gòu)體中的rate和channels字段。

2.拉取當(dāng)前參數(shù)（可選）：點(diǎn)擊pull按鈕，將設(shè)備當(dāng)前使用的參數(shù)文件保存到PC本地備份。

3.加載參數(shù)文件：點(diǎn)擊load按鈕，選擇要調(diào)試的參數(shù)文件（如默認(rèn)的48kHz雙聲道參數(shù)）。

4.實(shí)時(shí)調(diào)試：在設(shè)備上播放音頻，調(diào)整工具中的EQ和DRC參數(shù)，調(diào)整完成后點(diǎn)擊push按鈕，參數(shù)會(huì)立即推送到設(shè)備并生效。

可通過(guò)logcat查看參數(shù)加載日志：adb logcat | grep eqdrc，看到reload profile from tuner說(shuō)明參數(shù)已重新加載。

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

4.3方式二：自定義App調(diào)參

如果需要在應(yīng)用中提供用戶可調(diào)節(jié)的音效功能，可通過(guò)RockchipEqualizer的API實(shí)現(xiàn)參數(shù)調(diào)整。

以下是核心代碼示例：

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

注意：只有在preset=0（自定義模式）下，才能手動(dòng)調(diào)整上述參數(shù)；切換到其他預(yù)設(shè)后，手動(dòng)調(diào)整的參數(shù)會(huì)被覆蓋。

五、常見(jiàn)問(wèn)題與注意事項(xiàng)

1.音效不生效：首先檢查BoardConfig.mk是否添加了編譯開(kāi)關(guān)，然后通過(guò)dumpsys命令確認(rèn)音效是否注冊(cè)和綁定成功。

2.PC工具push失敗：確保設(shè)備是userdebug版本，已執(zhí)行adb root和adb remount，且臨時(shí)關(guān)閉了SELinux。

3.參數(shù)調(diào)整后無(wú)變化：確認(rèn)采樣率和通道數(shù)設(shè)置與硬件一致，且正在播放的音頻流類型已綁定EQ/DRC。

4.多聲道支持：默認(rèn)參數(shù)文件為雙聲道，如需支持更多聲道，可通過(guò)PC工具生成對(duì)應(yīng)通道數(shù)的參數(shù)文件。

總結(jié)

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