Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
AudioData interface of the WebCodecs API represents an audio sample.
AudioData is a transferable object.
An audio track consists of a stream of audio samples, each sample representing a captured moment of sound. An
AudioData object is a representation of such a sample. Working alongside the interfaces of the Insertable Streams API, you can break a stream into individual
AudioData objects with
MediaStreamTrackProcessor, or construct an audio track from a stream of frames with
Note: Find out more about audio on the web in Digital audio concepts.
The media resource
AudioData object contains a reference to an attached media resource. This media resource contains the actual audio sample data described by the object. A media resource is maintained by the user agent until it is no longer referenced by an
AudioData object, for example when
AudioData.close() is called.
Planes and audio format
To return the sample format of an
AudioData use the
AudioData.format property. The format may be described as interleaved or planar. In interleaved formats, the audio samples from the different channels are laid out in a single buffer, described as a plane. This plane contains a number of elements equal to
In planar format, the number of planes is equal to
AudioData.numberOfChannels, and each plane is a buffer containing a number of elements equal to
Creates a new
AudioData.formatRead only Experimental
Returns the sample format of the audio.
AudioData.sampleRateRead only Experimental
Returns the sample rate of the audio in Hz.
AudioData.numberOfFramesRead only Experimental
Returns the number of frames.
AudioData.numberOfChannelsRead only Experimental
Returns the number of audio channels.
AudioData.durationRead only Experimental
Returns the duration of the audio in microseconds.
AudioData.timestampRead only Experimental
Returns the timestamp of the audio in microseconds.
Returns the number of bytes required to hold the sample as filtered by options passed into the method.
Copies the samples from the specified plane of the
AudioDataobject to the destination.
Creates a new
AudioDataobject with reference to the same media resource as the original.
Clears all states and releases the reference to the media resource.
BCD tables only load in the browser