RTCPeerConnection: метод getConfiguration()
Базовый Широко доступен
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.
Метод getConfiguration() интерфейса RTCPeerConnection возвращает объект, который указывает текущую конфигурацию RTCPeerConnection, на котором вызван метод.
Возвращаемая конфигурация — это последняя применённая конфигурация через setConfiguration(), или, если setConfiguration() не был вызван, конфигурация, с которой был создан RTCPeerConnection. Конфигурация включает список используемых ICE-серверов, информацию о политиках транспорта и информацию об идентификаторе.
Синтаксис
getConfiguration()
Параметры
Нет.
Возвращаемое значение
Объект, описывающий текущую конфигурацию RTCPeerConnection. Дополнительную информацию о разрешенных параметрах см. в RTCPeerConnection().
Примеры
В этом примере добавляется новый сертификат к активному соединению, если он еще не используется.
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, затем проверяется, есть ли в ней какие-либо установленные сертификаты, проверяя, (а) есть ли в конфигурации значение для certificates, и (б) является ли его длина нулевой.
Если установлено, что сертификатов нет, вызывается RTCPeerConnection.generateCertificate() для создания нового сертификата; мы предоставляем обработчик выполнения, который добавляет новый массив, содержащий только что созданный сертификат, в текущую конфигурацию и передает его в setConfiguration(), чтобы добавить сертификат в соединение.
Спецификации
| Спецификация |
|---|
| WebRTC: Связь в режиме реального времени в браузерах # dom-rtcpeerconnection-getconfiguration |
Совместимость с браузерами
| Рабочий стол | Мобильный | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getConfiguration |
70 | 15 | 22 | 57 | 11 | 70 | 24 | 49 | 11 | 10.0 | 70 |
См. также
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/getConfiguration