RTCPeerConnection：getConfiguration() 方法

getConfiguration() 是 RTCPeerConnection 接口的方法，它返回一个对象，该对象指示调用该方法的 RTCPeerConnection 的当前配置。

返回的配置是通过 setConfiguration() 应用的最后一个配置，或者如果未调用 setConfiguration()，则为 RTCPeerConnection 构造时的配置。该配置包括连接使用的 ICE 服务器列表、有关传输策略的信息以及身份信息。

语法

js
getConfiguration()

参数

此方法不接受任何输入参数。

返回值

一个描述 RTCPeerConnection 当前配置的对象。有关允许哪些选项的更多信息，请参阅 RTCPeerConnection()。

示例

此示例在活动连接中添加新的证书（如果它尚未使用任何证书）。

js
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);
  });
}

此示例获取 RTCPeerConnection 的当前配置，然后检查它是否设置了任何证书，方法是检查 (a) 配置是否具有 certificates 的值，以及 (b) 其长度是否为零。

如果确定未设置任何证书，则调用 RTCPeerConnection.generateCertificate() 创建新证书；我们提供了一个 fulfillment 处理程序，该处理程序将包含一个新创建的证书的新数组添加到当前配置中，并将其传递给 setConfiguration() 以将证书添加到连接中。

规范

规范
WebRTC：浏览器中的实时通信
# dom-rtcpeerconnection-getconfiguration

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅