Repository navigation
feat(播放): Exo 音频平衡(响度 AGC) - #97
Merged
Merged
Conversation
Integrate AGC-style loudness balance into the Exo PCM processor chain after DSP and before optional music SRC. Persist level in playback prefs with TV/WebUI controls and unit tests for core gain math. Co-authored-by: ModerRAS <adqewsx@gmail.com>
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars.
|
- lint MissingTranslation: values-zh-rTW / values-zh-rHK 补 10 条 audio balance 文案 - SettingsViewModelTokenTest: 严格 mock 补 audioBalanceLevel=OFF (构造器新增读取,7 例 MockKException) - docs/agents/pre-pr-checklist.md: 追加音频平衡 feature log(HK1 真机证据)
Owner
Author
真机验证(HK1)+ CI 修灯CI 红灯已修(已 push)
HK1 真机(debug APK,Exo 默认)
未覆盖(原因已记入 checklist feature log)
|
ModerRAS
marked this pull request as ready for review
November 2, 2026 14:39
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概述
为 MiruPlay 增加可选的 「音频平衡」(响度 AGC),减轻同一集内对白/BGM/音效忽大忽小的问题。实现参考 blbl 类产品思路(RMS 追踪 + 峰值限制),但接入现有 Exo DSP 管线而非独立粘贴。
设计
Exo PCM 处理器顺序
DefaultAudioSink内顺序(自解码器 toward AudioTrack):DspAudioProcessor— 现有 PEQ/FIR/下混/LinkedLimiterAudioBalanceAudioProcessor— 本 PR 新增,包装audio-dsp-core的LoudnessBalanceProcessorMusicSrcBypassProcessor(仅音乐 SRC=高质软 SRC 时)— Sonic 重采样到本机速率平衡放在 DSP 之后,避免 EQ/下混前的增益与 AGC 互相打架;放在 SRC 之前,对即将送入混音器的 PCM 做最终响度整理。
算法要点(
LoudnessBalanceProcessor)AudioDspRuntimeConfigrevision 热更新,onFlush重置状态档位语义
持久化键:
player_audio_balance_level(与 blbl 命名一致),默认 关。引擎支持
设置面
/api/settings/playback增加audioBalanceLevel字段,保存时同步AudioDspRuntimeConfig测试
本地已跑(通过):
:audio-dsp-core:test—LoudnessBalanceProcessorTest(静音、quiet boost、峰值限制、档位切换):data:testDebugUnitTest—PlaybackPreferencesManagerTest(持久化):player-core:testDebugUnitTest—MusicSrcBypassPipelineTest(含新处理器链路的组合回归):web-control-core:test—WebControlSettingsRouteTest(playback DTO 字段)手动验证(HK1 / 真机)
未做 / 后续