参数

声明参数集合

#[derive(Params)] 会生成基于索引的参数句柄访问方式，因此音频处理期间不需要按字符串搜索参数。

Rust
1#[derive(Params)]2struct FilterParams {3    cutoff: FloatParam,4    resonance: FloatParam,5    bypass: BoolParam,6}78impl Default for FilterParams {9    fn default() -> Self {10        Self {11            cutoff: FloatParam::new("cutoff", "Cutoff", 20.0, 20_000.0, 1_000.0)12                .with_unit("Hz"),13            resonance: FloatParam::new("resonance", "Resonance", 0.1, 12.0, 0.7),14            bypass: BoolParam::new("bypass", "Bypass", false).with_bypass(true),15        }16    }17}

字符串 ID 是持久的工程契约。发布后不要随意改名，除非同时提供迁移策略。

只解析一次参数句柄

Rust
1fn create_kernel(&self, _init: KernelInit) -> FilterKernel {2    FilterKernel {3        cutoff: self.params.resolve_or_invalid("cutoff"),4        resonance: self.params.resolve_or_invalid("resonance"),5    }6}

无效句柄会安全地返回 None，不会让 panic 穿出宿主初始化流程。

采样级精确自动化

算法需要精确采样位置时，应读取 ProcessContext 中的参数事件。适配层会在第一个事件之前保留上一音频块的值，按采样偏移排列事件，并在整块处理完成后提交最终值。

对于不必逐采样更新的系数，可以把事件处理与预分配的平滑器结合起来，避免每个采样点都重新计算昂贵状态。

生成参数清单

Bash
1vesty param-manifest \2  --specs params.specs.json \3  --out vesty-parameters.json45vesty param-manifest \6  --specs params.specs.json \7  --out vesty-parameters.json \8  --check

参数清单应纳入 Git。打包时，Vesty 会把它复制到 VST3 插件包；严格验证还会确认清单与参数规格保持一致。