RTCRtpScriptTransformer: phương thức sendKeyFrameRequest()

Cú pháp

sendKeyFrameRequest()

Tham số

Không có.

Giá trị trả về

Một Promise được giải quyết với undefined sau khi yêu cầu được gửi, hoặc user agent quyết định rằng không cần thiết.

Ngoại lệ

InvalidStateError

De-packetizer không xử lý các gói video, hoặc là undefined.

Ví dụ

Ví dụ bên dưới cho thấy cách luồng chính của ứng dụng WebRTC đang nhận video được mã hóa có thể truyền khóa giải mã đến transform nhận, và yêu cầu người gửi phát ra khung chính.

Lưu ý rằng luồng chính không có quyền truy cập trực tiếp vào đối tượng RTCRtpScriptTransformer, vì vậy nó cần truyền khóa đến worker. Ở đây chúng ta thực hiện điều đó với một MessageChannel, transfer cổng thứ hai đến mã transformer chạy trong worker. Mã giả định đã có một peer connection, và videoReceiver là một 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",
});

Trình xử lý sự kiện rtctransform trong worker lấy cổng là event.transformer.options.port. Đoạn mã bên dưới cho thấy cách nó được sử dụng để lắng nghe các sự kiện message trên kênh. Nếu nhận được sự kiện, hàm xử lý lấy key, sau đó gọi sendKeyFrameRequest() trên 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();
};

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• Using WebRTC Encoded Transforms
• RTCRtpScriptTransformer