Добавить видеозвонки на сайт — критическая задача для телемедицины, EdTech и SaaS. Ручная сборка WebRTC с ICE-кандидатами и STUN-серверами требует десятков часов разработки и приводит к N+1 запросам, утечкам памяти и несовместимости браузеров. Whereby Embedded решает это за час: один <whereby-embed> — и готовая видеосвязь с демонстрацией экрана, чатом и записью. За 5 лет мы интегрировали Whereby в 50+ проектов — от врачебных консультаций до онлайн-школ. Наши инженеры сертифицированы по Whereby API и гарантируют работу на всех устройствах. В одном проекте мы сократили время поставки видеосвязи с 3 недель до 1 дня, а затраты на инфраструктуру — в 6 раз (экономия составила более $30 000 в год). Ниже разберём технические детали, которые сэкономят вам время и бюджет.
Проблемы, которые решаем
Сложность WebRTC. Самописная видеосвязь требует настройки ICE-серверов, обработки NAT и кодеков. Ошибка на любом этапе — и звонок не установится. Whereby берёт это на себя: медиасерверы, релей-серверы (TURN), трансляция видео в разных разрешениях. В результате вы получаете стабильную связь без головной боли. Экономия на серверной инфраструктуре — до 90%.
Масштабирование. При росте нагрузки самописное решение требует увеличения серверной инфраструктуры. Whereby обрабатывает тысячи одновременных комнат без вашего участия — мы только держим API-ключ. Это снижает затраты на инфраструктуру в 5-10 раз, а при 1000 часов звонков в месяц экономия может достигать $5000.
Поддержка устройств. Готовый веб-компонент корректно работает во всех современных браузерах (Chrome, Firefox, Safari, Edge) на десктопе и мобильных. Самописный WebRTC требует отдельного тестирования каждого браузера и устройства.
Почему Whereby Embedded, а не самописный WebRTC?
Сравнение наглядно показывает выигрыш:
| Характеристика |
Самописный WebRTC |
Whereby Embedded |
| Время разработки |
2–4 недели |
0,5–1 день |
| Серверная инфраструктура |
Свои TURN/STUN |
Готовая (Whereby) |
| Тестирование браузеров |
Каждый браузер |
Автоматически |
| Масштабирование |
Ручное |
Автоматическое |
| Стоимость обслуживания |
Высокая |
Фиксированная подписка от $99/мес |
Отметим: как указано в WebRTC API, реализация требует глубоких знаний сетевых протоколов. Готовый компонент даёт выигрыш в 10–20 раз по времени разработки и избавляет от головной боли с трансляцией. Кроме того, Whereby поддерживает запись звонков и аналитику — это требует дополнительных интеграций в самописном решении.
Распространённые проблемы
Ниже — частые ошибки при самостоятельной интеграции и способы их избежать.
| Ошибка |
Симптом |
Решение |
| Пропущен скрипт CDN |
Веб-компонент не отрисовывается |
Добавить <script> перед закрывающим </body> |
| Некорректный endDate |
Комнаты не открываются после истечения времени |
Установить запас 1–2 часа от планируемого окончания |
| Отсутствие обработки событий |
UI не обновляется после звонка |
Подписаться на ready и leave |
| Игнорирование hostRoomUrl |
Организатор не может модерировать |
Использовать hostRoomUrl для входа модератора |
Как происходит интеграция?
Процесс укладывается в 3 этапа:
-
Создание комнаты через API — мы формируем POST-запрос к https://api.whereby.dev/v1/meetings с вашим API-ключом. Комната может быть временной (до 2 часов) или постоянной (с продлением). Мы автоматизируем создание комнат под ваш сценарий.
-
Встраивание веб-компонента — добавляем скрипт в <head> и размещаем <whereby-embed> в нужном месте страницы. Для React/Next.js декларируем тип и подписываемся на события ready и leave. Настройка занимает минуты.
-
Кастомизация — настраиваем отображение (минимальный режим, убираем премитинг-скрин, включаем чат или демонстрацию). При необходимости связываем с вашей CRM для логирования звонков. Все параметры документируем.
Пример создания комнаты через API
curl -X POST https://api.whereby.dev/v1/meetings \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"endDate": "2025-12-31T23:59:59Z", "roomMode": "normal"}'
Какие настройки безопасности доступны?
Whereby Embedded предоставляет гибкие атрибуты для контроля функциональности:
-
skip-media-permission-prompt — отключает экран запроса разрешений камеры.
-
chat="off" — скрывает чат.
-
background="off" — отключает размытие фона.
-
screenshare="off" — запрещает демонстрацию экрана.
Для корпоративных проектов доступен аудит логов и интеграция с JWT-аутентификацией. Это позволяет соблюдать требования безопасности и конфиденциальности.
Что входит в работу
- Интеграция Whereby API — создание и управление комнатами.
- Встраивание веб-компонента — корректная работа в вашем фреймворке.
- Документация — описание всех атрибутов и событий.
- Доступы — настройка API-ключа и окружения.
- Обучение — как управлять комнатами через админку.
- Поддержка — 2 недели после сдачи (исправление возможных багов).
Сроки
Базовая интеграция (создание комнаты + веб-компонент) — 0,5–1 день. Если нужна кастомная логика (автоматическое создание комнат при записи на консультацию, интеграция с JWT-аутентификацией) — до 3 дней. Сроки фиксируем в договоре.
Свяжитесь с нами для бесплатной оценки вашего проекта — мы предложим оптимальное решение и точные сроки. Закажите интеграцию Whereby Embedded и получите стабильную видеосвязь уже на следующий день.
Разработка систем реального времени: WebRTC, SSE, WebSocket
Мы знаем, как больно, когда поллинг убивает сервер. Один наш проект — платформа для онлайн‑аукционов — использовал polling каждые 2 секунды. Под нагрузкой в 400 участников сервер получал 12 000 HTTP‑запросов в минуту ради одной ставки. 90% ответов — пустые. После перехода на WebSocket нагрузка упала в 15 раз, экономия серверных ресурсов — ~200 000 ₽/мес. Закажите разработку real‑time функций под ключ — получите готовое решение с гарантией стабильности.
Реализация real‑time на продакшене — не просто библиотека. Мы проектируем архитектуру под нагрузку, сценарии и бюджет. Ниже — разбор ключевых решений с примерами.
Три транспорта реального времени: когда что выбирать
Server‑Sent Events работают поверх обычного HTTP/1.1 или HTTP/2. Браузер открывает соединение, сервер держит его открытым и пушит события в формате text/event-stream. Автоматическое переподключение встроено — reconnect‑логика не нужна. Ограничение: только сервер → клиент. Идеально для нотификаций, прогресса долгих задач, live‑фидов.
WebSocket — полнодуплексный канал после HTTP Upgrade‑рукопожатия. Браузер и сервер обмениваются фреймами в обе стороны. Подходит для чатов, совместного редактирования, игр, торговых терминалов. Требует отдельной обработки reconnect‑логики и heartbeat (ping/pong каждые 30 секунд, иначе NAT‑таблицы закрывают соединение).
WebRTC — peer‑to‑peer аудио/видео и данные между браузерами напрямую, минуя сервер. Сервер нужен только для сигнализации (STUN/TURN для обхода NAT). TURN‑сервер требуется в 20–30% случаев (корпоративные сети, симметричный NAT). Для сервиса телемедицины мы внедрили WebRTC: задержка звука упала с 800 мс (через релей) до 50 мс (P2P). TURN‑сервер понадобился лишь 15% сессий, что сэкономило $2000/мес на трафике.
WebSocket (Wikipedia)
WebRTC (Wikipedia)
Как правильно выбрать транспорт: пошаговая инструкция
- Определите сценарий обмена данными: однонаправленный (сервер → клиент) — SSE; двунаправленный с низкой задержкой — WebSocket; аудио/видео — WebRTC.
- Оцените требования к задержке. Если приемлемо <500 мс — подойдёт SSE; для <100 мс и двунаправленности — WebSocket; для <50 мс и P2P — WebRTC.
- Проверьте бюджет на инфраструктуру. SSE использует обычные HTTP‑серверы, WebSocket требует держать соединения в памяти, WebRTC может потребовать TURN‑сервер (от 3000 ₽/мес за 1 ТБ трафика).
- Учтите масштабирование: для 100 k+ соединений рассмотрите WebSocket‑gateway (Centrifugo, Pushpin).
| Транспорт |
Направление |
Задержка |
Сложность реализации |
Типичные сценарии |
| WebSocket |
Полный дуплекс |
< 100 мс |
Средняя |
Чаты, игры, торговля |
| SSE |
Только сервер → клиент |
< 500 мс |
Низкая |
Нотификации, ленты прогресса |
| WebRTC |
P2P аудио/видео/данные |
< 50 мс |
Высокая |
Видеозвонки, передача файлов |
Что такое CRDT и чем он лучше Operational Transformation?
Совместное редактирование — не просто «кто последний записал, тот и прав». Без алгоритма слияния коллизий два пользователя вставляют текст в позицию 45, первый сохраняет — позиция сдвигается, второй сохраняет поверх — операция применяется к устаревшему состоянию. Текст дублируется или теряется.
OT (Operational Transformation) требует сервера для разрешения конфликтов, CRDT (Conflict‑free Replicated Data Types) работает без централизованного координатора. Yjs — наиболее зрелая CRDT‑библиотека для браузера. Интегрируется с ProseMirror, TipTap, CodeMirror, Monaco Editor.
Сравнение библиотек для совместного редактирования
| Библиотека |
Алгоритм |
Поддержка редакторов |
Сложность |
Производительность |
| Yjs |
CRDT |
ProseMirror, TipTap, CodeMirror, Monaco |
Средняя |
Высокая (<10 мс при 100 операциях) |
| ShareDB |
OT |
ProseMirror, Quill |
Средняя |
Средняя (требуется сервер для слияния) |
| Automerge |
CRDT |
Любой (RichText) |
Высокая |
Хорошая (но память растёт быстрее Yjs) |
Проблема: размер Yjs‑документа растёт из‑за истории операций. Нужна периодическая сборка мусора — snapshot документа + очистка старых операций. Без этого документ, над которым работали год, может весить 50 МБ.
Пример heartbeat на WebSocket (Node.js)
const ws = new WebSocket('wss://example.com');
let pingInterval;
ws.on('open', () => {
pingInterval = setInterval(() => {
ws.ping();
setTimeout(() => {
if (ws.readyState === WebSocket.OPEN) ws.terminate();
}, 5000);
}, 25000);
});
ws.on('close', () => clearInterval(pingInterval));
Типичные ошибки при внедрении real‑time
Memory leak на сервере — забыли удалить обработчик события при закрытии соединения. На Node.js heap растёт ~1 МБ/ч. EventEmitter предупреждает о 10+ слушателях, но не всегда это замечают.
Thundering herd при реконнекте. Сервер упал на 30 секунд, поднялся — 10 000 клиентов пытаются переподключиться одновременно. Exponential backoff с jitter обязателен: delay = Math.min(baseDelay * 2^attempt + random(0, 1000), maxDelay).
Отсутствие индикации потери соединения. WebSocket не всегда уведомляет о разрыве (например, телефон ушёл в тоннель). Heartbeat решает проблему.
Процесс работы
Начинаем с выбора транспорта под сценарии — иногда в одном проекте нужны все три: SSE для системных нотификаций, WebSocket для чата, WebRTC для видеозвонков. Проектируем протокол сообщений (JSON с type и payload, реже бинарный через MessagePack). Разрабатываем с тестированием race conditions — это не покрывается юнит‑тестами.
Нагрузочное тестирование с k6 + k6/experimental/websockets: моделируем 5 000 одновременных соединений с реальным паттерном. Инженеры имеют сертификаты по WebSocket и WebRTC, гарантируем стабильность 99.9%.
Что входит
- Архитектура real‑time слоя (выбор транспорта, протокол сообщений)
- Реализация с нагрузочным тестированием (k6, сценарии race conditions)
- Интеграция с бэкендом через Redis Pub/Sub или аналогичную шину
- Документация по протоколу и схемам данных
- Обучение вашей команды
- Техническая поддержка 2 недели после запуска
Почему Centrifugo может быть выгоднее, чем Socket.io?
Socket.io проще в настройке (1–2 дня), но центрифуга на Go держит 1M+ соединений на одной ноде. Для 100 k+ одновременных клиентов Centrifugo экономит до 40% затрат на инфраструктуру. Получите консультацию — мы поможем выбрать стек под вашу нагрузку.
Сроки
- Базовый WebSocket‑чат или нотификации поверх существующего API: 1–3 недели.
- Коллаборативный редактор с Yjs и persistence: 4–8 недель.
- WebRTC видеозвонки с записью: 6–12 недель (значительная часть — интеграция с медиасервером mediasoup или Janus).
Свяжитесь с нами для оценки вашего проекта. Обсудите задачу с инженером — оценим сложность и сроки индивидуально.
