VideoEncoder

open class VideoEncoder(init: VideoEncoderInit) : EventTarget, JsCloseable(source)

The VideoEncoder interface of the WebCodecs API encodes VideoFrame objects into EncodedVideoChunks. Available only in secure contexts.

MDN Reference

Constructors

VideoEncoder

constructor(init: VideoEncoderInit)

Types

Companion

object Companion

Properties

encodeQueueSize

val encodeQueueSize: Int

The encodeQueueSize read-only property of the VideoEncoder interface returns the number of pending encode requests in the queue.

ondequeue

var ondequeue: EventHandler<Event, VideoEncoder, VideoEncoder>?

MDN Reference

state

val state: CodecState

The state read-only property of the VideoEncoder interface returns the current state of the underlying codec.

Functions

open override fun close()

The close() method of the VideoEncoder interface ends all pending work and releases system resources.

configure

fun configure(config: VideoEncoderConfig)

The configure() method of the VideoEncoder interface changes the state of the encoder to "configured" and asynchronously prepares the encoder to accept VideoEncoders for encoding with the specified parameters. If the encoder doesn't support the specified parameters or can't be initialized for other reasons an error will be reported via the error callback provided to the VideoEncoder constructor.

dispatchEvent

open fun dispatchEvent(event: Event): Boolean

encode

fun encode(frame: VideoFrame, options: VideoEncoderEncodeOptions = definedExternally)

The encode() method of the VideoEncoder interface asynchronously encodes a VideoFrame. Encoded data (EncodedVideoChunk) or an error will eventually be returned via the callbacks provided to the VideoEncoder constructor.

flush

inline suspend fun VideoEncoder.flush()

The flush() method of the VideoEncoder interface forces all pending encodes to complete.

flushAsync

fun flushAsync(): Promise<Void?>

The flush() method of the VideoEncoder interface forces all pending encodes to complete.

reset

fun reset()

The reset() method of the VideoEncoder interface synchronously cancels all pending encodes and callbacks, frees all underlying resources and sets the state to "unconfigured". After calling reset(), configure() must be called before resuming encode() calls.

when

fun <T : Event> when(type: EventType<T>, options: ObservableEventListenerOptions?): Observable<T>