Sladky Player
多线程音频输出与硬件 DSP
一款基于系统级 Rust 语言开发的便携式音频播放器。通过 WGPU API 实现 GUI 硬件加速渲染,底层音频输出基于跨平台 Cubeb 库,搭载 Symphonia 异步解码器,并配备完全可定制的 32 位浮点 DSP 运算管线。
架构技术规范一款基于系统级 Rust 语言开发的便携式音频播放器。通过 WGPU API 实现 GUI 硬件加速渲染,底层音频输出基于跨平台 Cubeb 库,搭载 Symphonia 异步解码器,并配备完全可定制的 32 位浮点 DSP 运算管线。
架构技术规范
音频信号处理完全在 32 位浮点立体声模式下运行。DSP 管线由一系列连续的独立模块组成,对原始采样执行精确的数学修正。
SignalCorrector 模块在环形缓冲区中执行通道延迟对齐(Time Alignment),精确度达到采样级,并负责极性相位反转和单声道混音。DynamicsPre 模块通过级联双二阶滤波器实现次声波过滤(Subsonic Filter,20Hz HPF,Linkwitz-Riley 4阶)和超声波过滤(22kHz LPF),并结合由 RMS 检测器驱动的自动增益控制(AGC,目标电平为 -16 dBFS)。
参数化 12 段均衡器在 16 Hz 至 16 kHz 的周波数范围内使用品质因数 Q=1.41 的稳定峰值滤波器。Goodizer 模块执行 3 频段信号分频(250 Hz 的低通交叉滤波器和 4000 Hz 的高通交叉滤波器),提供独立的压缩控制(可调的启动/释放时间比、阈值和压缩比)以及非线性饱和度(双曲正切波形整形,取决于选择的 A、B、C、D 模式)。
多组件引擎:次谐波共振器(100 Hz 低通)采用 ADAA(无混叠双重逼近)方法生成低频谐波,以完全消除数字混叠。Haas 差延迟器(800 Hz 高通,1.2 ms 延迟)用于拓宽立体声声场。ATR 模块使用快速和慢速包络检测器提取瞬态(6.5 kHz 频段),并动态强化其起始攻击相位。高频激励器在 11 kHz 以上进行多项式谐波合成(产生奇偶超高频谐波),并混合调制粉红噪声。
Hrtf3DVirtualizer 模块执行 Mid/Side 信号解构。Mid 通道通过峰值滤波器(3 kHz,Q=1.0)模拟耳道共振,并辅以陷波滤波器(6.5 kHz,Q=2.0)。声学距离通过早期反射(0.9 ms 延迟,-15.5 dB 电平)来模拟,以消除“头中定位”效应。Side 通道由 8 kHz 陷波滤波器进行修正。双耳交叉串扰由 ITD(0.28 ms 延迟,48 kHz 采样率下对应 13 个采样)进行延迟,并通过高架滤波器模拟头部声学阴影过滤(1.5 kHz 以上衰减 10 dB)。
// Lock-Free real-time audio pipeline on Cubeb SPSC ring buffers pub fn process_audio_callback( output_buffer: &mut [f32], cons_main: &mut Consumer<f32>, cons_amb: &mut Consumer<f32>, dsp: &mut DspProcessor, quick_dsp: &mut QuickDspState, settings: &SharedAudioSettings ) -> isize { let frames_requested = output_buffer.len() / 2; let mut amb_buffer = vec![0.0f32; output_buffer.len()]; let amb_popped = cons_amb.pop_slice(&mut amb_buffer); let popped = cons_main.pop_slice(output_buffer); let vol = settings.get_float(&settings.volume); let bal = settings.get_float(&settings.balance_lr); let pitch = settings.get_float(&settings.pitch); let reverb_wet = settings.get_float(&settings.reverb_wet); let reverb_room = settings.get_float(&settings.reverb_room); let crossfeed = settings.get_float(&settings.crossfeed); let l_gain = if bal > 0.0 { 1.0 - bal } else { 1.0 }; let r_gain = if bal < 0.0 { 1.0 + bal } else { 1.0 }; for i in (0..popped).step_by(2) { let mut l = output_buffer[i]; let mut r = output_buffer[i+1]; let (l_pt, r_pt) = quick_dsp.pitch_shifter.process(l, r, pitch); let (l_rev, r_rev) = quick_dsp.reverb.process(l_pt, r_pt, reverb_wet, reverb_room); let (l_cf, r_cf) = quick_dsp.crossfeed.process(l_rev, r_rev, crossfeed); let (proc_l, proc_r) = dsp.process_stereo(l_cf, r_cf); l = proc_l * l_gain; r = proc_r * r_gain; if i < amb_popped { l += amb_buffer[i]; r += amb_buffer[i+1]; } output_buffer[i] = l * vol; output_buffer[i+1] = r * vol; } frames_requested as isize }
// 3-Band Linkwitz-Riley Crossover with Envelope Tracked Compression impl Goodizer { pub fn process_frame(&mut self, mut l: f32, mut r: f32) -> (f32, f32) { if self.amount <= 0.0 { return (l, r); } let (dry_l, dry_r) = (l, r); // 1. Поканальный кроссовер (LPF на 250 Гц, HPF на 4000 Гц) let low_l = self.lpf_l.process(l); let low_r = self.lpf_r.process(r); let high_l = self.hpf_l.process(l); let high_r = self.hpf_r.process(r); let mid_l = l - low_l - high_l; let mid_r = r - low_r - high_r; // 2. Поканальная компрессия выделенных частотных диапазонов let comp_low_l = self.c_low_l.process(low_l); let comp_low_r = self.c_low_r.process(low_r); let comp_mid_l = self.c_mid_l.process(mid_l); let comp_mid_r = self.c_mid_r.process(mid_r); let comp_high_l = self.c_high_l.process(high_l); let comp_high_r = self.c_high_r.process(high_r); // 3. Рекомпозиция и смешивание обработанного сигнала с сухим let mix_l = comp_low_l + comp_mid_l + comp_high_l; let mix_r = comp_low_r + comp_mid_r + comp_high_r; ( dry_l * (1.0 - self.amount) + mix_l * self.amount, dry_r * (1.0 - self.amount) + mix_r * self.amount ) } }
// ADAA Non-Linear Waveshaping (Anti-Aliasing Double Approximation) fn ln_cosh(x: f32) -> f32 { let ax = x.abs(); if ax > 4.0 { ax - 0.69314718 } else { let x2 = x * x; x2 * (6.0 + x2) / (12.0 + 3.0 * x2) } } fn adaa_tanh(x: f32, x_prev: f32) -> f32 { let diff = x - x_prev; if diff.abs() < 1e-5 { x.tanh() } else { // Вычисление первой производной первообразной ln(cosh(x)) (ln_cosh(x) - ln_cosh(x_prev)) / diff } }
实时音频输出线程与 GUI 线程完全隔离。解码、重采样、沿可定制贝塞尔曲线执行的动态交叉渐变以及环境音效合成均在并行线程中执行,通过分配在堆上的无锁 SPSC(单生产者单消费者)环形缓冲区(Ring Buffer)交换音频数据。这保证了向系统声卡稳定输送音频数据包,完全避免了缓冲区下溢(Buffer Underrun)和播放卡顿的风险。
播放器编译为单个静态可执行文件,无任何外部运行时依赖。所有配置和 DSP 管线设置均在本地存储于 settings.json 中。通过 WGPU API 实现的图形硬件加速确保了界面的即时渲染,且 CPU 占用率极低。
tanh)生成次谐波时,不可避免地会产生混叠(Aliasing)——即寄生频率从奈奎斯特频率镜像反射回可听光谱,导致低音浑浊。ADAA(抗混叠双重逼近)算法通过对非线性函数进行数值积分来解决这一问题。通过计算信号原函数的导数,ADAA 几乎可以完全抑制光谱混叠,保持低音深邃且干净。music.db)包含关系关联表。播放列表通过父播放列表字段支持分级树状结构。当选择父播放列表时,播放器会执行递归 CTE 查询,该查询会自动向下遍历嵌套树,收集所有子播放列表的 ID,并返回一个完整的平面轨道列表,同时保留用户自定义的播放顺序。