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: Diese Funktion ist in Dedicated Web Workers verfügbar.

Der AudioEncoder() Konstruktor erstellt ein neues AudioEncoder-Objekt, wobei die bereitgestellte init.output Callback-Funktion als Ausgabe-Collback und die bereitgestellte init.error Callback-Funktion als Fehler-Collback zugewiesen werden. Der AudioEncoder.state wird auf "unconfigured" gesetzt.

Syntax

js
new AudioEncoder(init)

Parameter

init

Ein Objekt, das zwei erforderliche Callback-Funktionen enthält.

output

Eine Callback-Funktion, die ein EncodedAudioChunk-Objekt als erstes Argument und ein optionales Metadatenobjekt als zweites Argument nimmt. Das Metadatenobjekt hat ein Mitglied, decoderConfig, das ein Objekt als Wert enthält mit:

codec

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

sampleRate

Ein ganzzahliger Wert, der die Anzahl der Rahmproben pro Sekunde darstellt.

numberOfChannels

Ein ganzzahliger Wert, der die Anzahl der Audiokanäle darstellt.

description Optional

Ein ArrayBuffer, ein TypedArray oder ein DataView, der eine Sequenz von codec-spezifischen Bytes enthält, die gewöhnlich als extradata bekannt sind.

error

Eine Callback-Funktion, die ein Error-Objekt als einziges Argument nimmt.

Beispiele

Im folgenden Beispiel wird ein AudioEncoder mit den zwei erforderlichen Callback-Funktionen erstellt, eine zur Bearbeitung des dekodierten Frames und die andere zur Fehlerbehandlung.

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

Spezifikationen

Specification
WebCodecs
# dom-audioencoder-audioencoder

Browser-Kompatibilität