DedicatedWorkerGlobalScope: событие rtctransform

Событие rtctransform срабатывает в объекте DedicatedWorkerGlobalScope работника, когда закодированная видео- или аудио-кадр помещена в очередь для обработки WebRTC-преобразованием кодированных данных.

Свойство transformer события возвращает объект RTCRtpScriptTransformer, который предоставляет доступ к ReadableStream, в котором находится кадр в очереди, и к WritableStream, куда можно записать кадр для его возврата в WebRTC-поток.

Это событие не отменяется и не распространяется.

Используйте имя события в методах, таких как addEventListener(), или установите свойство обработчика события.

addEventListener("rtctransform", (event) => {});

onrtctransform = (event) => {};

Объект RTCTransformEvent. Наследуется от Event.

Этот интерфейс также наследует свойства от своего родителя, Event.

RTCTransformEvent.transformer Только для чтения

Возвращает RTCRtpScriptTransformer, связанный с событием.

Следующий фрагмент кода демонстрирует обработчик события rtctransform в работнике, добавленный в глобальную область видимости с помощью addEventListener(). event.transformer — это RTCRtpScriptTransformer, аналог объекта RTCRtpScriptTransform со стороны работника.

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);
});

Событие rtctransform срабатывает, когда закодированный кадр помещается в очередь на RTCRtpScriptTransformer, и один раз при создании соответствующего объекта RTCRtpScriptTransformer для преобразования. Код сначала определяет, какое преобразование применять, используя значение name, переданное в опциях (это позволяет экземплярам RTCRtpScriptTransform, добавляемым в входящие и исходящие потоки WebRTC, использовать одного работника). Затем закодированные кадры передаются от чтения через выбранное преобразование TransformStream в запись. Сам код преобразования здесь не показан.

Обратите внимание, что этот код является частью более полного примера, представленного в Использовании WebRTC-преобразований кодированных данных.

• Использование WebRTC-преобразований кодированных данных