AudioEncoder: AudioEncoder() Konstruktor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Dedicated Web Workers.

Der AudioEncoder()-Konstruktor erstellt ein neues AudioEncoder-Objekt mit dem bereitgestellten init.output-Callback als Ausgabe-Callback, dem bereitgestellten init.error-Callback als Fehler-Callback und der AudioEncoder.state, die auf "unconfigured" gesetzt ist.

Syntax

js
new AudioEncoder(init)

Parameter

init

Ein Objekt, das zwei erforderliche Callbacks enthält.

output

Ein Callback, das ein EncodedAudioChunk-Objekt als erstes Argument und ein optionales Metadatenobjekt als zweites entgegennimmt. Das Metadatenobjekt hat ein Mitglied decoderConfig, das ein Objekt als Wert hat, das Folgendes enthält:

codec

Ein String, der einen gültigen Codec-String enthält.

sampleRate

Ein Integer, der die Anzahl der Frame-Samples pro Sekunde darstellt.

numberOfChannels

Ein Integer, der die Anzahl der Audiokanäle darstellt.

description Optional

Ein ArrayBuffer, ein TypedArray oder ein DataView, das eine Sequenz von Codec-spezifischen Bytes enthält, allgemein bekannt als Extradata.

error

Ein Callback, das ein Error-Objekt als einziges Argument entgegennimmt.

Beispiele

Im folgenden Beispiel wird ein AudioEncoder mit den beiden erforderlichen Callback-Funktionen erstellt, eine, um den dekodierten Frame zu verarbeiten, und die andere, um Fehler zu behandeln.

js
const audioEncoder = new AudioEncoder({
  output: processAudio,
  error: onEncoderError,
});

Spezifikationen

Specification
WebCodecs
# dom-audioencoder-audioencoder

Browser-Kompatibilität

BCD tables only load in the browser