RTCTransformEvent
Baseline
2025
Newly available
Since October 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
RTCTransformEvent của WebRTC API đại diện cho một sự kiện được kích hoạt trong một dedicated worker khi một khung được mã hóa đã được xếp vào hàng đợi để xử lý bởi một WebRTC Encoded Transform.
Giao diện có một thuộc tính transformer hiển thị một readable stream và một writable stream.
Một worker nên đọc các khung được mã hóa từ transformer.readable, chỉnh sửa chúng khi cần, và ghi chúng vào transformer.writable theo cùng thứ tự mà không có bất kỳ sự trùng lặp nào.
Tại thời điểm viết, chỉ có một sự kiện dựa trên RTCTransformEvent: rtctransform.
Thuộc tính phiên bản
Vì RTCTransformEvent dựa trên Event, các thuộc tính của nó cũng có sẵn.
RTCTransformEvent.transformerRead only-
Trả về
RTCRtpScriptTransformerliên kết với sự kiện.
Các loại sự kiện transform
Chỉ có một loại sự kiện transform.
rtctransform
Sự kiện rtctransform được kích hoạt tại phạm vi toàn cục của worker khi xây dựng một RTCRtpScriptTransform liên kết, và bất cứ khi nào một khung video hoặc âm thanh được mã hóa mới được xếp vào hàng đợi để xử lý.
Bạn có thể thêm trình lắng nghe sự kiện rtctransform để được thông báo khi khung mới có sẵn bằng cách dùng DedicatedWorkerGlobalScope.addEventListener() hoặc thuộc tính xử lý sự kiện onrtctransform.
Ví dụ
Ví dụ này tạo một trình lắng nghe sự kiện cho sự kiện rtctransform.
Ví dụ giả định chúng ta có một TransformStream với một đối tượng options được truyền từ hàm khởi tạo RTCRtpScriptTransform trong luồng chính.
Mã ở cuối cho thấy cách stream được dẫn qua transform stream từ readable đến writable.
addEventListener("rtctransform", (event) => {
let transform;
// Select a transform based on passed options
if (event.transformer.options.name === "senderTransform") {
transform = createSenderTransform(); // A TransformStream (not shown)
} else if (event.transformer.options.name === "receiverTransform") {
transform = createReceiverTransform(); // A TransformStream (not shown)
}
// Pipe frames from the readable to writeable through TransformStream
event.transformer.readable
.pipeThrough(transform)
.pipeTo(event.transformer.writable);
});
Lưu ý rằng mã này là một phần của ví dụ đầy đủ hơn được cung cấp trong Using WebRTC Encoded Transforms.
Thông số kỹ thuật
| Specification |
|---|
| WebRTC Encoded Transform # rtctransformevent |