WebRTC API
==========

**WebRTC** (Web Real-Time Communications) - это технология, которая позволяет Web-приложениям и сайтам захватывать и выборочно передавать аудио и/или видео медиа-потоки, а также обмениваться произвольными данными между браузерами, без обязательного использования посредников. Набор стандартов, которые включает в себя технология WebRTC, позволяет обмениваться данными и проводить пиринговые телеконференции, без необходимости пользователю устанавливать плагины или любое другое стороннее программное обеспечение.

WebRTC состоит из нескольких взаимосвязанных программных интерфейсов (API) и протоколов, которые работают вместе. Документация, которую вы здесь найдёте, поможет вам понять основы WebRTC, как настроить и использовать соединение для передачи данных и медиа-потока, и многое другое.

Понятия и использование WebRTC
------------------------------

WebRTC является многоцелевым и вместе с Media Capture and Streams API (en-US), предоставляют мощные мультимедийные возможности для Web, включая поддержку аудио и видео конференций, обмен файлами, захват экрана, управление идентификацией и взаимодействие с устаревшими телефонными системами, включая поддержку передачи сигналов тонового набора DTMF (en-US). Соединения между узлами могут создаваться без использования специальных драйверов или плагинов, и часто без промежуточных сервисов.

Соединение между двумя узлами представлено как объект интерфейса `RTCPeerConnection`. Как только соединение установлено и открыто, используя объект `RTCPeerConnection`, медиапотоки (`MediaStream`s) и/или каналы данных (`RTCDataChannel` (en-US)s) могут быть добавлены в соединение.

Медиа потоки могут состоять из любого количества треков (дорожек) медиаинформации. Эти треки, представлены объектами интерфейса `MediaStreamTrack` , и могут содержать один или несколько типов медиаданных, включая аудио, видео, текст (такие как субтитры или название глав). Большинство потоков состоят, как минимум, только из одного аудио трека (одной аудио дорожки), или видео дорожки, и могут быть отправлены и получены, как потоки (медиаданные в настоящим времени) или сохранены в файл.

Так же, можно использовать соединение между двумя узлами для обмена произвольными данными, используя объект интерфейса `RTCDataChannel` (en-US), что может быть использовано для передачи служебной информации, биржевых данных , пакетов игровых статусов, передача файлов или закрытых каналов передачи данных.

### Совместимость

В целом WebRTC хорошо поддерживается современными браузерами, но некоторые проблемы всё же есть. Библиотека adapter.js позволяет приложениям избавиться от проблем несовместимости.

WebRTC интерфейсы
-----------------

По причине того, что WebRTC предоставляет интерфейсы, работающие совместно для выполнения различных задач, мы разделили их на категории. Смотрите алфавитный указатель боковой панели для быстрой навигации.

### Настройка соединения и управление

Эти интерфейсы используются для настройки, открытия и управлением WebRTC соединениями. Они представляют одноуровневые медиа соединения, каналы данных, и интерфейсы, использующиеся при обмене информацией о возможностях каждого узла, для выбора наилучшей конфигурации при установки двустороннего мультимедийного соединения.

`RTCPeerConnection`

Представляет WebRTC соединение между локальным компьютером и удалённым узлом. Используется для обработки успешной передачи данных между двумя узлами.

`RTCSessionDescription` (en-US)

Представляет параметры сессии. Каждый `RTCSessionDescription` содержит описания типа (en-US), показывающего какую часть (предложение/ответ) процесса переговоров он описывает, и SDP-дескриптор сессии`.`

`RTCIceCandidate` (en-US)

Представляет собой кандидата сервера установки интернет соединения (ICE) для установления соединения `RTCPeerConnection`.

`RTCIceTransport` (en-US)

Представляет информацию о средстве подключения к Интернету (ICE).

`RTCPeerConnectionIceEvent` (en-US)

Представляет события, которые происходят в отношении кандидатов ICE, обычно `RTCPeerConnection`. Один тип передаётся данному объекту события: `icecandidate`.

`RTCRtpSender` (en-US)

Управляет кодированием и передачей данных через объект типа `MediaStreamTrack` для объекта типа `RTCPeerConnection`.

`RTCRtpReceiver` (en-US)

Управляет получением и декодированием данных через объект типа `MediaStreamTrack` для объекта типа `RTCPeerConnection`.

`RTCTrackEvent` (en-US)

Указывает на то, что новый входящий объект типа `MediaStreamTrack` был создан и объект типа `RTCRtpReceiver` (en-US) был добавлен в объект `RTCPeerConnection`.

`RTCCertificate` (en-US)

Представляет сертификат, который использует объект `RTCPeerConnection`.

`RTCDataChannel` (en-US)

Представляет двунаправленный канал данных между двумя узлами соединения.

`RTCDataChannelEvent` (en-US)

Представляет события, которые возникают при присоединении объекта типа `RTCDataChannel` (en-US) к объекту типа `RTCPeerConnection`. Один тип передаётся этому событию `datachannel`.

`RTCDTMFSender` (en-US)

Управляет кодированием и передачей двухтональной мультичастотной (DTMF) сигнализацией для объекта типа `RTCPeerConnection`.

`RTCDTMFToneChangeEvent` (en-US)

Указывает на входящее событие изменение тона двутоновой мультичастотной сигнализации (DTMF). Это событие не всплывает (если не указано иначе) и не является отменяемым (если не указано иначе).

`RTCStatsReport` (en-US)

Асинхронно сообщает статус для переданного объекта типа `MediaStreamTrack` .

`RTCIdentityProviderRegistrar`

Регистрирует провайдер идентификации (idP).

`RTCIdentityProvider`

Активирует возможность браузеру запросить создание или проверку объявления идентификации.

`RTCIdentityAssertion` (en-US)

Представляет идентификатор удалённого узла текущего соединения. Если узел ещё не установлен и подтверждён, ссылка на интерфейс вернёт `null`. После установки не изменяется.

`RTCIdentityEvent`

Представляет объект события объявление идентификатора провайдером идентификации (idP). Событие объекта типа `RTCPeerConnection`. Один тип передаётся этому событию `identityresult`.

`RTCIdentityErrorEvent`

Представляет объект события ошибки, связанной с провайдером идентификации (idP). Событие объекта типа `RTCPeerConnection`. Два типа ошибки передаются этому событию : `idpassertionerror` и `idpvalidationerror`.

Руководства
-----------

Обзор архитектуры WebRTC (en-US)

Под API, который применяют разработчики, чтобы создавать и использовать WebRTC, расположен набор сетевых протоколов и стандартов соединения. Этот обзор - витрина этих стандартов.

Жизнь WebRTC-сессии

WebRTC позволяет вам организовать соединение в режиме узел-узел для передачи произвольных данных, аудио-, видео-потоков или любую их комбинацию в браузере. В этой статье мы взглянем на жизнь WebRTC-сессии, начиная с установки соединения и пройдём весь путь до его завершения, когда оно больше не нужно.

Обзор WebRTC API (en-US)

WebRTC состоит из нескольких взаимосвязанных программных интерфейсов (API) и протоколов, которые работают вместе, чтобы обеспечить поддержку обмена данными и медиа-потоками между двумя и более узлами. В этой статье представлен краткий обзор каждого из этих API и какую цель он преследует.

Основы WebRTC (en-US)

Эта статья проведёт вас через создание кросс-браузерного RTC-приложения. К концу этой статьи вы должны иметь работающий дата- и медиа-канал, работающий в режиме точка-точка.

Протоколы WebRTC

В этой статье представлены протоколы, в дополнение к которым создан API WebRTC.

Использование каналов данных в WebRTC

Это руководство описывает как вы можете использовать соединение узел-узел и связанный `RTCDataChannel` (en-US) для обмена произвольными данными между двумя узлами.

Взаимосвязи WebRTC

В этой статье описано то, как протоколы, связанные с WebRTC, взаимодействуют друг с другом для того, чтобы создать соединение и передавать данные и/или медиа-потоки между узлами.

Учебные материалы
-----------------

Увеличение совместимости, используя WebRTC adapter.js

Организация WebRTC предлагает на GitHub библиотеку adapter.js для решения вопросов совместимости WebRTC реализаций в различных браузерах. Эта библиотека является JavaScript клином, который позволяет писать код, согласно спецификации, так, что бы он просто взял, и заработал во всех браузерах с поддержкой WebRTC, не смотря на проблемы совместимости браузеров.

Захват кадров с WebRTC

Статья описывает как использовать WebRTC для получения доступа к камере на компьютере или мобильном устройстве с поддержкой WebRTC, и захват кадров с его помощью.

Простой пример канала данных RTCDataChannel

Интерфейс `RTCDataChannel` (en-US) - это функциональность, которая позволяет открыть канал передачи данных между двумя узлами, по которому можно предавать произвольные данные. Эти API намеренно подобны WebSocket API (en-US), так, что бы в обоих могла использоваться единая модель программирования.

Сигнализация и двухсторонние видео вызовы

Например, мы берём чат на веб сокете, который мы создали в другом примере, и добавляем в него способность создавать видео вызовы. Сервер чата расширяется функциональностью обработки WebRTC сигнализации.

Ресурсы
-------

### Протоколы

#### WebRTC- текущие протоколы

* Протокол согласования соединения для Web RTC
* WebRTC Аудио кодек и требования к обработке
* RTCWeb Каналы данных
* RTCWeb Протокол канала данных
* Связь в реальном времени (WebRTC): Медиа транспорт и использование RTP
* WebRTC Безопасная архитектура
* Транспорты для RTCWEB

#### Связанные поддерживающие протоколы

* Установка интерактивной связи (ICE): Протокол обхода транслятора сетевых адресов (NAT) при доставки объектов Offer/Answer
* Сети обхода NAT (STUN)
* Схема URI для протокола сетей обхода NAT (STUN)
* Traversal Using Relays around NAT (TURN) Uniform Resource Identifiers
* An Offer/Answer Model with Session Description Protocol (SDP)
* Session Traversal Utilities for NAT (STUN) Extension for Third Party Authorization

#### WebRTC статистика

* WebRTC Statistics API
Спецификации
------------

| Specification |
| --- |
| WebRTC: Real-Time Communication Between Browsers |
| Media Capture and Streams |
| Media Capture from DOM Elements |

В дополнение к этим спецификациям, определяющим API, необходимый для использования WebRTC, имеется несколько протоколов, перечисленных в разделе ресурсы.

Смотрите также
--------------

* `MediaDevices`
* `MediaStreamEvent` (en-US)
* `MediaStreamConstraints` (en-US)
* `MediaStreamTrack`
* `MessageEvent` (en-US)
* `MediaStream`
* Firefox multistream and renegotiation for Jitsi Videobridge
* Peering Through the WebRTC Fog with SocketPeer
* Inside the Party Bus: Building a Web App with Multiple Live Video Streams + Interactive Graphics