Phương thức replaceTrack() của RTCRtpSender

Cú pháp

replaceTrack(newTrack)

Tham số

newTrack Optional

Một MediaStreamTrack chỉ định track để thay thế track nguồn hiện tại của RTCRtpSender. kind của track mới phải giống với track hiện tại, nếu không yêu cầu thay thế track sẽ thất bại.

Giá trị trả về

Một Promise được fulfilled khi track đã được thay thế thành công. Promise bị rejected nếu track không thể được thay thế vì bất kỳ lý do nào; điều này thường là do thay đổi sẽ yêu cầu đàm phán lại codec, điều không được phép (xem Những thứ yêu cầu đàm phán).

Nếu newTrack bị bỏ qua hoặc là null, replaceTrack() dừng sender. Trong trường hợp này không cần đàm phán.

Khi promise được fulfilled, trình xử lý fulfillment nhận được giá trị là undefined.

Ngoại lệ

Nếu promise trả về bị rejected, một trong các ngoại lệ sau sẽ được cung cấp cho trình xử lý rejection:

InvalidModificationError DOMException

Được trả về nếu việc thay thế track hiện tại của RTCRtpSender bằng track mới sẽ yêu cầu đàm phán.

InvalidStateError DOMException

Được trả về nếu track mà phương thức này được gọi đang bị dừng thay vì đang chạy.

TypeError

Được trả về nếu kind của track mới không khớp với track gốc.

Ghi chú sử dụng

Những thứ yêu cầu đàm phán

Hầu hết việc thay thế track có thể được thực hiện mà không cần đàm phán lại. Trên thực tế, ngay cả những thay đổi có vẻ lớn cũng có thể được thực hiện mà không cần đàm phán. Tuy nhiên, một số thay đổi có thể yêu cầu đàm phán và do đó làm replaceTrack() thất bại:

• Track mới có độ phân giải nằm ngoài giới hạn của kích thước đã đàm phán với peer; tuy nhiên, hầu hết các endpoint của trình duyệt cho phép thay đổi độ phân giải.
• Frame rate của track mới đủ cao để vượt quá block rate của codec.
• Track mới là track video và trạng thái raw hoặc pre-encoded khác với track gốc.
• Track mới là track âm thanh với số kênh khác với track gốc.
• Các nguồn media có bộ mã hóa tích hợp — chẳng hạn như bộ mã hóa phần cứng — có thể không thể cung cấp codec đã đàm phán. Các nguồn phần mềm có thể không triển khai codec đã đàm phán.

Ví dụ

Chuyển đổi camera video

const localConnection = new RTCPeerConnection();
const remoteConnection = new RTCPeerConnection();
// Cấu hình những kết nối này để sử dụng API WebRTC có thể được khám phá tại
// https://mdn.go-mizu.dev/vi/docs/Web/API/WebRTC_API/Simple_RTCDataChannel_sample
const connections = [localConnection, remoteConnection];
function setCamera(selectedCamera) {
  navigator.mediaDevices
    .getUserMedia({
      video: {
        deviceId: {
          exact: selectedCamera,
        },
      },
    })
    .then((stream) => {
      const [videoTrack] = stream.getVideoTracks();
      connections.forEach((pc) => {
        const sender = pc
          .getSenders()
          .find((s) => s.track.kind === videoTrack.kind);
        console.log("Found sender:", sender);
        sender.replaceTrack(videoTrack);
      });
    })
    .catch((err) => {
      console.error(`Error happened: ${err}`);
    });
}

Đặc tả kỹ thuật

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

Xem thêm

• API WebRTC