AudioData
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}
The **AudioData** interface of the WebCodecs API represents an audio sample.
AudioData is a transferable object.
Constructor
- {{domxref("AudioData.AudioData", "AudioData()")}}
- : Creates a new
AudioDataobject.
Instance properties
- {{domxref("AudioData.format")}} {{ReadOnlyInline}}
- : Returns the sample format of the audio.
- {{domxref("AudioData.sampleRate")}} {{ReadOnlyInline}}
- : Returns the sample rate of the audio in Hz.
- {{domxref("AudioData.numberOfFrames")}} {{ReadOnlyInline}}
- : Returns the number of frames.
- {{domxref("AudioData.numberOfChannels")}} {{ReadOnlyInline}}
- : Returns the number of audio channels.
- {{domxref("AudioData.duration")}} {{ReadOnlyInline}}
- : Returns the duration of the audio in microseconds.
- {{domxref("AudioData.timestamp")}} {{ReadOnlyInline}}
- : Returns the timestamp of the audio in microseconds.
Instance methods
- {{domxref("AudioData.allocationSize()")}}
- : Returns the number of bytes required to hold the sample as filtered by options passed into the method.
- {{domxref("AudioData.copyTo()")}}
- : Copies the samples from the specified plane of the
AudioDataobject to the destination. - {{domxref("AudioData.clone()")}}
- : Creates a new
AudioDataobject with reference to the same media resource as the original. - {{domxref("AudioData.close()")}}
- : Clears all states and releases the reference to the media resource.
Description
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 {{domxref("MediaStreamTrackProcessor")}}, or construct an audio track from a stream of frames with {{domxref("MediaStreamTrackGenerator")}}.
توجه: Find out more about audio on the web in Digital audio concepts.
The media resource
An 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 {{domxref("AudioData.close()")}} is called.
Planes and audio format
To return the sample format of an AudioData use the {{domxref("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 {{domxref("AudioData.numberOfFrames")}} \* {{domxref("AudioData.numberOfChannels")}}.
In planar format, the number of planes is equal to {{domxref("AudioData.numberOfChannels")}}, and each plane is a buffer containing a number of elements equal to {{domxref("AudioData.numberOfFrames")}}.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}