单音效处理器介绍--音频技术-火山引擎

文档中心

导航

单音效处理器介绍

最近更新时间：2023.09.02 22:09:04首次发布时间：2023.03.16 11:40:11

简介

在“预置音效”中我们提到可以通过 json 文件来创建音效，这些配置文件通常是由音效设计师组合各种音效 processor 得到的。某些场景下，也许我们仅仅需要某些特定的 processor，例如为了防止爆音，可以需要添加一个 Limiter。本文将介绍如何使用单个 processor。

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"

参数介绍

增益（Gain）

index	name	type	range	default	description
0	"Gain dB"	"Float"	[-70.0, 35.0]	0	增益（dB）

动态压缩（Compressor）

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）

合唱（Chorus）

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	干湿比

失真（Distortion）

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	后失真增益

回声（Echo）

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	低通滤波共振

滤波器（Filter）

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	变形

增益和平移（GainAndPan）

index	name	type	range	default	description
0	"Gain dB"	"Float"	[-70.0, 35.0]	0	增益（dB）
1	"Pan"	"Float"	[-1.0, 1.0]	0	平移

限制器（Limiter）

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	统一输出增益

混响（Reverb）

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	湿信号高通滤波共振

颤音（Vibrato）

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	干湿比

移调（TimeDomainPitchShifter）

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；
具体授权的细节见授权介绍