DSP 内核

在音频回调之外完成准备

使用 prepare() 根据宿主提供的采样率和最大块大小配置系数，并预分配所需存储空间。

Rust
1impl AudioKernel for DelayKernel {2    fn prepare(&mut self, context: PrepareContext) {3        self.sample_rate = context.sample_rate;4        self.delay_line.resize(context.max_block_size * 8, 0.0);5        self.write = 0;6    }78    fn reset(&mut self) {9        self.delay_line.fill(0.0);10        self.write = 0;11    }1213    fn process(&mut self, context: &mut ProcessContext<'_>) -> ProcessResult {14        // 这里只能进行有界读写、计算和预分配状态访问。15        ProcessResult::Continue16    }17}

resize 必须在 prepare 中完成，绝不能出现在 process 中。

访问音频缓冲区

ProcessContext 为当前音频块提供不持有所有权的输入和输出声道。代码必须处理输入、输出声道数不同的情况，并清零所有没有写入的输出声道。

如果整个输出确定为静音，返回 ProcessResult::Silence；否则返回 Continue。

事件与播放状态

处理上下文包含按采样偏移排序的参数事件和音符事件，以及当前播放状态的快照。乐器应在准确的采样位置处理 NoteOn、NoteOff、压力、弯音和表情事件；效果器可以直接读取速度与工程位置，无需在音频回调中再次查询宿主。

密集事件按每批最多 512 个处理，剩余事件不会因缓存满而丢弃。同一个宿主音频块可能触发多次内核调用，事件偏移相对于本次调用的音频区间。若同一采样点仍有待派发事件，Vesty 会先传入零帧 context，再生成该采样点的音频。即使 audio().frames() == 0，也必须消费其中的事件，只跳过音频生成。此约定同时适用于 process 和 process_f64，MIDI synth 示例已展示相应处理方式。

批次缓存预先分配，超量块需要额外扫描宿主事件列表，因此内存保持有界，但 CPU 开销仍随事件量增长。移除事件数量上限并不代表可以忽略音频回调的执行时限。

音符标识、MIDI 映射、载荷限制和渲染时间线参见 MIDI 与事件时序。

双精度

默认处理路径使用 f32。只有算法确实受益时，才启用原生 f64 处理：

Rust
1impl AudioKernel for MasteringKernel {2    const SUPPORTS_F64: bool = true;34    fn process(&mut self, context: &mut ProcessContext<'_>) -> ProcessResult {5        ProcessResult::Continue6    }78    fn process_f64(&mut self, context: &mut ProcessContext64<'_>) -> ProcessResult {9        ProcessResult::Continue10    }11}

未启用原生 f64 时，如果宿主请求 64 位缓冲区，Vesty 会使用预分配的临时缓冲区完成 f64 与 f32 之间的转换。

测试

先在不依赖 DAW 的情况下独立测试音频内核，再运行适配层的自动化、总线、事件、静音标记和容量测试。发布前仍然需要在真实宿主中完成冒烟测试。