오디오

이 페이지는 문서 버전에 해당하는 project.v1.schema.json에서 자동 생성되며, 필드 설명은 원문(영어) 그대로입니다. 스키마는 형태만 검사합니다. 범위, 한도, 참조, 키프레임 순서는 엔진 검증 단계에서 검사합니다.

`AudioEffect`

A serializable single-input audio effect applied to a clip or track bus.

Sidechain ducking takes a second input, so it is authored per track through Ducking.

One of:

type: "eq"

Cascaded biquad sections.

Field	Type	Description
`bands`required	EqBand[]	Ordered filter sections, 1 to `MAX_EQ_BANDS` of them.

type: "compressor"

Lookahead dynamic range compression.

Field	Type	Description
`attack_ms`required	number (float)	Attack time in milliseconds, positive and at most `MAX_ENVELOPE_MS`.
`lookahead_ms`	number (float)	Lookahead in milliseconds, at most `MAX_LOOKAHEAD_MS`. Reported as graph latency. Default: `0`
`ratio`required	number (float)	Downward ratio, from one (unity) to `MAX_COMPRESSOR_RATIO`.
`release_ms`required	number (float)	Release time in milliseconds, positive and at most `MAX_ENVELOPE_MS`.
`threshold_db`required	number (float)	Level above which gain reduction begins, in decibels from `MIN_LEVEL_DB` to 0.

type: "reverb"

Schroeder reverberation.

Field	Type	Description
`damping`required	number (float)	High-frequency damping, in `0..=1`.
`mix`required	number (float)	Wet mix, in `0..=1`.
`room_size`required	number (float)	Room size, in `0..=1`.

`AudioProperties`

Per-clip audio presentation controls.

Field	Type	Description
`effects`	AudioEffect[]	Ordered single-input effects applied before the track bus, at most `MAX_CHAIN_EFFECTS`. Default: `[]`
`fade_in`	MediaTime	Fade-in duration measured from the clip's timeline start. Non-negative. Default: `0`
`fade_out`	MediaTime	Fade-out duration measured back from the clip's timeline end. Non-negative. Default: `0`
`fade_shape`	FadeShape	Curve used by both fades. Default: `"linear"`
`gain`	Animated_float	Animated linear amplitude constrained to `0..=MAX_GAIN`. Default: `{"mode":"constant","value":1}`
`muted`	boolean	Silences this clip without removing it. Default: `false`
`pan`	Animated_float	Animated stereo position from `-1` (left) to `1` (right). Default: `{"mode":"constant","value":0}`
`preserve_pitch`	boolean	Keeps the clip's pitch when its speed is not 1 by time-stretching instead of resampling. No effect at speed 1, on loops or on freezes.

`AudioStreamShape`

An audio stream's channel count and sample rate.

Field	Type	Description
`channels`required	integer (uint32)	Channel count.
`sample_rate`required	integer (uint32)	Samples per second per channel.

`Ducking`

Sidechain ducking authored on the track that is attenuated.

Field	Type	Description
`attack_ms`required	number (float)	Attack time in milliseconds, positive and at most `MAX_ENVELOPE_MS`.
`depth_db`required	number (float)	Maximum attenuation in decibels, from `MIN_LEVEL_DB` to 0.
`release_ms`required	number (float)	Release time in milliseconds, positive and at most `MAX_ENVELOPE_MS`.
`sidechain_track`required	TrackId	Track whose mixed output drives the envelope follower.
`threshold`required	number (float)	Linear level above which attenuation begins. Positive.

`EqBand`

A single equalizer section stored independently from its DSP implementation.

Field	Type	Description
`frequency_hz`required	number (float)	Center or corner frequency in hertz, within `EQ_FREQUENCY_RANGE_HZ`.
`gain_db`	number (float)	Peaking gain in decibels, at most `MAX_EQ_GAIN_DB` either way. Ignored by the pass filters. Default: `0`
`kind`required	EqBandKind	Filter shape.
`q`required	number (float)	Resonance, within `EQ_Q_RANGE`. Larger values produce narrower bands.

`EqBandKind`

The filter shape of one equalizer band.

"peaking" Bell-shaped parametric band.
"low_pass" Second-order low-pass.
"high_pass" Second-order high-pass.

`FadeShape`

Curve applied by a clip's fade in and fade out.

"linear" Amplitude moves linearly. Two linear fades over one overlap dip by 6 dB.
"equal_power" Amplitude follows a quarter sine. Two of these crossfade at constant power.

`Limiter`

Final peak limiter placed at the end of the master bus.

Field	Type	Description
`release_ms`required	number (float)	Release time in milliseconds, positive and at most `MAX_ENVELOPE_MS`.
`threshold`required	number (float)	Linear ceiling, positive and at most `MAX_GAIN`. One is full scale.

`MasterAudio`

Project-wide master bus settings.

Field Type Description

Field	Type	Description
`effects`	AudioEffect[]	Ordered single-input effects applied to the summed track buses, at most `MAX_CHAIN_EFFECTS`. Default: `[]`
`gain`	Animated_float	Animated linear master amplitude constrained to `0..=MAX_GAIN`. Default: `{"mode":"constant","value":1}`
`limiter`	Limiter \| null	Final peak limiter. Omitted means `default`; an explicit `null` leaves the mix unlimited. Default: `{"release_ms":50,"threshold":1}`

effects

AudioEffect[]

Ordered single-input effects applied to the summed track buses, at most MAX_CHAIN_EFFECTS.

Default: []

gain

Animated_float

Animated linear master amplitude constrained to 0..=MAX_GAIN.

Default: {"mode":"constant","value":1}

limiter

Limiter | null

Final peak limiter. Omitted means default; an explicit null leaves the mix unlimited.

Default: {"release_ms":50,"threshold":1}

`TrackAudio`

Per-track audio bus controls.

Field	Type	Description
`ducking`	Ducking \| null	Optional sidechain attenuation driven by another track. Default: `null`
`effects`	AudioEffect[]	Ordered single-input effects applied to the summed clip signal, at most `MAX_CHAIN_EFFECTS`. Default: `[]`
`gain`	Animated_float	Animated linear bus amplitude constrained to `0..=MAX_GAIN`. Default: `{"mode":"constant","value":1}`
`muted`	boolean	Silences this bus. Default: `false`
`pan`	Animated_float	Animated stereo position applied after the clip mix, from `-1` (left) to `1` (right). Default: `{"mode":"constant","value":0}`
`solo`	boolean	Restricts the mix to soloed buses when any track sets this. Default: `false`