RTCRtpScriptTransformer: options-Eigenschaft

Ein Objekt.

Die einfachste Nutzung von options besteht darin, dass der Hauptthread anzeigt, ob der entsprechende RTCRtpScriptTransform zur WebRTC-Sender- oder Empfänger-Pipeline hinzugefügt werden soll. Dies ist wichtig, wenn derselbe Worker sowohl für die Verarbeitung eingehender als auch ausgehender kodierter Frames verwendet wird, da es dem Code ermöglicht, zu bestimmen, welcher Transform auf die Frames angewendet werden soll.

Optionen können auch verwendet werden, um den zweiten Port eines Nachrichtenkanals an den Worker-seitigen Transform zu senden/übertragen. Dieser Kanal kann dann verwendet werden, um dynamische Informationen an einen Transform-Stream zu senden, zum Beispiel wenn Verschlüsselungsschlüssel geändert oder hinzugefügt werden. Beachten Sie, dass Sie Nachrichten auch mit Worker.postMessage() an den Transform senden könnten, jedoch müssten Sie die Nachrichten entsprechend umleiten, wenn der Worker in verschiedenen Kontexten verwendet wird (während eine Nachrichtenport-Option einen direkten Kanal für einen spezifischen Transform bietet).

Ein RTCRtpScriptTransform wird mit einem bestimmten Worker und Optionen erstellt und dann entweder der WebRTC-ausgehenden oder eingehenden Pipeline zugewiesen, indem es RTCRtpSender.transform oder RTCRtpReceiver.transform zugewiesen wird. Wenn derselbe Worker in den Transforms für die eingehende und ausgehende Pipeline verwendet wird, müssen Sie Optionen im Konstruktor angeben, um anzugeben, ob die zu transformierenden kodierten Frames eingehend oder ausgehend sind.

Das folgende Beispiel zeigt, wie dies für ein RTCRtpScriptTransform gemacht werden könnte, das nach dem Hinzufügen eines Tracks zur Peerverbindung (RTCPeerConnection) zur Sender-Pipeline hinzugefügt wird, und dann einen weiteren Transform zur Empfänger-Pipeline hinzufügt, wenn ein Track empfangen wird.

// videoSender is an RTCRtpSender.
const videoSender = peerConnection.addTrack(track, mediaStream);
videoSender.transform = new RTCRtpScriptTransform(worker, {
  name: "senderTransform",
});

peerConnection.ontrack = (event) => {
  // event.receiver is an RTCRtpReceiver
  event.receiver.transform = new RTCRtpScriptTransform(worker, {
    someOption: "receiverTransform",
  });
};

In jedem der obigen Fälle übergeben wir ein Objekt mit einem unterschiedlichen Wert für die Eigenschaft name des Optionsobjekts, was die Pipeline angibt, zu der der Transform hinzugefügt wurde. Beachten Sie, dass die Namen und Werte von Eigenschaften in options willkürlich sind: Wichtig ist, dass sowohl der Hauptthread als auch der Worker-Thread wissen, welche Eigenschaften und Werte verwendet werden.

Der folgende Code zeigt, wie die übergebenen Optionen im Worker verwendet werden. Zunächst implementieren wir einen Handler für das rtctransform-Ereignis, das beim globalen Worker-Objekt beim Aufbau des entsprechenden RTCRtpScriptTransform und bei der Einreihung neuer Frames zur Verarbeitung ausgelöst wird. event.transformer ist ein RTCRtpScriptTransformer, das die Eigenschaften readable, writable und options hat.

addEventListener("rtctransform", (event) => {
  let transform;
  // Select a transform based on passed options
  if (event.transformer.options.name === "senderTransform")
    transform = createSenderTransform(); // A TransformStream
  else if (event.transformer.options.name === "receiverTransform")
    transform = createReceiverTransform(); // A TransformStream
  else return;

  // Pipe frames from the readable to writeable through TransformStream
  event.transformer.readable
    .pipeThrough(transform)
    .pipeTo(event.transformer.writable);
});

Der Code erstellt einen anderen TransformStream, um ausgehende und eingehende Frames zu verarbeiten, basierend auf den übergebenen Optionen createSenderTransform() oder createReceiverTransform() (es leitet dann Frames vom readable durch den ausgewählten TransformStream zum writable).

Dieses Beispiel zeigt, wie ein Nachrichtenkanal erstellt und einer seiner Ports an den in dem Worker laufenden WebRTC-kodierten Transform übertragen wird. Der Hauptthread kann dann Objekte und Nachrichten nach der Erstellung an den im Worker laufenden Transformer senden und übertragen und umgekehrt.

Der folgende Code erstellt zunächst einen MessageChannel und dann einen RTCRtpScriptTransform, wobei der Wert port2 als Eigenschaft im Optionsargument übergeben wird. Der Port ist auch im Array enthalten, das als drittes Argument des Konstruktors übergeben wird, sodass er in den Worker-Kontext übertragen wird.

const channel = new MessageChannel();

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

Der Worker kann dann den Port vom rtctransform-Ereignis abrufen, das beim globalen Worker-Objekt ausgelöst wird.

let messagePort;
addEventListener("rtctransform", (event) => {
  messagePort = event.transformer.options.port;
  // … other transformer code
});

Code an jedem Ende des Kanals kann Objekte an das andere Ende senden und übertragen, indem MessagePort.postMessage() verwendet wird und auf eingehenden Nachrichten mit seinem message-Ereignis hört.

Zum Beispiel könnte, wenn wir einen Verschlüsselungsschlüssel in einem Uint8Array-typen Array namens encryptionKey hätten, es folgendermaßen vom Hauptthread an den Worker übertragen werden:

const encryptionKeyBuffer = encryptionKey.buffer;
channel.port1.postMessage(encryptionKeyBuffer, [encryptionKeyBuffer]);

Der Worker würde auf das message-Ereignis hören, um den Schlüssel zu erhalten:

messagePort.addEventListener("message", (event) => {
  const encryptionKeyBuffer = event.data;
  // … Use the encryptionKeyBuffer for encryption or any other purpose
});

Weitere Informationen und Beispiele finden Sie im Nachrichtenkanal.

• Verwendung von WebRTC-Encoded-Transforms