WebRTC API

Этот перевод не завершён. Пожалуйста, помогите перевести эту статью с английского

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

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

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

Поскольку реализация WebRTC находится в процессе становления и каждый браузер имеет различный уровень поддержки кодеков и WebRTC функций, настоятельно рекомендуется использовать полифил-библиотеку Adapter.js от Google до начала работы над вашим кодом.

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

Для дальнейшего изучения библиотеки Adapter.js, смотрим Улутшаем совместимость, при использовании WebRTC adapter.js.

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

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

Соединение между двумя узлами представлено как объект интерфейса  RTCPeerConnection. Как только соединение установлено и открыто, используя объект RTCPeerConnection, медиапотоки (MediaStreams) и/или каналы данных (RTCDataChannels) могут быть добавлены в соединение.

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

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

more details and links to relevant guides and tutorials needed

WebRTC интерфейсы

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

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

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

RTCPeerConnection
Представляет  WebRTC соединение между локальным компьютером и удаленным узлом. Используется для обработки успешной передачи данных между двумя узлами.
RTCSessionDescription
Представляет параметры сессии. Каждый RTCSessionDescription содержит описания типа, показывающего какую часть (предложение/ответ) процесса переговоров он описывает, и SDP-дескриптор сессии.
RTCIceCandidate
Представляет собой кандидата сервера установки интернет соединения (ICE)  для установленовки соединения RTCPeerConnection.
RTCIceTransport
Представляет информацию о средстве подключения к Интернету (ICE).
RTCPeerConnectionIceEvent
Представляет события, которые происходят в отношении кандидатов ICE, обычно RTCPeerConnection. Один тип передается данному объекту события: icecandidate.
RTCRtpSender
Управляет кродированием и передачей данных через объект типа  MediaStreamTrack для объекта типа RTCPeerConnection.
RTCRtpReceiver
Управляет получением и декодированием данных через объект типа MediaStreamTrack для объекта типа RTCPeerConnection.
RTCTrackEvent
Указывает на то, что новый входящий объект типа  MediaStreamTrack был создан и объект типа RTCRtpReceiver был добавлен в объект  RTCPeerConnection.
RTCCertificate
Представляет сертификат, который использует объект RTCPeerConnection.
RTCDataChannel
Представляет двунапрвленный канал данных между двумя узлами соединения.
RTCDataChannelEvent
Представляет события, которые возникают при присоединении объекта типа  RTCDataChannel к объекту типа RTCPeerConnection. Один тип передается этому событию datachannel.
RTCDTMFSender
Управляет кодированием и передачей  двутональной мультичастотной  (DTMF) сигнализацией для объекта типа RTCPeerConnection.
RTCDTMFToneChangeEvent
Указывает на входящее событие изменение тона двутоновой мультичастотной сигнализации  (DTMF). Это событие не всплывает (если не указано иначе) и не является отменяемым (если не указано иначе).
RTCStatsReport
Ассинхронно сообщает статус для переданного объекта типа  MediaStreamTrack .
RTCIdentityProviderRegistrar
Регистрирует провайдер идентификации (idP).
RTCIdentityProvider
Активирует возможность браузеру запросить создание или проверку обяъвления идентификации.
RTCIdentityAssertion
Представляет идентификатор удаленного узла текущего соединения. Если узел еще не установлен и подтвержден, ссылка на интерфейс вернет null. После установки не изменяется.
RTCIdentityEvent
Представляет объект события объявление идентификатора провайдером идентификации  (idP). Событие объекта типа  RTCPeerConnection. Один тип передается этому событию identityresult.
RTCIdentityErrorEvent
Представляет объект события ошибки, связанной с провайдером идентификации (idP). Событие объекта типа  RTCPeerConnection. Два типа ошибки передаются этому событию : idpassertionerror и idpvalidationerror.

Руководства

Обзор архитектуры WebRTC
Под API, который применяют разработчики, чтобы создавать и использовать WebRTC, расположен набор сетевых протоколов и стандартов соединения. Этот обзор - витрина этих стандартов.
Жизнь WebRTC-сессии
WebRTC позволяет вам организовать соединение в режиме узел-узел для передачи произвольных данных, аудио-, видео-потоков или любую их комбинацию в браузере. В этой статье мы взглянем на жизнь WebRTC-сессии, начиная с установки соединения и пройдем весь путь до его завершения, когда оно больше не нужно.
Обзор WebRTC API
WebRTC состоит из нескольких взаимосвязанных программных интерфейсов (API) и протоколов, которые работают вместе, чтобы обеспечить поддержку обмена данными и медиа-потоками между двумя и более узлами. В этой статье представлен краткий обзор каждого из этих API и какую цель он преследует.
Основы WebRTC
Эта статья проведет вас через создание кросс-браузерного RTC-приложения. К концу этой статьи вы должны иметь работающий дата- и медиа-канал, работающий в режиме точка-точка.
Протоколы WebRTC
В этой статье представлены протоколы, в дополнение к которым создан API WebRTC.
Использование каналов данных в WebRTC
Это руководство описывает как вы можете использовать соединение узел-узел и связанный RTCDataChannel для обмена произвольными данными между двумя узлами.
Взаимосвязи WebRTC
В этой статье описано то, как протоколы, связанные с WebRTC, взаимодействуют друг с другом для того, чтобы создать соединение и передавать данные и/или медиа-потоки между узлами.

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

Увеличение совместимости, используя WebRTC adapter.js
Организация WebRTC  предлагает на GitHub библиотеку adapter.js для решения вопросов совместимости WebRTC реализаций в различных браузерах. Эта библиотека является JavaScript клином, который позволяет писать код, согласно спецификации, так, что бы он просто взял, и заработал во всех браузерах с поддержкой  WebRTC, не смотря на проблемы совместимости браузеров.
Захват кадров с WebRTC
Статья описывает как использовать WebRTC для получения доступа к камере на компьютере или мобильном устройстве с поддержкой  WebRTC, и захват кадров с его помощью.
Простой пример канала данных RTCDataChannel
Интерфейс RTCDataChannel  - это функциональность, которая позволяет открыть канал передачи данных между двумя узлами, по которому можно предавать произвольные данные. Эти API намеренно подобны  WebSocket API, так, что бы в обоих могла использоваться единая модель программирования.
Сигнализация и двухсторонние видео вызовы
Например, мы берем чат на веб сокете, который мы создали в другом примере, и добавляем в него способность создавать видео вызовы. Сервер чата расширяется функциональностью обработки WebRTC сигнализации.

Ресурсы

Протоколы

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

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

WebRTC статистика

Спецификации

Спецификация Статус Комментарий
WebRTC 1.0: Real-time Communication Between Browsers Кандидат в рекомендации The initial definition of the API of WebRTC.
Media Capture and Streams Кандидат в рекомендации The initial definition of the object conveying the stream of media content.
Media Capture from DOM Elements Рабочий черновик The initial definition on how to obtain stream of content from DOM Elements

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