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 AudioData object.

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 AudioData object to the destination.
  • {{domxref("AudioData.clone()")}}
  • : Creates a new AudioData object 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}}