Composition

ef-audio

Plays an audio file. Renders no visual output.

Set fft-size if you want to pair the element with ef-waveform for visualization.

Attributes

Filter attributes15 of 15

`duration`

React prop: duration
Type: string
Default: —
Description: How long this element is active (CSS time, e.g. "5s").

`fft-decay`

React prop: fftDecay
Type: number
Default: 8
Description: Decay frames averaged into getFrequencyData (default 8).

`fft-gain`

React prop: fftGain
Type: number
Default: 3
Description: Linear gain applied before frequency analysis (default 3.0).

`fft-size`

React prop: fftSize
Type: number
Default: 128
Description: FFT window size for getFrequencyData/getTimeDomainData (rounded to a power of two, default 128).

`file-id`

React prop: fileId
Type: string | null
Default: —
Description: Cloud file identifier — resolves to ${apiHost}/api/v1/files/${fileId}, taking priority over src.

`interpolate-frequencies`

React prop: interpolateFrequencies
Type: boolean
Default: false
Description: Smooths getFrequencyData bins by interpolating between FFT bands instead of nearest-neighbor sampling.

`loop`

React prop: loop
Type: boolean
Default: false
Description: Loop attribute — when this temporal is a self-driving root under a PlaybackController, the controller wraps back to 0 instead of pausing at duration.

`mute`

React prop: muted
Type: boolean
Default: false
Description: Mutes this element's audio.

`offset`

React prop: offset
Type: number
Default: —
Description: Start offset (seconds) within a parallel (fixed/contain/fit) parent timegroup.

`sourcein`

React prop: sourcein
Type: string
Default: —
Description: Start time within the source file (CSS time, e.g. "1.5s").

`sourceout`

React prop: sourceout
Type: string
Default: —
Description: End time within the source file (CSS time, e.g. "1.5s").

`src`

React prop: src
Type: string
Default: —
Description: URL of the source audio file.

`trimend`

React prop: trimend
Type: string
Default: —
Description: Trims this much off the end of the source (CSS time).

`trimstart`

React prop: trimstart
Type: string
Default: —
Description: Trims this much off the start of the source (CSS time).

`volume`

React prop: volume
Type: number
Default: 1
Description: Audio volume (0.0 to 1.0).

Events

Events
Event	Detail	Description
`child-duration-changed`	`{ duration: number }`	Fires on the nearest context-providing ancestor, when a nested media element's duration becomes known or changes.