RTCRtpScriptTransformer: sendKeyFrameRequest() method

Syntax

sendKeyFrameRequest()

Parameters

None.

Return value

A Promise that fulfills with undefined once the request is sent, or the user agent decides that it does not need to.

Exceptions

InvalidStateError

The de-packetizer is not processing video packets, or is undefined.

Examples

The example below shows how the main thread of a WebRTC application that is receiving encoded video might pass a decryption key to a receiver transform, and request the sender emit a key frame.

Note that the main thread doesn't have direct access to the RTCRtpScriptTransformer object, so it needs to pass the key to the worker. Here we do that with a MessageChannel, transferring the second port to the transformer code running in the worker. The code assumes there is already a peer connection, and videoReceiver is an RTCRtpReceiver.

const worker = new Worker("worker.js");
const channel = new MessageChannel();

videoReceiver.transform = new RTCRtpScriptTransform(
  worker,
  { name: "receiverTransform", port: channel.port2 },
  [channel.port2],
);

// Post new key to the receiver
channel.port1.start();
channel.port1.postMessage({
  key: "93ae0927a4f8e527f1gce6d10bc6ab6c",
});

The rtctransform event handler in the worker gets the port as event.transformer.options.port. The code snippet below shows how that is used to listen for message events on the channel. If an event is received the handler gets the key, and then calls sendKeyFrameRequest() on the transformer.

event.transformer.options.port.onmessage = (event) => {
  const { key } = event.data;
  // key is used by the transformer to decrypt frames (not shown)

  // Request sender to emit a key frame.
  // Here 'rcEvent' is the rtctransform event.
  rcEvent.transformer.sendKeyFrameRequest();
};

Specifications

Browser compatibility

See also

• Using WebRTC Encoded Transforms
• RTCRtpScriptTransformer