RTCPeerConnection: thuộc tính peerIdentity
Thuộc tính chỉ đọc peerIdentity của giao diện RTCPeerConnection trả về một Promise của JavaScript, được giải quyết thành một RTCIdentityAssertion chứa một chuỗi định danh máy ngang hàng từ xa.
Khi promise này được giải quyết thành công, danh tính thu được sẽ là danh tính máy ngang hàng đích và không thể thay đổi trong suốt thời gian kết nối.
Giá trị
Một Promise của JavaScript được giải quyết thành một RTCIdentityAssertion mô tả danh tính của máy ngang hàng từ xa.
Nếu xảy ra lỗi khi cố gắng xác thực một chứng thực danh tính đến (tức là thông tin mô tả danh tính của một máy ngang hàng), promise sẽ bị từ chối.
Nếu chưa có danh tính máy ngang hàng đích, peerIdentity sẽ được đặt thành một promise mới được tạo và quá trình sẽ bắt đầu lại, cho đến khi quá trình thành công hoặc không còn nỗ lực xác thực nào nữa.
Note:
Promise được trả về bởi setRemoteDescription() không thể được giải quyết cho tới khi mọi danh tính máy ngang hàng đích đã được đặt đều được xác thực.
Nếu danh tính chưa được xác thực, promise do setRemoteDescription() trả về sẽ bị từ chối.
Nếu không có danh tính máy ngang hàng đích, setRemoteDescription() không cần đợi việc xác thực xảy ra trước khi được giải quyết.
Ví dụ
Trong ví dụ này, một hàm getIdentityAssertion() được tạo để chờ bất đồng bộ cho tới khi danh tính của máy ngang hàng được xác minh, rồi trả về danh tính cho bên gọi.
Nếu xảy ra lỗi và promise bị từ chối, mã sẽ ghi lỗi ra console và trả về null cho bên gọi.
let pc = new RTCPeerConnection();
// …
async function getIdentityAssertion(pc) {
try {
const identity = await pc.peerIdentity;
return identity;
} catch (err) {
console.log("Error identifying remote peer: ", err);
return null;
}
}
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Identity for WebRTC 1.0 # dom-rtcpeerconnection-peeridentity |