AudioDecoder: configure() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{securecontext_header}}{{APIRef("WebCodecs API")}}{{AvailableInWorkers("window_and_dedicated")}}
The **configure()** method of the {{domxref("AudioDecoder")}} interface enqueues a control message to configure the audio decoder for decoding chunks.
Syntax
js-nolint
configure(config)Parameters
config- : A dictionary object containing the following members:
codec- : A string containing a valid codec string. See "codecs" parameter for details on codec string construction.
sampleRate- : An integer representing the number of frame samples per second.
numberOfChannels- : An integer representing the number of audio channels.
description{{optional_inline}}- : An {{jsxref("ArrayBuffer")}}, a {{jsxref("TypedArray")}}, or a {{jsxref("DataView")}} containing a sequence of codec specific bytes, commonly known as extradata.
توجه: The registrations in the WebCodecs Codec Registry link to a specification detailing whether and how to populate the optional description member.
Return value
None ({{jsxref("undefined")}}).
Exceptions
- {{jsxref("TypeError")}}
- : Thrown if the provided
configis invalid. InvalidStateError{{domxref("DOMException")}}- : Thrown if the {{domxref("AudioDecoder.state","state")}} is
"closed". NotSupportedError{{domxref("DOMException")}}- : Thrown if the provided
configis valid but the user agent cannot provide a codec that can decode this profile.
Examples
The following example configures the audioDecoder with the opus codec.
js
audioDecoder.configure({
codec: "opus",
sampleRate: 44100,
numberOfChannels: 2,
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}