RTCPeerConnection: peerIdentity 屬性
RTCPeerConnection 介面的只讀屬性 peerIdentity 返回一個 JavaScript Promise，該 Promise 解析為一個 RTCIdentityAssertion 物件，其中包含一個用於標識遠端對等點的字串。一旦此 Promise 成功解析，所得的身份即為目標對等點身份，並且在連線期間無法更改。
值
一個 JavaScript Promise，它解析為一個 RTCIdentityAssertion 物件，該物件描述了遠端對等點的身份。
如果在嘗試驗證傳入的身份斷言（即描述對等點身份的資訊）時發生錯誤，則 Promise 會被拒絕。如果尚無目標對等點身份，則 peerIdentity 會被設定為一個新的 Promise，然後重新開始該過程，直到該過程成功或不再進行身份驗證嘗試。
注意： setRemoteDescription() 返回的 Promise 在已設定的任何目標對等點身份得到驗證之前，無法解析。如果身份尚未得到驗證，則 setRemoteDescription() 返回的 Promise 將被拒絕。如果不存在目標對等點身份，則 setRemoteDescription() 在解析之前無需等待驗證發生。
示例
在此示例中，建立了一個名為 getIdentityAssertion() 的函式，該函式非同步等待對等點的身份得到驗證，然後將該身份返回給呼叫者。如果發生錯誤並且 Promise 被拒絕，則會將錯誤記錄到控制檯，並將 null 返回給呼叫者。
js
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;
}
}
規範
| 規範 |
|---|
| WebRTC 1.0 的身份 # dom-rtcpeerconnection-peeridentity |
瀏覽器相容性
載入中…