Spec-Zone.ru › Web APIs

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

См. также

  • RTCPeerConnection.setConfiguration()
  • RTCPeerConnection()
  • RTCPeerConnection

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API