RTCIceCandidate: phương thức toJSON()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Phương thức toJSON() của RTCIceCandidate chuyển đổi RTCIceCandidate mà nó được gọi thành JSON.
Một phiên bản được chuỗi hóa của đối tượng có thể được lấy bằng cách gọi stringify() trên đối tượng được trả về.
Cú pháp
toJSON()
Tham số
Không có.
Giá trị trả về
Một đối tượng JSON với các thuộc tính sau, được đặt thành các giá trị tương ứng trong đối tượng RTCIceCandidate:
candidateOptional-
Một chuỗi mô tả thông tin kết nối mạng cho candidate. Thông tin bổ sung có thể được tìm thấy trong
RTCIceCandidate.candidate. sdpMidOptional-
Một chuỗi chứa thẻ định danh của media stream mà candidate được gắn với, hoặc
nullnếu không có media stream được gắn. Thông tin bổ sung có thể được tìm thấy trongRTCIceCandidate.sdpMid. sdpMLineIndexOptional-
Một thuộc tính số chứa chỉ số bắt đầu từ 0 của m-line mà candidate được gắn với, trong SDP của media description, hoặc
nullnếu không có liên kết như vậy. Thông tin bổ sung có thể được tìm thấy trongRTCIceCandidate.sdpMLineIndex. usernameFragmentOptional-
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"). Phân đoạn này, 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). Thông tin bổ sung có thể được tìm thấy trong
RTCIceCandidate.usernameFragment.
Note:
Đối tượng JSON được trả về có cùng hình dạng/thuộc tính như đối tượng candidateInfo có thể được truyền tùy chọn vào constructor RTCIceCandidate() để cấu hình candidate.
Ví dụ
Ví dụ đơn giản này lấy một chuỗi JSON biểu diễn một RTCIceCandidate được tìm thấy trong biến candidate.
let jsonString = candidate.toJSON().stringify();
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicecandidate-tojson |