大网数据广告活动
Web 标准与前端开发

VideoDecoder: configure() method

· 52CE 我爱测

The **`configure()`** method of the VideoDecoder interface enqueues a control message to configure the video decoder for decoding chunks.

WebCodecs APIwindow_and_dedicated

The configure() method of the VideoDecoder interface enqueues a control message to configure the video decoder for decoding chunks.

Syntax

configure(config)

Parameters

  • config
    • : An object containing the following members:
      • codec
      • description
        • : An ArrayBuffer, a TypedArray, or a DataView containing a sequence of codec specific bytes, commonly known as extradata.
      • codedWidth
        • : An integer representing the width of the VideoFrame in pixels, including any non-visible padding, before any ratio adjustments.
      • codedHeight
        • : An integer representing the height of the VideoFrame in pixels, including any non-visible padding, before any ratio adjustments.
      • displayAspectWidth
        • : An integer representing the horizontal dimension of the VideoFrame in pixels when displayed.
      • displayAspectHeight
        • : An integer representing the vertical dimension of the VideoFrame in pixels when displayed.
      • colorSpace
        • : An object representing a VideoColorSpace, containing the following members:
          • primaries
            • : A string representing the color gamut of the video sample. One of:
              • "bt709"
              • "bt470bg"
              • "smpte170m"
          • transfer
            • : A string representing transfer characteristics. One of:
              • "bt709"
              • "smpte170m"
              • "iec61966-2-1"
          • matrix
            • : A string representing a matrix coefficient. One of:
              • "rgb"
              • "bt709"
              • "bt470bg"
              • "smpte170m"
      • hardwareAcceleration
        • : A hint as to the hardware acceleration method to use. One of:
          • "no-preference"
          • "prefer-hardware"
          • "prefer-software"
      • optimizeForLatency
        • : A boolean. If true this is a hint that the selected decoder should be optimized to minimize the number of EncodedVideoChunk objects that have to be decoded before a VideoFrame is output.
      • flip
        • : A boolean. If true, horizontal mirroring is applied. Defaults to false.
      • rotation
        • : An integer representing the rotation (0, 90, 180, or 270) in degrees clockwise. Defaults to 0. Arbitrary numbers (including negatives) are rounded to the next quarter turn.

[!NOTE] The registrations in the WebCodecs Codec Registry link to a specification detailing whether and how to populate the optional description member.

Return value

None (undefined).

Exceptions

  • TypeError
    • : Thrown if the provided config is invalid.
  • InvalidStateError DOMException
    • : Thrown if the VideoDecoder.state is "closed".
  • NotSupportedError DOMException
    • : Thrown if the provided config is valid but the user agent cannot provide a codec that can decode this profile.

Examples

The following example creates a new VideoDecoder and configures it with the "vp8" codec, a codedWidth of 640 pixels and a codedHeight of 480 pixels.

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);

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。