RTCIceCandidate: thuộc tính usernameFragment

Giá trị

Một chuỗi chứa phân đoạn tên người dùng (thường được viết tắt là "ufrag" hoặc "ice-ufrag"), cùng với mật khẩu ICE ("ice-pwd"), xác định duy nhất một tương tác ICE đang diễn ra, bao gồm cả giao tiếp với máy chủ STUN. Chuỗi có thể dài tới 256 ký tự và không có giá trị mặc định.

Ngẫu nhiên hóa

Ít nhất 24 bit của văn bản trong ufrag được yêu cầu phải được tầng ICE chọn ngẫu nhiên vào đầu phiên ICE. Các chi tiết cụ thể về các bit nào là ngẫu nhiên và phần còn lại của văn bản ufrag là gì tùy thuộc vào việc triển khai trình duyệt. Ví dụ, một trình duyệt có thể luôn sử dụng ufrag dài 24 ký tự trong đó bit 4 của mỗi ký tự được chọn ngẫu nhiên giữa 0 và 1. Một ví dụ khác: nó có thể lấy một chuỗi do người dùng định nghĩa và nối thêm ba byte ngẫu nhiên 8-bit vào cuối. Hoặc có thể mỗi ký tự hoàn toàn ngẫu nhiên.

Ghi chú sử dụng

ICE sử dụng usernameFragment và mật khẩu để đảm bảo tính toàn vẹn thông điệp. Điều này tránh sự xuyên nhiễu giữa nhiều phiên ICE đang diễn ra, nhưng quan trọng hơn là giúp bảo mật các giao dịch ICE (và toàn bộ WebRTC theo đó) chống lại các cuộc tấn công có thể cố gắng chen vào trao đổi ICE.

Cả usernameFragment lẫn mật khẩu đều thay đổi mỗi khi ICE restart xảy ra.

Ví dụ

Mặc dù cơ sở hạ tầng WebRTC sẽ lọc các candidate lỗi thời cho bạn sau khi khởi động lại ICE, bạn có thể tự làm điều đó nếu bạn đang cố gắng tối đa hóa số lượng tối thiểu các thông điệp gửi đi.

Để làm vậy, bạn có thể so sánh giá trị của usernameFragment với usernameFragment hiện tại đang được sử dụng cho kết nối sau khi nhận candidate từ máy chủ báo hiệu và trước khi gọi addIceCandidate() để thêm nó vào tập hợp các candidate có thể.

Khi ứng dụng web nhận được thông điệp từ máy chủ báo hiệu bao gồm một candidate cần được thêm vào RTCPeerConnection, bạn có thể (và thường nên) gọi addIceCandidate(). Thường không cần phải tự lọc candidate.

Tuy nhiên, hãy tưởng tượng chúng ta cần tối thiểu hóa lưu lượng. Hàm bên dưới, ssNewCandidate(), được gọi khi một thông điệp, signalMsg, đến từ máy chủ báo hiệu chứa một ICE candidate cần được thêm vào RTCPeerConnection. Để tránh bao gồm các candidate đã lỗi thời do ICE restart, chúng ta có thể sử dụng mã như thế này:

const ssNewCandidate = (signalMsg) => {
  const candidate = new RTCIceCandidate(signalMsg.candidate);
  const receivers = pc.getReceivers();

  for (const receiver of receivers) {
    const parameters = receiver.transport.iceTransport.getRemoteParameters();

    if (parameters.usernameFragment === candidate.usernameFragment) {
      return;
    }
  }

  pc.addIceCandidate(candidate).catch(window.reportError);
};

Hàm này duyệt qua danh sách các đối tượng RTCRtpReceiver đang được dùng để nhận dữ liệu ICE, và tìm xem usernameFragment được chỉ ra trong candidate có khớp với bất kỳ đối tượng nào không. Nếu có, ssNewCandidate() sẽ dừng lại. Ngược lại, sau khi kiểm tra mọi receiver, nó thêm candidate mới vào kết nối.

Thông số kỹ thuật

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