VideoEncoder.encode()

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The encode() method of the VideoEncoder interface enqueues a control message to encode a given VideoFrame.

Syntax

VideoEncoder.encode(frame);
VideoEncoder.encode(frame, options);

Parameters

frame

A VideoFrame object.

optionsOptional

An object containing the following member:

keyFrame

A boolean, defaulting to false giving the user agent flexibility to decide if this frame should be encoded as a key frame. If true this indicates that the given frame must be encoded as a key frame.

Return Value

Undefined.

Exceptions

DOMException InvalidStateError

Thrown if the state is not "configured".

DOMException DataError

Thrown if the chunk cannot be decoded due to relying on other frames for decoding.

Examples

In the following example encode is passed a VideoFrame, and the options parameter indicating that this frame should be considered a keyframe.

encoder.encode(frame, { keyFrame: true });

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
encode
94
94
No
No
80
No
94
94
No
No
No
No

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VideoEncoder/encode