最近更新时间：2023.09.02 22:09:04
首次发布时间：2023.03.16 11:40:11
在“预置音效”中我们提到可以通过 json 文件来创建音效，这些配置文件通常是由音效设计师组合各种音效 processor 得到的。某些场景下，也许我们仅仅需要某些特定的 processor，例如为了防止爆音，可以需要添加一个 Limiter。本文将介绍如何使用单个 processor。
目前在 sami core 中支持的 processor 如下表：
| SAMICoreIdentify | Name |
|---|---|
| SAMICoreIdentify_Processor_Gain | "Gain" |
| SAMICoreIdentify_Processor_Compressor | "Compressor" |
| SAMICoreIdentify_Processor_Chorus | "Chorus" |
| SAMICoreIdentify_Processor_Distortion | "Distortion" |
| SAMICoreIdentify_Processor_Echo | "Echo" |
| SAMICoreIdentify_Processor_Filter | "Filter" |
| SAMICoreIdentify_Processor_GainAndPan | "GainAndPan" |
| SAMICoreIdentify_Processor_Limiter | "Limiter" |
| SAMICoreIdentify_Processor_Reverb | "Reverb" |
| SAMICoreIdentify_Processor_Vibrato | "Vibrato" |
| SAMICoreIdentify_Processor_TimeDomainPitchShifter | "TimeDomainPitchShifter" |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Gain dB" | "Float" | [-70.0, 35.0] | 0 | 增益（dB） |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Threshold dB" | "Float" | [-70.0, 0.0] | 0 | 压缩比（比率） |
| 2 | "Ratio" | "Float" | [1.0, 40.0] | 1 | 阈值（dB） |
| 3 | "Knee dB" | "Float" | [0.0, 70.0] | 6 | 拐点调节（dB） |
| 4 | "Attack" | "Float" | [0.004999999888241291, 250.0] | 0.25 | 启动时间（ms） |
| 5 | "Release" | "Float" | [1.0, 2500.0] | 100 | 释放时间（ms） |
| 6 | "Auto Makeup Gain" | "Bool" | [false, true] | true | 是否开启自动补偿增益 |
| 7 | "Output Gain dB" | "Float" | [-35.0, 35.0] | 0 | 补偿增益（dB） |
| 8 | "Lookahead" | "Float" | [0.0, 10.0] | 0 | 提前探测时间（ms） |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Delay" | "Float" | [0.5, 20.0] | 4 | 延迟 (ms) |
| 2 | "Rate" | "Float" | [0.0, 4.0] | 1 | 速率 |
| 3 | "Depth" | "Float" | [0.0, 5.0] | 2 | 深度 |
| 4 | "Stereo Phase Offset" | "Float" | [0.0, 1.0] | 1 | 立体声相位偏移 |
| 5 | "Feedback" | "Float" | [0.0, 0.9599999785423279] | 0 | 反馈 |
| 6 | "Wetness" | "Float" | [0.0, 1.0] | 1 | 干湿比 |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Distortion Mode" | "Choice" | ["Cubic", "Tanh", "Arctan", "ArctanTanh", "L1", "L2", "HardClip", "DeadZone", "FoldBackTriangle", "FoldBackSine", "FoldBackSinArctan", "BitCrush", "Decimate"] | "Cubic" | 失真模式 |
| 2 | "Distortion Amount" | "Float" | [0.0, 1.0] | 0 | 失真量 |
| 3 | "Apply Upsampling" | "Choice" | ["None", "X8", "X16", "X32"] | "None" | 应用上采样 |
| 4 | "Wetness" | "Float" | [0.0, 1.0] | 1 | 干湿比 |
| 5 | "Post Distortion Gain" | "Float" | [-40.0, 0.0] | 0 | 后失真增益 |
| index | name | type | range | default | |
|---|---|---|---|---|---|
| 0 | "Dry Bypass" | "Bool" | [false, true] | false | 干声是否绕过，true即不带干声 |
| 1 | "Dry Gain dB" | "Float" | [-35.0, 6.0] | 0 | 干声增益 |
| 2 | "Dry Pan" | "Float" | [-1.0, 1.0] | 0 | 干声声像平移 |
| 3 | "Tap 1 Bypass" | "Bool" | [false, true] | false | 是否绕过，true即不带“回声1” |
| 4 | "Tap 1 Delay Time Synced" | "Choice" | ["32nd Note Triplet", "32nd Note", "32nd Note Dotted", "16th Note Triplet", "16th Note", "16th Note Dotted", "8th Note Triplet", "8th Note", "8th Note Dotted", "Quarter Note Triplet", "Quarter Note", "Quarter Note Dotted", "Half Note Triplet", "Half Note", "Half Note Dotted", "Whole Note"] | "Quarter Note" | 回声1：同步模式下延时 |
| 5 | "Tap 1 Delay Time Unsynced" | "Float" | [0.005000000353902578, 5.0] | 0.005000000353902578 | 回声1：非同步模式下延时 |
| 6 | "Tap 1 Feedback" | "Float" | [0.0, 1.0] | 0.4000000059604645 | 回声1反馈 |
| 7 | "Tap 1 Gain dB" | "Float" | [-35.0, 6.0] | -15 | 回声1增益 |
| 8 | "Tap 1 Pan" | "Float" | [-1.0, 1.0] | -1 | 回声1声像平移 |
| 9 | "Tap 1 Sync" | "Bool" | [false, true] | true | 回声1同步 |
| 10 | "Tap 2 Bypass" | "Bool" | [false, true] | false | 是否绕过，true即不带回声2 |
| 11 | "Tap 2 Delay Time Synced" | "Choice" | ["32nd Note Triplet", "32nd Note", "32nd Note Dotted", "16th Note Triplet", "16th Note", "16th Note Dotted", "8th Note Triplet", "8th Note", "8th Note Dotted", "Quarter Note Triplet", "Quarter Note", "Quarter Note Dotted", "Half Note Triplet", "Half Note", "Half Note Dotted", "Whole Note"] | "8th Note Dotted" | 回声1：同步模式下延时 |
| 12 | "Tap 2 Delay Time Unsynced" | "Float" | [0.005000000353902578, 5.0] | 0.005000000353902578 | 回声1：非同步模式下延时 |
| 13 | "Tap 2 Feedback" | "Float" | [0.0, 1.0] | 0.4000000059604645 | 回声1反馈 |
| 14 | "Tap 2 Gain dB" | "Float" | [-35.0, 6.0] | -15 | 回声1增益 |
| 15 | "Tap 2 Pan" | "Float" | [-1.0, 1.0] | 1 | 回声1声像平移 |
| 16 | "Tap 2 Sync" | "Bool" | [false, true] | true | 回声1同步 |
| 17 | "HPF Is Active" | "Bool" | [false, true] | false | 高通滤波生效 |
| 18 | "HPF Frequency" | "Float" | [20.0, 20000.0] | 20 | 高通滤波频率 |
| 19 | "HPF Resonance" | "Float" | [0.10000000149011612, 20.0] | 1 | 高通滤波共振 |
| 20 | "LPF Is Active" | "Bool" | [false, true] | false | 低通滤波生效 |
| 21 | "LPF Frequency" | "Float" | [20.0, 20000.0] | 20000 | 低通滤波频率 |
| 22 | "LPF Resonance" | "Float" | [0.10000000149011612, 20.0] | 1 | 低通滤波共振 |
| index | name | type | range | default | |
|---|---|---|---|---|---|
| 0 | "Filter Mode" | "Choice" | ["LowPass", "HighPass", "BandPass", "NormalisedBandPass", "Bell", "HighShelf", "LowShelf", "AllPass", "Notch", "Morph"] | "LowPass" | 模式 |
| 1 | "Cutoff Freq" | "Float" | [20.0, 20000.0] | 1000 | 截止频率 |
| 2 | "Resonance" | "Float" | [0.10000000149011612, 20.0] | 1 | 共振 |
| 3 | "Gain dB" | "Float" | [-20.0, 20.0] | 0 | 增益（dB） |
| 4 | "Morph" | "Float" | [-1.0, 1.0] | 0 | 变形 |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Gain dB" | "Float" | [-70.0, 35.0] | 0 | 增益（dB） |
| 1 | "Pan" | "Float" | [-1.0, 1.0] | 0 | 平移 |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Input Gain dB" | "Float" | [0.0, 24.0] | 0 | 输入增益（dB） |
| 2 | "Ceiling dB" | "Float" | [-24.0, 0.0] | -0.30000001192092896 | 输出上限（dB） |
| 3 | "Release" | "Float" | [1.0, 3000.0] | 500 | 释放时间（ms） |
| 4 | "Lookahead" | "Float" | [0.0, 10.0] | 0 | 提前探测的时间（ms） |
| 5 | "Audition Unity Gain" | "Bool" | [false, true] | false | 统一输出增益 |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Decay Time" | "Float" | [0.5, 16.0] | 3 | 混响时间（ms） |
| 2 | "Damp" | "Float" | [0.0, 1.0] | 0.5 | 阻尼 |
| 3 | "Mod Depth" | "Float" | [0.0, 1.0] | 0 | 调制深度 |
| 4 | "Mod Rate" | "Float" | [0.009999999776482582, 7.5] | 0 | 调制率 |
| 5 | "Wet Gain" | "Float" | [-36.0, 12.0] | 0 | 湿信号增益（db） |
| 6 | "Wet Stereo Width" | "Float" | [0.0, 2.0] | 1 | 湿信号立体声宽度 |
| 7 | "Wet Mix" | "Float" | [0.0, 1.0] | 0.5 | 干湿比 |
| 8 | "Wet LP Bypass" | "Bool" | [false, true] | true | 湿信号低通滤波是否绕过 |
| 9 | "Wet HP Bypass" | "Bool" | [false, true] | true | 湿信号高通滤波是否绕过 |
| 10 | "Wet LP Freq" | "Float" | [20.0, 20000.0] | 20000 | 湿信号低通滤波频率 |
| 11 | "Wet HP Freq" | "Float" | [20.0, 20000.0] | 20 | 湿信号高通滤波频率 |
| 12 | "Wet LP Res" | "Float" | [0.10000000149011612, 20.0] | 1 | 湿信号低通滤波共振 |
| 13 | "Wet HP Res" | "Float" | [0.10000000149011612, 20.0] | 1 | 湿信号高通滤波共振 |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Rate Hz" | "Float" | [1.0, 8.0] | 4 | 频率（hz） |
| 2 | "Depth Semitone" | "Float" | [0.0, 2.0] | 0.5 | 颤音范围，单位半音程 |
| 3 | "Wetness" | "Float" | [0.0, 1.0] | 1 | 干湿比 |
| index | name | type | range | default | description |
|---|---|---|---|---|---|
| 0 | "Bypass" | "Bool" | [false, true] | false | 是否绕过 |
| 1 | "Pitch Ratio" | "Float" | [0.25, 4.0] | 1 | 频率增加的倍数，具体计算可见 https://www.inspiredacoustics.com/en/MIDI_note_numbers_and_center_frequencies |
| 2 | "Interpolation Mode" | "Choice" | ["Linear", "Lagrange4", "Lagrange16", "Lagrange24", "Sinc32", "Lanczos32"] | "Lagrange4" | 插值模式 |
| 3 | "Mono Input" | "Bool" | [false, true] | true | 是否单通道输入 |
| 4 | "Mode" | "Choice" | ["Fastest", "Moderate", "HighQuality", "UltraHighQuality"] | "Moderate" | 质量模式 |
| 支持格式 | |
|---|---|
| 采样率 | 44100/48000 |
| 通道数 | 1ch/2ch |
| 数据格式 | Planar-Float |
| 支持流式 | 支持 |
| 支持realtime-safe更新参数 | 支持 |
音频处理与变声能力集需要使用离线功能授权，在调用具体接口之前需要先申请appkey和token；
具体授权的细节见 授权介绍