VideoDecoder: Methode configure()

Syntax

configure(config)

Parameter

config

Ein Objekt, das die folgenden Mitglieder enthält:

codec

Ein String, der einen gültigen Codec-String enthält. Siehe „codecs“-Parameter für Details zur Konstruktion von Codec-Strings.

description Optional

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

codedWidth Optional

Ein Ganzzahlwert, der die Breite des VideoFrame in Pixeln darstellt, einschließlich nicht sichtbarer Polsterung, vor jeglichen Verhältnis-Anpassungen.

codedHeight Optional

Ein Ganzzahlwert, der die Höhe des VideoFrame in Pixeln darstellt, einschließlich nicht sichtbarer Polsterung, vor jeglichen Verhältnis-Anpassungen.

displayAspectWidth Optional

Ein Ganzzahlwert, der die horizontale Dimension des VideoFrame in Pixeln bei Anzeige darstellt.

displayAspectHeight Optional

Ein Ganzzahlwert, der die vertikale Dimension des VideoFrame in Pixeln bei Anzeige darstellt.

colorSpace Optional

Ein Objekt, das einen VideoColorSpace repräsentiert, und die folgenden Mitglieder enthält:

primaries

Ein String, der den Farbgamut der Video-Probe darstellt. Einer von:

• "bt709"
• "bt470bg"
• "smpte170m"

transfer

Ein String, der Übertragungseigenschaften darstellt. Einer von:

• "bt709"
• "smpte170m"
• "iec61966-2-1"

matrix

Ein String, der einen Matrix-Koeffizienten darstellt. Einer von:

• "rgb"
• "bt709"
• "bt470bg"
• "smpte170m"

hardwareAcceleration Optional

Ein Hinweis, welche Methode zur Hardware-Beschleunigung verwendet werden soll. Einer von:

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

optimizeForLatency Optional

Ein boolescher Wert. Wenn true, ist dies ein Hinweis, dass der ausgewählte Decoder optimiert werden sollte, um die Anzahl der EncodedVideoChunk-Objekte zu minimieren, die dekodiert werden müssen, bevor ein VideoFrame ausgegeben wird.

flip Optional

Ein boolescher Wert. Wenn true, wird horizontale Spiegelung angewendet. Standardmäßig ist dies false.

rotation Optional

Ein Ganzzahlwert, der die Rotation (0, 90, 180, oder 270) in Grad im Uhrzeigersinn darstellt. Standardmäßig 0. Beliebige Zahlen (einschließlich negativer) werden auf die nächste Vierteldrehung gerundet.

Rückgabewert

Keiner (undefined).

Ausnahmen

TypeError

Wird ausgelöst, wenn das bereitgestellte config ungültig ist.

InvalidStateError DOMException

Wird ausgelöst, wenn der state "closed" ist.

NotSupportedError DOMException

Wird ausgelöst, wenn das bereitgestellte config gültig ist, aber der User Agent keinen Codec bereitstellen kann, der dieses Profil dekodieren kann.

Beispiele

Das folgende Beispiel erstellt einen neuen VideoDecoder und konfiguriert ihn mit dem "vp8"-Codec, einer codedWidth von 640 Pixeln und einer codedHeight von 480 Pixeln.

const init = {
  output: handleFrame,
  error(e) {
    console.log(e.message);
  },
};

const config = {
  codec: "vp8",
  codedWidth: 640,
  codedHeight: 480,
};

let decoder = new VideoDecoder(init);
decoder.configure(config);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• VideoDecoder.isConfigSupported()
• Codec String Support Table