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

RTCRtpScriptTransform: RTCRtpScriptTransform() constructor

· 52CE 我爱测

The **`RTCRtpScriptTransform()`** constructor creates a new RTCRtpScriptTransform object.

WebRTC

The RTCRtpScriptTransform() constructor creates a new RTCRtpScriptTransform object.

Constructing the RTCRtpScriptTransform creates a counterpart RTCRtpScriptTransformer in the specified worker, along with passed options (if any). Objects in the third parameter to the constructor are transferred.

The DedicatedWorkerGlobalScope.rtctransform_event event is then fired at the worker global object. Worker code can use the event.transformer property to get the counterpart RTCRtpScriptTransformer, and event.transformer.options is used to get the options.

Note that the options are primarily used to inform the worker whether the transformer is processing incoming or outgoing frames, so that it can apply an appropriate transform.

Syntax

new RTCRtpScriptTransform(worker)
new RTCRtpScriptTransform(worker, options)
new RTCRtpScriptTransform(worker, options, transfer)

Parameters

  • worker
    • : A Worker, which will define code for one or more WebRTC transform streams.
  • options
    • : An arbitrary object that will be made available in the worker. This is most commonly used to inform the worker whether it injected into the WebRTC sender or receiver pipeline, and hence which transform should be applied. However it may also be used to send any other object, such as a MessagePort for communicating dynamically with the transformer.
  • transfer
    • : An optional array of transferable objects that will be transferred to the worker. After transfer, these objects are unusable in the main thread.

Exceptions

  • DataCloneError DOMException
    • : Thrown if an object in transfer cannot be transferred.

Examples

The first example below shows construction of a RTCRtpScriptTransform that is then assigned to a RTCRtpSender.transform. The constructor takes an optional object with the property name and senderTransform. The worker can use this option to understand when it is transforming encoded frames from the encoder (rather than incoming frames from the packetizer).

// Create a worker containing a TransformStream
const worker = new Worker("worker.js");
videoSender.transform = new RTCRtpScriptTransform(worker, {
  name: "senderTransform",
});

Any property name and value can be used in the options, as long as they can be serialized (and transferred if specified in the last constructor parameter). The code below transfers the second port of a MessageChannel to the worker, which we might do in order to dynamically update transform code with (say) a new encryption key.

// Create a worker containing a TransformStream
const worker = new Worker("worker.js");
const channel = new MessageChannel();

const transform = new RTCRtpScriptTransform(
  worker,
  { purpose: "encrypt", port: channel.port2 },
  [channel.port2],
);

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

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

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