RTCPeerConnection: phương thức getConfiguration()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.
Phương thức getConfiguration() của giao diện RTCPeerConnection trả về một đối tượng cho biết cấu hình hiện tại của RTCPeerConnection mà phương thức được gọi trên đó.
Cấu hình trả về là cấu hình cuối cùng được áp dụng qua setConfiguration(), hoặc nếu setConfiguration() chưa được gọi, thì là cấu hình mà RTCPeerConnection đã được tạo với.
Cấu hình bao gồm danh sách các máy chủ ICE được kết nối sử dụng, thông tin về chính sách truyền tải và thông tin danh tính.
Cú pháp
getConfiguration()
Tham số
Không có.
Giá trị trả về
Một đối tượng mô tả cấu hình hiện tại của RTCPeerConnection.
Xem RTCPeerConnection() để biết thêm thông tin về các tùy chọn được phép.
Ví dụ
Ví dụ này thêm một chứng chỉ mới vào một kết nối đang hoạt động nếu nó chưa có chứng chỉ nào đang dùng.
let configuration = myPeerConnection.getConfiguration();
if (configuration.certificates?.length === 0) {
RTCPeerConnection.generateCertificate({
name: "RSASSA-PKCS1-v1_5",
hash: "SHA-256",
modulusLength: 2048,
publicExponent: new Uint8Array([1, 0, 1]),
}).then((cert) => {
configuration.certificates = [cert];
myPeerConnection.setConfiguration(configuration);
});
}
Ví dụ này lấy cấu hình hiện tại của RTCPeerConnection, rồi kiểm tra xem nó có chứng chỉ nào được đặt hay không bằng cách xem liệu cấu hình có giá trị cho certificates hay không, và độ dài của nó có bằng 0 hay không.
Nếu xác định rằng không có chứng chỉ nào, RTCPeerConnection.generateCertificate() sẽ được gọi để tạo chứng chỉ mới; chúng ta cung cấp một trình xử lý hoàn tất sẽ thêm một mảng mới chứa chứng chỉ vừa tạo vào cấu hình hiện tại và truyền nó cho setConfiguration() để thêm chứng chỉ vào kết nối.
Thông số kỹ thuật
| Specification |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcpeerconnection-getconfiguration |