RTCPeerConnection.peerIdentity

只读属性 RTCPeerConnection peerIdentity ，返回Promise 对象，成功时返回 RTCIdentityAssertion ，该结构 DOMString 标识了远端的 ID。这个身份标识在连接过程中将不会改变（直到连接结束）.

值

一个 JavaScript Promise，会被兑现为描述远程对等方身份的 RTCIdentityAssertion。

当验证远程的身份 ID 出错时，promise 将返回拒绝。如果目标节点身份不存在，peerIdentity 将被设为一个 promise 对象，并重启验证过程（一个断言）, 直到成功或者不再想继续。

备注： setRemoteDescription() 返回的 promise 将不会成功返回，除非目标节点身份信息可用。如不可用，则setRemoteDescription() 将被拒绝。若无目标节点 ID，就不不需要等setRemoteDescription() 这个返回验证成功了。

示例

本示例创建了一个 getIdentityAssertion() 函数，该函数异步等待对等方的身份得到验证，然后将其身份返回给调用者。如果发生错误且 promise 被拒绝，则将错误记录到控制台并将 null 返回给调用者。

let pc = new RTCPeerConnection();

// …

async function getIdentityAssertion(pc) {
  try {
    const identity = await pc.peerIdentity;
    return identity;
  } catch (err) {
    console.log("验证远程对等方的身份时出现错误：", err);
    return null;
  }
}

规范

Specification
Identity for WebRTC 1.0 # dom-rtcpeerconnection-peeridentity

浏览器兼容性

BCD tables only load in the browser

参见

WebRTC API