useAudio

Commons
stable

Wire an <audio> element to the Web Audio API for frequency analysis and playback control. Tracks play/pause state, creates an AnalyserNode on first play to feed real-time frequency data (Uint8Array), and reacts to prop changes to reset playback when the audio source changes.

API

Signature

Signature TypeScript complète extraite du fichier du composable.

typescript

useAudio is the low-level Web Audio API bridge. <OrigamAudio> wraps it with a full playback UI and waveform visualiser. Use useAudio directly only when building custom audio UIs.

Interfaces consommées

IUseAudioProps

API

Paramètres

Paramètres d'entrée acceptés par ce composable.

props
requis
IUseAudioProps
Props object with audio (URL of the audio source) and playAudio (boolean flag). When playAudio changes to true the composable calls onPlay(); when it changes to false it calls onStop(). When audio changes, wasPlayed and isPlaying are reset.

API

Valeurs de retour

Propriétés et méthodes exposées par l'objet retourné par le composable.

audioData
Shallow ref holding the AnalyserNode's frequency-bin byte array. Updated every animation frame while playing. Bind to a visualiser (e.g. OrigamAudio waveform bars).
analyser
The Web Audio AnalyserNode created on first play. Null until onPlay() is called at least once. fftSize is fixed at 256 (128 frequency bins).
audioRef
Template ref to assign to the native <audio> element. The composable calls .play() and .pause() on it.
wasPlayed
True after the first play invocation. Used to create the AudioContext only once per audio source — re-creating it on every play would leak nodes.
isPlaying
Reactive playback state. True while the audio is playing and the animation loop is running.
onPlay
Start playback. Creates the AudioContext on first call, starts the requestAnimationFrame loop to fill audioData, and sets isPlaying to true.
onStop
Pause playback, stop the animation loop, and set isPlaying to false.

Usage

Exemples

Extraits de code prêts à coller.

Basic audio player with frequency visualiser

vue