VideoEncoder: VideoEncoder() Konstruktor

Syntax

new VideoEncoder(options)

Parameter

options

Ein Objekt, das zwei erforderliche Rckruffunktionen enthlt.

output

Eine Rckruffunktion, die ein EncodedVideoChunk-Objekt als erstes Argument und optional ein Metadatenobjekt als zweites Argument erhlt. Das Metadatenobjekt hat drei Mitglieder:

decoderConfig Optional

Ein Objekt, das folgendes enthlt:

codec

Ein String, der einen gltigen Codec-String enthlt.

description Optional

Ein ArrayBuffer, eine TypedArray oder eine DataView, die eine Folge von codecspezifischen Bytes enthlt, allgemein bekannt als "extradata".

codedWidth Optional

Eine Ganzzahl, die die Breite des VideoFrame in Pixeln darstellt, mglicherweise einschlielich nicht sichtbarer Auffllung und vor mglichen Verhltnis-Anpassungen.

codedHeight Optional

Eine Ganzzahl, die die Hhe des VideoFrame in Pixeln darstellt, mglicherweise einschlielich nicht sichtbarer Auffllung und vor mglichen Verhltnis-Anpassungen.

displayAspectWidth Optional

Eine Ganzzahl, die die horizontale Abmessung des Seitenverhltnisses des VideoFrame bei der Wiedergabe darstellt.

displayAspectHeight Optional

Eine Ganzzahl, die die vertikale Abmessung des Seitenverhltnisses des VideoFrame bei der Wiedergabe darstellt.

colorSpace Optional

Ein Objekt, das an den VideoColorSpace-Konstruktor als init-Argument bergeben wird und den VideoFrame.colorSpace fr die mit diesem decoderConfig-Objekt verknpften VideoFrames konfiguriert. Wenn colorSpace existiert, berschreiben die angegebenen Werte alle im Bitstream enthaltenen In-Band-Werte.

hardwareAcceleration Optional

Ein String, der die Hardware-Beschleunigung fr diesen Codec konfiguriert. Standardwert ist "no-preference". Optionen sind:

• "no-preference"
• "prefer-hardware"
• "prefer-software"

optimizeForLatency Optional

Ein boolean, der angibt, ob der ausgewhlte Decoder so konfiguriert werden soll, dass die Anzahl der EncodedVideoChunks, die decodiert werden mssen, bevor ein VideoFrame ausgegeben wird, minimiert wird.

svc Optional

Ein optionales Objekt mit nur einem Mitglied: temporalLayerId, was eine Nummer ist, die die Zeitliche Ebene fr das zugehrige EncodedVideoChunk identifiziert.

alphaSideData Optional

Ein ArrayBuffer, eine TypedArray oder eine DataView, die die zustzlichen Alpha-Kanal-Daten des EncodedVideoChunk enthlt.

error

Eine Rckruffunktion, die ein Error-Objekt als einziges Argument erhlt.

Beispiele

Im folgenden Beispiel wird ein VideoEncoder mit den zwei erforderlichen Rckruffunktionen erstellt, eine zur Verarbeitung des kodierten Frames und die andere zur Behandlung von Fehlern.

const videoEncoder = new VideoEncoder({
  output(chunk, metadata) {
    console.log(chunk.timestamp);
    console.log(chunk.byteLength);
    console.log(JSON.stringify(metadata));
  },
  error(error) {
    console.log(error);
  },
});

Spezifikationen

Browser-Kompatibilitt