1. Введение
WebRTC – это проект с открытым исходным кодом, который позволяет передавать аудио, видео и данные в реальном времени в веб-приложениях и нативных приложениях.
В WebRTC есть несколько API JavaScript. Нажмите на ссылки, чтобы посмотреть демонстрации.
getUserMedia()– запись аудио и видео.MediaRecorder– запись аудио и видео.RTCPeerConnection– передача аудио и видео между пользователями.RTCDataChannel– передача данных между пользователями.
Где можно использовать WebRTC?
В Firefox, Opera и Chrome на компьютерах и устройствах Android. Технология WebRTC также доступна для нативных приложений на iOS и Android.
Что такое сигнализация?
WebRTC использует RTCPeerConnection для передачи потоковых данных между браузерами, но ему также нужен механизм для координации связи и отправки управляющих сообщений – процесс, известный как сигнализация. Методы и протоколы сигнализации не определены WebRTC. В этой практической работе вы будете использовать Socket.IO для обмена сообщениями, но есть и другие варианты.
Что такое STUN и TURN?
Технология WebRTC предназначена для одноранговых сетей, поэтому пользователи могут подключаться по наиболее прямому маршруту. Однако WebRTC создана для работы в реальных сетях: клиентским приложениям необходимо проходить через шлюзы NAT и брандмауэры, а одноранговым сетям нужны резервные варианты на случай сбоя прямого подключения. В рамках этого процесса API WebRTC используют серверы STUN, чтобы получить IP-адрес вашего компьютера, и серверы TURN, которые выполняют роль ретрансляторов, если одноранговое соединение не удается установить. Подробнее об этом рассказывается в статье WebRTC in the real world (на английском языке).
Безопасен ли WebRTC?
Шифрование обязательно для всех компонентов WebRTC, а его API JavaScript можно использовать только из безопасных источников (HTTPS или localhost). Механизмы сигнализации не определены стандартами WebRTC, поэтому вы должны самостоятельно обеспечить использование защищенных протоколов.
2. Обзор
Создайте приложение, которое будет получать видео и делать снимки с помощью веб-камеры, а затем передавать их по одноранговой сети с использованием WebRTC. Вы узнаете, как использовать основные API WebRTC и настроить сервер обмена сообщениями с помощью Node.js.
Что вы узнаете
- Как получить видео с веб-камеры
- Потоковая передача видео с помощью RTCPeerConnection
- Передача данных с помощью RTCDataChannel
- Настройте службу сигнализации для обмена сообщениями
- Объединение однорангового подключения и сигнализации
- Как сделать снимок и передать его по каналу данных
Что вам понадобится
- Chrome 47 или более поздней версии;
- Web Server for Chrome или другой веб-сервер по вашему выбору.
- Образец кода
- Текстовый редактор.
- Базовые знания HTML, CSS и JavaScript.
3. Получите образец кода
Скачайте код
Если вы знакомы с git, вы можете скачать код для этой практической работы с GitHub, клонировав его:
git clone https://github.com/googlecodelabs/webrtc-web
Вы также можете скачать ZIP-файл с кодом, нажав кнопку ниже.
Откройте скачанный ZIP-файл. Будет распакована папка проекта (adaptive-web-media), в которой есть папки для каждого шага этой практической работы и все необходимые ресурсы.
Вы будете работать с кодом в каталоге work.
Папки step-nn содержат готовые версии для каждого шага этой практической работы. Они приведены для справки.
Установите и проверьте веб-сервер
Вы можете использовать собственный веб-сервер, но эта практическая работа рассчитана на работу с Chrome Web Server. Если у вас нет этого приложения, установите его из интернет-магазина Chrome.

После установки приложения Web Server for Chrome нажмите на ярлык "Приложения Chrome" на панели закладок, странице быстрого доступа или панели запуска приложений.

Нажмите на значок веб-сервера.

Затем вы увидите диалоговое окно, в котором можно настроить локальный веб-сервер:

Нажмите кнопку Выбрать папку и выберите только что созданную папку work. Это позволит вам просматривать результаты своей работы в Chrome, используя URL, выделенный в диалоговом окне Web Server в разделе Web Server URL(s) (URL веб-сервера).
В разделе Параметры установите флажок Автоматически показывать index.html, как показано ниже.

Затем остановите и перезапустите сервер, переместив переключатель Web Server: STARTED (Веб-сервер: ЗАПУЩЕН) влево, а затем обратно вправо.

Теперь перейдите на рабочий сайт в браузере, нажав на выделенный URL веб-сервера. Вы должны увидеть страницу, которая выглядит следующим образом и соответствует work/index.html:

Пока это приложение не делает ничего интересного. Это просто минимальный каркас, который мы используем, чтобы убедиться, что веб-сервер работает правильно. Функции и элементы макета вы добавите на следующих шагах.
4. Как транслировать видео с веб-камеры
Что вы узнаете
На этом шаге вы узнаете, как:
- Получите видеопоток с веб-камеры.
- Управлять воспроизведением трансляции.
- Используйте CSS и SVG для управления видео.
Полная версия этого шага находится в папке step-01.
Немного HTML…
Добавьте элементы video и script в файл index.html в каталоге work:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<video autoplay playsinline></video>
<script src="js/main.js"></script>
</body>
</html>
…и немного JavaScript.
Добавьте в файл main.js в папке js следующий код:
'use strict';
// On this codelab, you will be streaming only video (video: true).
const mediaStreamConstraints = {
video: true,
};
// Video element where stream will be placed.
const localVideo = document.querySelector('video');
// Local stream that will be reproduced on the video.
let localStream;
// Handles success by adding the MediaStream to the video element.
function gotLocalMediaStream(mediaStream) {
localStream = mediaStream;
localVideo.srcObject = mediaStream;
}
// Handles error by logging a message to the console with the error message.
function handleLocalMediaStreamError(error) {
console.log('navigator.getUserMedia error: ', error);
}
// Initializes media stream.
navigator.mediaDevices.getUserMedia(mediaStreamConstraints)
.then(gotLocalMediaStream).catch(handleLocalMediaStreamError);
Попробовать
Откройте файл index.html в браузере. Вы должны увидеть что-то похожее на изображение ниже (конечно, с изображением с вашей веб-камеры).

Принцип работы
После вызова getUserMedia() браузер запрашивает у пользователя разрешение на доступ к камере (если это первый запрос доступа к камере для текущего источника). В случае успеха возвращается MediaStream, который может использоваться медиаэлементом с помощью атрибута srcObject:
navigator.mediaDevices.getUserMedia(mediaStreamConstraints)
.then(gotLocalMediaStream).catch(handleLocalMediaStreamError);
}
function gotLocalMediaStream(mediaStream) {
localVideo.srcObject = mediaStream;
}
Аргумент constraints позволяет указать, какие медиафайлы нужно получить. В этом примере – только видео, поскольку аудио по умолчанию отключено:
const mediaStreamConstraints = {
video: true,
};
Вы можете использовать ограничения для дополнительных требований, например разрешения видео:
const hdConstraints = {
video: {
width: {
min: 1280
},
height: {
min: 720
}
}
}
В спецификации MediaTrackConstraints перечислены все возможные типы ограничений, но не все они поддерживаются в разных браузерах. Если выбранная камера не поддерживает запрошенное разрешение, метод getUserMedia() будет отклонен с ошибкой OverconstrainedError, а пользователю не будет предложено предоставить разрешение на доступ к камере.
Если метод getUserMedia() выполняется успешно, видеопоток с веб-камеры устанавливается в качестве источника видеоэлемента:
function gotLocalMediaStream(mediaStream) {
localVideo.srcObject = mediaStream;
}
Бонусные баллы
- Объект
localStream, переданный вgetUserMedia(), находится в глобальной области видимости, поэтому вы можете проверить его в консоли браузера. Для этого откройте консоль, введите stream и нажмите клавишу Ввод. Чтобы открыть консоль в Chrome, нажмите Ctrl + Shift + J (в Windows) или Command + Option + J (в macOS). - Что возвращает
localStream.getVideoTracks()? - Попробуйте позвонить по номеру
localStream.getVideoTracks()[0].stop(). - Посмотрите на объект constraints: что произойдет, если изменить его на
{audio: true, video: true}? - Каков размер видеоэлемента? Как получить естественный размер видео из JavaScript, в отличие от размера экрана? Для проверки используйте инструменты разработчика в Chrome.
- Попробуйте добавить фильтры CSS к элементу видео. Пример:
video {
filter: blur(4px) invert(1) opacity(0.5);
}
- Попробуйте добавить фильтры SVG. Пример:
video {
filter: hue-rotate(180deg) saturate(200%);
}
Что вы узнали
На этом шаге вы узнали:
- Получать видео с веб-камеры.
- Задайте ограничения для медиаконтента.
- Изменить элемент видео.
Полная версия этого шага находится в папке step-01.
Советы
- Не забудьте добавить атрибут
autoplayв элементvideo. Без этого вы увидите только один кадр. - Для
getUserMedia()доступно множество других ограничений. Посмотрите демонстрацию на странице webrtc.github.io/samples/src/content/peerconnection/constraints. На этом сайте вы найдете множество интересных примеров использования WebRTC.
Совет
- Убедитесь, что элемент видео не выходит за пределы контейнера. Мы добавили
widthиmax-width, чтобы задать предпочтительный и максимальный размер видео. Браузер рассчитает высоту автоматически:
video {
max-width: 100%;
width: 320px;
}
Далее
У вас есть видео, но как его транслировать? Узнайте об этом на следующем шаге.
5. Потоковая передача видео с помощью RTCPeerConnection
Что вы узнаете
На этом шаге вы узнаете, как:
- Устраните различия между браузерами с помощью прослойки WebRTC – adapter.js.
- Используйте RTCPeerConnection API для потоковой передачи видео.
- Управление записью и трансляцией медиаконтента.
Полная версия этого шага находится в папке step-2.
Что такое RTCPeerConnection?
RTCPeerConnection – это API для совершения вызовов WebRTC с целью потоковой передачи видео и аудио, а также обмена данными.
В этом примере настраивается подключение между двумя объектами RTCPeerConnection (одноранговыми узлами) на одной странице.
Это не очень полезно на практике, но помогает понять, как работает RTCPeerConnection.
Как добавить элементы видео и кнопки управления
В файле index.html замените один элемент видео двумя элементами видео и тремя кнопками:
<video id="localVideo" autoplay playsinline></video>
<video id="remoteVideo" autoplay playsinline></video>
<div>
<button id="startButton">Start</button>
<button id="callButton">Call</button>
<button id="hangupButton">Hang Up</button>
</div>
Один видеоэлемент будет показывать поток из getUserMedia(), а другой – то же видео, передаваемое с помощью RTCPeerconnection. (В реальном приложении один элемент видео будет отображать локальный поток, а другой – удаленный.)
Добавьте shim-файл adapter.js
Добавьте ссылку на текущую версию adapter.js над ссылкой на main.js:
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
Теперь файл Index.html должен выглядеть так:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<video id="localVideo" autoplay playsinline></video>
<video id="remoteVideo" autoplay playsinline></video>
<div>
<button id="startButton">Start</button>
<button id="callButton">Call</button>
<button id="hangupButton">Hang Up</button>
</div>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="js/main.js"></script>
</body>
</html>
Установите код RTCPeerConnection
Замените файл main.js версией из папки step-02.
Позвонить
Откройте файл index.html, нажмите кнопку Start (Начать), чтобы получить видео с веб-камеры, и нажмите Call (Вызов), чтобы установить одноранговое соединение. В обоих элементах должно показываться одно и то же видео (с вашей веб-камеры). Чтобы посмотреть журнал WebRTC, откройте консоль браузера.
Принцип работы
Этот шаг делает многое...
WebRTC использует RTCPeerConnection API для настройки подключения и передачи видео между клиентами WebRTC, которые называются одноранговыми узлами.
В этом примере два объекта RTCPeerConnection находятся на одной странице: pc1 и pc2. Оно не имеет практического применения, но хорошо демонстрирует работу API.
Чтобы настроить звонок между одноранговыми узлами WebRTC, нужно выполнить три задачи:
- Создайте RTCPeerConnection для каждого конца вызова и на каждом конце добавьте локальный поток из
getUserMedia(). - Получение и передача информации о сети. Потенциальные конечные точки подключения называются кандидатами ICE.
- Получение и передача локальных и удаленных описаний – метаданных о локальных медиафайлах в формате SDP.
Представьте, что Алиса и Боб хотят использовать RTCPeerConnection для настройки видеочата.
Сначала Алиса и Иван обмениваются сетевой информацией. Выражение "поиск кандидатов" относится к процессу поиска сетевых интерфейсов и портов с помощью фреймворка ICE.
- Алиса создает объект RTCPeerConnection с обработчиком
onicecandidate (addEventListener('icecandidate')). Это соответствует следующему коду из файла main.js:
let localPeerConnection;
localPeerConnection = new RTCPeerConnection(servers);
localPeerConnection.addEventListener('icecandidate', handleConnection);
localPeerConnection.addEventListener(
'iceconnectionstatechange', handleConnectionChange);
- Алиса вызывает
getUserMedia()и добавляет поток, переданный в этот метод:
navigator.mediaDevices.getUserMedia(mediaStreamConstraints).
then(gotLocalMediaStream).
catch(handleLocalMediaStreamError);
function gotLocalMediaStream(mediaStream) {
localVideo.srcObject = mediaStream;
localStream = mediaStream;
trace('Received local stream.');
callButton.disabled = false; // Enable call button.
}
localPeerConnection.addStream(localStream);
trace('Added local stream to localPeerConnection.');
- Обработчик
onicecandidateиз шага 1 вызывается, когда становятся доступны кандидаты сети. - Алиса отправляет сериализованные данные кандидата Бобу. В реальном приложении этот процесс (известный как сигнализация) происходит с использованием службы обмена сообщениями. Вы узнаете, как это сделать, на следующем шаге. Конечно, на этом этапе два объекта RTCPeerConnection находятся на одной странице и могут взаимодействовать напрямую без необходимости во внешнем обмене сообщениями.
- Когда Боб получает сообщение от Алисы, он вызывает
addIceCandidate(), чтобы добавить кандидата в описание удаленного узла:
function handleConnection(event) {
const peerConnection = event.target;
const iceCandidate = event.candidate;
if (iceCandidate) {
const newIceCandidate = new RTCIceCandidate(iceCandidate);
const otherPeer = getOtherPeer(peerConnection);
otherPeer.addIceCandidate(newIceCandidate)
.then(() => {
handleConnectionSuccess(peerConnection);
}).catch((error) => {
handleConnectionFailure(peerConnection, error);
});
trace(`${getPeerName(peerConnection)} ICE candidate:\n` +
`${event.candidate.candidate}.`);
}
}
Кроме того, одноранговым узлам WebRTC необходимо находить и обмениваться информацией о локальных и удаленных аудио- и видеоданных, например о разрешении и возможностях кодека. Сигнализация для обмена информацией о конфигурации медиаданных выполняется путем обмена блоками метаданных, известными как предложение и ответ, с использованием формата протокола описания сеанса, известного как SDP:
- Алиса запускает метод RTCPeerConnection
createOffer(). Возвращенный объект Promise предоставляет RTCSessionDescription – описание локального сеанса Алисы:
trace('localPeerConnection createOffer start.');
localPeerConnection.createOffer(offerOptions)
.then(createdOffer).catch(setSessionDescriptionError);
- Если все прошло успешно, Алиса задает локальное описание с помощью
setLocalDescription(), а затем отправляет его Бобу по каналу сигнализации. - Борис устанавливает описание, отправленное Алисой, в качестве удаленного описания с помощью
setRemoteDescription(). - Боб запускает метод RTCPeerConnection
createAnswer(), передавая ему удаленное описание, полученное от Алисы, чтобы можно было сгенерировать локальный сеанс, совместимый с ее сеансом. ПромисcreateAnswer()передает RTCSessionDescription: Борис устанавливает его в качестве локального описания и отправляет Алисе. - Когда Алиса получает описание сеанса Боба, она устанавливает его в качестве удаленного описания с помощью
setRemoteDescription().
// Logs offer creation and sets peer connection session descriptions.
function createdOffer(description) {
trace(`Offer from localPeerConnection:\n${description.sdp}`);
trace('localPeerConnection setLocalDescription start.');
localPeerConnection.setLocalDescription(description)
.then(() => {
setLocalDescriptionSuccess(localPeerConnection);
}).catch(setSessionDescriptionError);
trace('remotePeerConnection setRemoteDescription start.');
remotePeerConnection.setRemoteDescription(description)
.then(() => {
setRemoteDescriptionSuccess(remotePeerConnection);
}).catch(setSessionDescriptionError);
trace('remotePeerConnection createAnswer start.');
remotePeerConnection.createAnswer()
.then(createdAnswer)
.catch(setSessionDescriptionError);
}
// Logs answer to offer creation and sets peer connection session descriptions.
function createdAnswer(description) {
trace(`Answer from remotePeerConnection:\n${description.sdp}.`);
trace('remotePeerConnection setLocalDescription start.');
remotePeerConnection.setLocalDescription(description)
.then(() => {
setLocalDescriptionSuccess(remotePeerConnection);
}).catch(setSessionDescriptionError);
trace('localPeerConnection setRemoteDescription start.');
localPeerConnection.setRemoteDescription(description)
.then(() => {
setRemoteDescriptionSuccess(localPeerConnection);
}).catch(setSessionDescriptionError);
}
- Пинг!
Бонусные баллы
- Откройте страницу chrome://webrtc-internals. Это позволяет получать статистику WebRTC и данные отладки. Полный список URL Chrome можно найти на странице chrome://about.
- Настройте стиль страницы с помощью CSS:
- Расположите видео рядом.
- Сделайте кнопки одинаковой ширины и увеличьте размер текста.
- Убедитесь, что макет подходит для мобильных устройств.
- В консоли инструментов разработчика в Chrome посмотрите на
localStream,localPeerConnectionиremotePeerConnection. - В консоли найдите
localPeerConnectionpc1.localDescription. Как выглядит формат SDP?
Что вы узнали
На этом шаге вы узнали, как:
- Устраните различия между браузерами с помощью прослойки WebRTC – adapter.js.
- Используйте RTCPeerConnection API для потоковой передачи видео.
- Управление записью и трансляцией медиаконтента.
- Обмен медиаданными и информацией о сети между узлами для совершения вызова WebRTC.
Полная версия этого шага находится в папке step-2.
Советы
- На этом этапе нужно многому научиться! Дополнительную информацию об RTCPeerConnection можно найти на сайте webrtc.org. На этой странице вы найдете рекомендации по фреймворкам JavaScript, которые можно использовать, если вы хотите работать с WebRTC, но не хотите разбираться с API.
- Дополнительную информацию о shim-файле adapter.js можно найти в репозитории adapter.js на GitHub.
- Хотите узнать, как выглядит лучшее в мире приложение для видеочата? Ознакомьтесь с AppRTC – каноническим приложением проекта WebRTC для звонков WebRTC: приложение, код. Время установления вызова составляет менее 500 мс.
Совет
- Чтобы обеспечить совместимость кода с будущими версиями, используйте новые API на основе Promise и включите совместимость с браузерами, которые их не поддерживают, с помощью adapter.js.
Далее
На этом шаге показано, как использовать WebRTC для потоковой передачи видео между узлами, но эта практическая работа также посвящена данным.
На следующем шаге вы узнаете, как передавать произвольные данные с помощью RTCDataChannel.
6. Использовать RTCDataChannel для обмена данными
Что вы узнаете
- Как обмениваться данными между конечными точками WebRTC (одноранговыми узлами).
Полная версия этого шага находится в папке step-03.
Обновите HTML-код
На этом шаге вы будете использовать каналы передачи данных WebRTC для отправки текста между двумя элементами textarea на одной странице. Это не очень полезно, но демонстрирует, как WebRTC можно использовать для обмена данными, а также для потоковой передачи видео.
Удалите элементы видео и кнопки из файла index.html и замените их следующим HTML-кодом:
<textarea id="dataChannelSend" disabled
placeholder="Press Start, enter some text, then press Send."></textarea>
<textarea id="dataChannelReceive" disabled></textarea>
<div id="buttons">
<button id="startButton">Start</button>
<button id="sendButton">Send</button>
<button id="closeButton">Stop</button>
</div>
Одно текстовое поле будет предназначено для ввода текста, а другое будет отображать текст, передаваемый между узлами.
Теперь файл index.html должен выглядеть так:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<textarea id="dataChannelSend" disabled
placeholder="Press Start, enter some text, then press Send."></textarea>
<textarea id="dataChannelReceive" disabled></textarea>
<div id="buttons">
<button id="startButton">Start</button>
<button id="sendButton">Send</button>
<button id="closeButton">Stop</button>
</div>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="js/main.js"></script>
</body>
</html>
Обновите код JavaScript
Замените содержимое файла main.js содержимым файла step-03/js/main.js.
Попробуйте передать данные между узлами: откройте index.html, нажмите Start (Начать), чтобы установить одноранговое соединение, введите текст в поле textarea слева и нажмите Send (Отправить), чтобы передать текст по каналам передачи данных WebRTC.
Принцип работы
Этот код использует RTCPeerConnection и RTCDataChannel для обмена текстовыми сообщениями.
Большая часть кода на этом шаге совпадает с кодом из примера RTCPeerConnection.
Функции sendData() и createConnection() содержат большую часть нового кода:
function createConnection() {
dataChannelSend.placeholder = '';
var servers = null;
pcConstraint = null;
dataConstraint = null;
trace('Using SCTP based data channels');
// For SCTP, reliable and ordered delivery is true by default.
// Add localConnection to global scope to make it visible
// from the browser console.
window.localConnection = localConnection =
new RTCPeerConnection(servers, pcConstraint);
trace('Created local peer connection object localConnection');
sendChannel = localConnection.createDataChannel('sendDataChannel',
dataConstraint);
trace('Created send data channel');
localConnection.onicecandidate = iceCallback1;
sendChannel.onopen = onSendChannelStateChange;
sendChannel.onclose = onSendChannelStateChange;
// Add remoteConnection to global scope to make it visible
// from the browser console.
window.remoteConnection = remoteConnection =
new RTCPeerConnection(servers, pcConstraint);
trace('Created remote peer connection object remoteConnection');
remoteConnection.onicecandidate = iceCallback2;
remoteConnection.ondatachannel = receiveChannelCallback;
localConnection.createOffer().then(
gotDescription1,
onCreateSessionDescriptionError
);
startButton.disabled = true;
closeButton.disabled = false;
}
function sendData() {
var data = dataChannelSend.value;
sendChannel.send(data);
trace('Sent Data: ' + data);
}
Синтаксис RTCDataChannel намеренно похож на WebSocket, с методом send() и событием message.
Обратите внимание на использование dataConstraint. Каналы передачи данных можно настроить так, чтобы они поддерживали разные типы обмена данными, например отдавали приоритет надежности доставки, а не производительности. Дополнительную информацию о параметрах можно найти на сайте Mozilla Developer Network.
Бонусные баллы
- В SCTP, протоколе, используемом каналами передачи данных WebRTC, надежная и упорядоченная доставка данных включена по умолчанию. В каких случаях RTCDataChannel должен обеспечивать надежную доставку данных, а в каких важнее производительность, даже если это означает потерю некоторых данных?
- Используйте CSS, чтобы улучшить макет страницы, и добавьте атрибут плейсхолдера в текстовую область dataChannelReceive.
- Протестируйте страницу на мобильном устройстве.
Что вы узнали
На этом шаге вы узнали, как:
- Устанавливает соединение между двумя одноранговыми узлами WebRTC.
- Обмен текстовыми данными между узлами.
Полная версия этого шага находится в папке step-03.
Подробнее
- Каналы передачи данных WebRTC (статья написана несколько лет назад, но по-прежнему актуальна)
- Почему для канала передачи данных WebRTC был выбран SCTP?
Далее
Вы узнали, как обмениваться данными между узлами на одной странице, но как это сделать между разными машинами? Сначала нужно настроить сигнальный канал для обмена сообщениями с метаданными. Узнайте, как это сделать, на следующем шаге.
7. Настройте службу сигнализации для обмена сообщениями
Что вы узнаете
На этом этапе вы узнаете:
- Используйте
npm, чтобы установить зависимости проекта, указанные в файле package.json. - Запустите сервер Node.js и используйте node-static для обслуживания статических файлов.
- Настройте службу обмена сообщениями на Node.js с помощью Socket.IO.
- Используйте его, чтобы создавать чат-группы и обмениваться сообщениями.
Полная версия этого шага находится в папке step-04.
Основные понятия
Чтобы настроить и поддерживать вызов WebRTC, клиенты WebRTC (одноранговые узлы) должны обмениваться метаданными:
- Информация о кандидате (сети).
- Сообщения Offer и Answer, содержащие информацию о медиаконтенте, например о разрешении и кодеках.
Другими словами, перед началом одноранговой передачи аудио, видео или данных требуется обмен метаданными. Этот процесс называется сигнализацией.
На предыдущих шагах объекты RTCPeerConnection отправителя и получателя находятся на одной странице, поэтому "сигнализация" – это вопрос передачи метаданных между объектами.
В реальном приложении RTCPeerConnection отправителя и получателя работают на веб-страницах на разных устройствах, и вам нужен способ для передачи метаданных.
Для этого используется сервер сигнализации, который может передавать сообщения между клиентами WebRTC (одноранговыми узлами). Сами сообщения представляют собой обычный текст – сериализованные объекты JavaScript.
Предварительное требование: установите Node.js
Чтобы выполнить следующие шаги этой практической работы (папки step-04–step-06), вам нужно будет запустить сервер на локальном хосте с помощью Node.js.
Вы можете скачать и установить Node.js непосредственно с сайта Node.js или с помощью предпочитаемого менеджера пакетов.
После установки вы сможете импортировать зависимости, необходимые для следующих шагов (выполняется npm install), а также запустить небольшой сервер localhost для выполнения практической работы (выполняется node index.js). Эти команды будут указаны позже, когда они потребуются.
О приложении
WebRTC использует клиентский JavaScript API, но для реального использования также требуется сервер сигнализации (обмена сообщениями), а также серверы STUN и TURN. Подробнее об инфраструктуре WebRTC…
На этом этапе вы создадите простой сигнальный сервер Node.js, используя модуль Socket.IO Node.js и библиотеку JavaScript для обмена сообщениями. Опыт работы с Node.js и Socket.IO будет полезен, но не обязателен, так как компоненты обмена сообщениями просты.
В этом примере сервер (приложение Node.js) реализован в файле index.js, а клиент, который на нем работает (веб-приложение), – в файле index.html.
Приложение Node.js на этом этапе выполняет две задачи.
Во-первых, он действует как ретранслятор сообщений:
socket.on('message', function (message) {
log('Got message: ', message);
socket.broadcast.emit('message', message);
});
Во-вторых, он управляет видеочатами WebRTC:
if (numClients === 0) {
socket.join(room);
socket.emit('created', room, socket.id);
} else if (numClients === 1) {
socket.join(room);
socket.emit('joined', room, socket.id);
io.sockets.in(room).emit('ready');
} else { // max two clients
socket.emit('full', room);
}
Наше приложение WebRTC позволит максимум двум одноранговым узлам использовать одну комнату.
HTML и JavaScript
Обновите файл index.html, чтобы он выглядел следующим образом:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<script src="/socket.io/socket.io.js"></script>
<script src="js/main.js"></script>
</body>
</html>
На странице ничего не появится, так как все данные записываются в консоль браузера. Чтобы открыть консоль в Chrome, нажмите Ctrl + Shift + J (в Windows) или Command + Option + J (в macOS).
Замените содержимое файла js/main.js следующим кодом:
'use strict';
var isInitiator;
window.room = prompt("Enter room name:");
var socket = io.connect();
if (room !== "") {
console.log('Message from client: Asking to join room ' + room);
socket.emit('create or join', room);
}
socket.on('created', function(room, clientId) {
isInitiator = true;
});
socket.on('full', function(room) {
console.log('Message from client: Room ' + room + ' is full :^(');
});
socket.on('ipaddr', function(ipaddr) {
console.log('Message from client: Server IP address is ' + ipaddr);
});
socket.on('joined', function(room, clientId) {
isInitiator = false;
});
socket.on('log', function(array) {
console.log.apply(console, array);
});
Как настроить Socket.IO для работы в Node.js
В HTML-файле вы могли заметить, что используется файл Socket.IO:
<script src="/socket.io/socket.io.js"></script>
В корневом каталоге work создайте файл package.json со следующим содержимым:
{
"name": "webrtc-codelab",
"version": "0.0.1",
"description": "WebRTC codelab",
"dependencies": {
"node-static": "^0.7.10",
"socket.io": "^1.2.0"
}
}
Это манифест приложения, который сообщает Node Package Manager (npm), какие зависимости проекта нужно установить.
Чтобы установить зависимости (например, /socket.io/socket.io.js), выполните в терминале командной строки следующую команду в каталоге work:
npm install
Вы должны увидеть журнал установки, который заканчивается примерно так:

Как видите, npm установил зависимости, определенные в package.json.
Создайте файл index.js в корневом каталоге work (не в каталоге js) и добавьте следующий код:
'use strict';
var os = require('os');
var nodeStatic = require('node-static');
var http = require('http');
var socketIO = require('socket.io');
var fileServer = new(nodeStatic.Server)();
var app = http.createServer(function(req, res) {
fileServer.serve(req, res);
}).listen(8080);
var io = socketIO.listen(app);
io.sockets.on('connection', function(socket) {
// convenience function to log server messages on the client
function log() {
var array = ['Message from server:'];
array.push.apply(array, arguments);
socket.emit('log', array);
}
socket.on('message', function(message) {
log('Client said: ', message);
// for a real app, would be room-only (not broadcast)
socket.broadcast.emit('message', message);
});
socket.on('create or join', function(room) {
log('Received request to create or join room ' + room);
var clientsInRoom = io.sockets.adapter.rooms[room];
var numClients = clientsInRoom ? Object.keys(clientsInRoom.sockets).length : 0;
log('Room ' + room + ' now has ' + numClients + ' client(s)');
if (numClients === 0) {
socket.join(room);
log('Client ID ' + socket.id + ' created room ' + room);
socket.emit('created', room, socket.id);
} else if (numClients === 1) {
log('Client ID ' + socket.id + ' joined room ' + room);
io.sockets.in(room).emit('join', room);
socket.join(room);
socket.emit('joined', room, socket.id);
io.sockets.in(room).emit('ready');
} else { // max two clients
socket.emit('full', room);
}
});
socket.on('ipaddr', function() {
var ifaces = os.networkInterfaces();
for (var dev in ifaces) {
ifaces[dev].forEach(function(details) {
if (details.family === 'IPv4' && details.address !== '127.0.0.1') {
socket.emit('ipaddr', details.address);
}
});
}
});
});
В терминале командной строки выполните следующую команду в каталоге work:
node index.js
В браузере откройте localhost:8080.
Каждый раз, когда вы открываете этот URL, вам будет предложено ввести название комнаты. Чтобы присоединиться к той же комнате, каждый раз выбирайте одно и то же название, например foo.
Откройте новую вкладку и снова перейдите по адресу localhost:8080. Выберите то же название комнаты.
Откройте localhost:8080 в третьей вкладке или окне. Выберите то же название комнаты.
Проверьте консоль на каждой вкладке. Вы должны увидеть журнал, созданный кодом JavaScript.
Бонусные баллы
- Какие альтернативные механизмы обмена сообщениями могут быть возможны? С какими проблемами вы можете столкнуться при использовании "чистого" WebSocket?
- Какие проблемы могут возникнуть при масштабировании этого приложения? Можете ли вы разработать метод тестирования тысяч или миллионов одновременных запросов на бронирование переговорных комнат?
- Это приложение использует подсказку JavaScript, чтобы получить название комнаты. Придумайте, как получить название комнаты из URL. Например, если URL выглядит как localhost:8080/foo, то название комнаты будет
foo.
Что вы узнали
На этом шаге вы узнали, как:
- Используйте npm, чтобы установить зависимости проекта, указанные в package.json.
- Запустите сервер Node.js для обслуживания статических файлов.
- Настройте сервис обмена сообщениями на Node.js с помощью socket.io.
- Используйте его, чтобы создавать чат-группы и обмениваться сообщениями.
Полная версия этого шага находится в папке step-04.
Подробнее
- Репозиторий Socket.io chat-example
- WebRTC in the real world: STUN, TURN and signaling
- Термин "сигнализация" в WebRTC
Далее
Узнайте, как использовать сигнализацию, чтобы два пользователя могли установить одноранговое соединение.
8. Объединение однорангового подключения и сигнализации
Что вы узнаете
На этом шаге вы узнаете, как:
- Запустите сигнальный сервис WebRTC с помощью Socket.IO, работающего на Node.js.
- Используйте этот сервис для обмена метаданными WebRTC между узлами.
Полная версия этого шага находится в папке step-05.
Замена HTML и JavaScript
Замените содержимое файла index.html следующим кодом:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="/css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<div id="videos">
<video id="localVideo" autoplay muted></video>
<video id="remoteVideo" autoplay></video>
</div>
<script src="/socket.io/socket.io.js"></script>
<script src="https://webrtc.github.io/adapter/adapter-latest.js"></script>
<script src="js/main.js"></script>
</body>
</html>
Замените содержимое файла js/main.js содержимым файла step-05/js/main.js.
Запустите сервер Node.js
Если вы не выполняете эту практическую работу из каталога work, вам может потребоваться установить зависимости для папки step-05 или текущей рабочей папки. Выполните следующую команду из рабочего каталога:
npm install
Если после установки сервер Node.js не запущен, запустите его, выполнив следующую команду в каталоге work:
node index.js
Убедитесь, что вы используете версию index.js из предыдущего шага, в которой реализован Socket.IO. Дополнительную информацию о Node и Socket IO можно найти в разделе "Настройка сервиса сигнализации для обмена сообщениями".
В браузере откройте localhost:8080.
Снова откройте localhost:8080 в новой вкладке или окне. Один видеоэлемент будет показывать локальный поток из getUserMedia(), а другой – удаленное видео, передаваемое с помощью RTCPeerconnection.
Просмотр журналов в консоли браузера.
Бонусные баллы
- Это приложение поддерживает только видеочат один на один. Как можно изменить дизайн, чтобы несколько человек могли использовать одну и ту же комнату видеочата?
- В примере название комнаты foo задано в коде. Как лучше всего включить другие названия комнат?
- Как пользователи могут поделиться названием чат-группы? Попробуйте создать альтернативу обмену названиями комнат.
- Как можно изменить приложение
- Сделайте снимок и получите из него данные с помощью элемента canvas.
- Обмен данными изображений с удаленным пользователем.
Полная версия этого шага находится в папке step-06.
Принцип работы
Ранее вы узнали, как обмениваться текстовыми сообщениями с помощью RTCDataChannel.
Этот шаг позволяет делиться файлами целиком, например фотографиями, сделанными с помощью getUserMedia().
Основные части этого шага следующие:
- Установите канал передачи данных. Обратите внимание, что на этом этапе вы не добавляете медиапотоки в одноранговое соединение.
- Захват видеопотока с веб-камеры пользователя с помощью
getUserMedia():
var video = document.getElementById('video');
function grabWebCamVideo() {
console.log('Getting user media (video) ...');
navigator.mediaDevices.getUserMedia({
video: true
})
.then(gotStream)
.catch(function(e) {
alert('getUserMedia() error: ' + e.name);
});
}
- Когда пользователь нажимает кнопку Сделать снимок, получить кадр из видеопотока и показать его в элементе
canvas:
var photo = document.getElementById('photo');
var photoContext = photo.getContext('2d');
function snapPhoto() {
photoContext.drawImage(video, 0, 0, photo.width, photo.height);
show(photo, sendBtn);
}
- Когда пользователь нажимает кнопку Отправить, преобразуйте изображение в байты и отправьте их по каналу передачи данных:
function sendPhoto() {
// Split data channel message in chunks of this byte length.
var CHUNK_LEN = 64000;
var img = photoContext.getImageData(0, 0, photoContextW, photoContextH),
len = img.data.byteLength,
n = len / CHUNK_LEN | 0;
console.log('Sending a total of ' + len + ' byte(s)');
dataChannel.send(len);
// split the photo and send in chunks of about 64KB
for (var i = 0; i < n; i++) {
var start = i * CHUNK_LEN,
end = (i + 1) * CHUNK_LEN;
console.log(start + ' - ' + (end - 1));
dataChannel.send(img.data.subarray(start, end));
}
// send the reminder, if any
if (len % CHUNK_LEN) {
console.log('last ' + len % CHUNK_LEN + ' byte(s)');
dataChannel.send(img.data.subarray(n * CHUNK_LEN));
}
}
- Принимающая сторона преобразует байты сообщения канала данных обратно в изображение и показывает его пользователю:
function receiveDataChromeFactory() {
var buf, count;
return function onmessage(event) {
if (typeof event.data === 'string') {
buf = window.buf = new Uint8ClampedArray(parseInt(event.data));
count = 0;
console.log('Expecting a total of ' + buf.byteLength + ' bytes');
return;
}
var data = new Uint8ClampedArray(event.data);
buf.set(data, count);
count += data.byteLength;
console.log('count: ' + count);
if (count === buf.byteLength) {
// we're done: all data chunks have been received
console.log('Done. Rendering photo.');
renderPhoto(buf);
}
};
}
function renderPhoto(data) {
var canvas = document.createElement('canvas');
canvas.width = photoContextW;
canvas.height = photoContextH;
canvas.classList.add('incomingPhoto');
// trail is the element holding the incoming images
trail.insertBefore(canvas, trail.firstChild);
var context = canvas.getContext('2d');
var img = context.createImageData(photoContextW, photoContextH);
img.data.set(data);
context.putImageData(img, 0, 0);
}
Как получить код
Замените содержимое папки work содержимым папки step-06. Файл index.html в папке work должен выглядеть следующим образом:
<!DOCTYPE html>
<html>
<head>
<title>Realtime communication with WebRTC</title>
<link rel="stylesheet" href="/css/main.css">
</head>
<body>
<h1>Realtime communication with WebRTC</h1>
<h2>
<span>Room URL: </span><span id="url">...</span>
</h2>
<div id="videoCanvas">
<video id="camera" autoplay></video>
<canvas id="photo"></canvas>
<script src="js/main.js"></script>
</body>
</html>
Если вы не выполняете эту практическую работу из каталога work, вам может потребоваться установить зависимости для папки step-06 или текущей рабочей папки. Просто выполните следующую команду из рабочего каталога:
npm install
Если после установки сервер Node.js не запущен, запустите его, выполнив следующую команду из каталога work:
node index.js
Убедитесь, что вы используете версию файла index.js, в которой реализован Socket.IO, и не забудьте перезапустить сервер Node.js, если вы вносите изменения. Дополнительную информацию о Node и Socket IO можно найти в разделе "Настройка сервиса сигнализации для обмена сообщениями".
При необходимости нажмите кнопку Разрешить, чтобы разрешить приложению использовать веб-камеру.
Приложение создаст случайный идентификатор комнаты и добавит его в URL. Откройте URL из адресной строки в новой вкладке или окне браузера.
Нажмите кнопку Snap & Send (Сфотографировать и отправить) и посмотрите на область Incoming (Входящие) на другой вкладке внизу страницы. Приложение переносит фотографии между вкладками.
Вы увидите примерно следующее:

Бонусные баллы
- Как изменить код, чтобы можно было делиться файлами любого типа?
Подробнее
- MediaStream Image Capture API – API для фотографирования и управления камерами. Скоро появится в вашем браузере.
- MediaRecorder API для записи аудио и видео: демоверсия, документация.
Что вы узнали
- Как сделать снимок и получить из него данные с помощью элемента canvas.
- Как обмениваться этими данными с удаленным пользователем.
Полная версия этого шага находится в папке step-06.
9. Поздравляю!
Вы создали приложение для потоковой передачи видео и обмена данными в реальном времени.
Что вы узнали
В этой практической работе вы узнали:
- Получать видео с веб-камеры.
- Транслировать видео с помощью RTCPeerConnection.
- Передача данных с помощью RTCDataChannel.
- Настройте сервис сигнализации для обмена сообщениями.
- Объедините одноранговое подключение и сигнализацию.
- Сделать снимок и передать его по каналу данных.
Дальнейшие действия
- Изучите код и архитектуру канонического приложения чата WebRTC AppRTC: app, code.
- Попробуйте демоверсии на сайте github.com/webrtc/samples.
Подробнее…
- На сайте webrtc.org вы найдете множество ресурсов, которые помогут вам начать работу с WebRTC.