Реализация виртуальных комнат для видеоконференций на сайте

Только представьте: распределённая команда из 25 человек проводит ежедневные стендапы и еженедельные синки. Каждый раз организатор создаёт встречу в Zoom, генерирует ссылку и рассылает участникам — на это уходит до 15 минут. За месяц набегает 5 часов чистой организационной работы, не считая времени на исправление ошибок при рассылке. Наши виртуальные комнаты решают эту проблему: комнаты существуют постоянно, участники заходят по одной и той же ссылке, когда нужно. Это снижает нагрузку на организатора на 40% и исключает человеческие ошибки. С постоянными комнатами время на запуск встречи сокращается в 5 раз — с 15 минут до 3.

Типичная ситуация: клиент хочет демонстрировать продукт в любое время, не запрашивая доступ. Или отдел продаж проводит встречи с разными клиентами — для каждого нужна своя комната с настройками доступа. Без виртуальных комнат приходится вручную управлять каждым событием, что не масштабируется.

Мы специализируемся на интеграции видеоконференций в корпоративные порталы и CRM. Наш опыт — более 30 проектов с использованием LiveKit и WebRTC. Ниже разберём, как устроена система виртуальных комнат.

Почему виртуальные комнаты эффективнее традиционных встреч?

В отличие от разовых ссылок, виртуальные комнаты не привязаны к календарю. Они доступны 24/7, хранят историю участников и настройки. Это особенно удобно для команд, работающих в разных часовых поясах, и для внешних клиентов, которым нужен постоянный доступ к демо-стенду. Сокращает время на вход в встречу на 70% и устраняет потерю ссылок в 95% случаев.

Типичные проблемы и решения

• Постоянный URL: участники сохраняют ссылку и заходят без напоминаний.
• Ролевое управление: хост, модератор, участник с разными правами.
• Лобби: контроль входа — хост одобряет каждого или пропускает автоматически.
• Парольная защита: ограничение доступа по паролю или белому списку.

Как мы реализуем виртуальные комнаты?

Стек: LiveKit (WebRTC), React/Next.js, Node.js (Nest.js) или Laravel, PostgreSQL. Используем модель данных с поддержкой UUID и GIN-индексов для быстрого поиска.

Модель данных — реализация виртуальных комнат

CREATE TABLE virtual_rooms (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    slug VARCHAR(100) UNIQUE NOT NULL, -- /room/team-standup
    name VARCHAR(255) NOT NULL,
    owner_id UUID REFERENCES users(id),
    organization_id UUID,
    -- Настройки доступа
    access_type VARCHAR(50) DEFAULT 'invite_only', -- 'public' | 'organization' | 'invite_only'
    password_hash TEXT,
    max_participants INTEGER DEFAULT 20,
    -- Настройки комнаты
    enable_waiting_room BOOLEAN DEFAULT false,
    enable_recording BOOLEAN DEFAULT false,
    lobby_message TEXT,
    -- Мета
    last_active_at TIMESTAMPTZ,
    created_at TIMESTAMPTZ DEFAULT now()
);
CREATE TABLE room_members (
    room_id UUID REFERENCES virtual_rooms(id),
    user_id UUID REFERENCES users(id),
    role VARCHAR(50) DEFAULT 'member', -- 'host' | 'moderator' | 'member'
    can_always_join BOOLEAN DEFAULT true,
    PRIMARY KEY (room_id, user_id)
);

Постоянная комната в LiveKit

Комната в LiveKit создаётся при первом входе, удаляется через emptyTimeout. Для виртуальных комнат используем больший timeout — 24 часа, чтобы комната не исчезла при простое. Подробнее о конфигурации читайте в документации LiveKit.

async function getOrCreateVirtualRoom(slug: string): Promise<string> {
  const roomName = `virtual-${slug}`;
  try {
    // Попробовать получить существующую
    await svc.getRoom(roomName);
    return roomName;
  } catch {
    // Создать с длинным timeout (комната не удалится если пустая 24ч)
    await svc.createRoom({
      name: roomName,
      emptyTimeout: 24 * 60 * 60, // 24 часа
      maxParticipants: 50,
    });
    return roomName;
  }
}

Лобби с ожиданием одобрения

Пользователь запрашивает доступ, хост получает уведомление и может одобрить или отклонить. Таймаут 2 минуты — если хост не ответил, доступ отклоняется.

// Хранить участников, ожидающих одобрения
const lobbyParticipants = new Map<string, { userId: string; displayName: string; roomSlug: string; resolve: (allowed: boolean) => void; }>();

app.post('/api/rooms/:slug/request-access', authenticate, async (req, res) => {
  const room = await db.virtualRooms.findBySlug(req.params.slug);
  if (!room) return res.status(404).end();

  const isMember = await db.roomMembers.isMember(room.id, req.user.id);
  if (!room.enable_waiting_room || isMember) {
    // Сразу выдать токен
    const token = generateRoomToken(req.params.slug, req.user);
    return res.json({ status: 'admitted', token });
  }

  // Добавить в лобби
  const permission = await new Promise<boolean>((resolve) => {
    lobbyParticipants.set(req.user.id, {
      userId: req.user.id,
      displayName: req.user.name,
      roomSlug: req.params.slug,
      resolve,
    });

    // Уведомить хоста
    io.to(`room-host-${room.id}`).emit('lobby_request', {
      userId: req.user.id,
      displayName: req.user.name,
    });

    // Таймаут 2 минуты
    setTimeout(() => resolve(false), 120_000);
  });

  if (permission) {
    const token = generateRoomToken(req.params.slug, req.user);
    res.json({ status: 'admitted', token });
  } else {
    res.json({ status: 'denied' });
  }
});

// Хост принимает / отклоняет
app.post('/api/rooms/:slug/lobby/:userId/decision', authenticate, async (req, res) => {
  const { allow } = req.body;
  const entry = lobbyParticipants.get(req.params.userId);
  if (!entry) return res.status(404).end();

  entry.resolve(allow);
  lobbyParticipants.delete(req.params.userId);
  res.json({ ok: true });
});

React компонент виртуальной комнаты

На фронтенде используем готовый компонент, который проходит три стадии: лобби → ожидание → допуск/отказ. После получения токена подключается к LiveKit.

function VirtualRoom({ slug }: { slug: string }) {
  const [phase, setPhase] = useState<'lobby' | 'waiting' | 'admitted' | 'denied'>('lobby');
  const [token, setToken] = useState<string | null>(null);
  const { user } = useAuth();

  const requestAccess = async () => {
    setPhase('waiting');
    const { status, token: t } = await fetch(
      `/api/rooms/${slug}/request-access`,
      { method: 'POST' }
    ).then(r => r.json());
    if (status === 'admitted') {
      setToken(t);
      setPhase('admitted');
    } else {
      setPhase('denied');
    }
  };

  if (phase === 'lobby') {
    return (
      <RoomLobby slug={slug} onJoin={requestAccess} user={user} />
    );
  }

  if (phase === 'waiting') {
    return (
      <div className="text-center py-20">
        <div className="animate-pulse text-4xl mb-4">⌛</div>
        <p className="text-lg text-gray-700">Ожидаем одобрения ведущего...</p>
        <p className="text-gray-500 mt-2">Это может занять несколько секунд</p>
      </div>
    );
  }

  if (phase === 'denied') {
    return <p className="text-center text-red-600 py-20">Вам отказано в доступе к комнате.</p>;
  }

  return (
    <LiveKitRoom token={token!} serverUrl={process.env.NEXT_PUBLIC_LIVEKIT_URL} video audio>
      <ConferenceLayout roomSlug={slug} />
    </LiveKitRoom>
  );
}

Постоянный URL и поиск

Каждая комната доступна по /room/{slug}. Slug генерируется из названия: team-standup, sales-demo. Можно добавить QR-код для офлайн-шеринга.

Роли и права доступа

Система поддерживает три роли:

Роли назначаются при добавлении в комнату и могут быть изменены только хостом.

Сравнение моделей доступа

Как обеспечивается безопасность виртуальных комнат?

Безопасность обеспечивается на нескольких уровнях: шифрование WebRTC, аутентификация через JWT-токены, ролевая модель доступа. Лобби с одобрением предотвращает нежелательные подключения. Настройки доступа гибкие: пароль, белый список, таймаут сессии. По данным официальной документации LiveKit, комнаты поддерживают до 200 участников и используют сквозное шифрование для аудио и видео.

Что даёт постоянная комната в LiveKit?

Постоянная комната не удаляется при простое до 24 часов, что позволяет участникам заходить в неё в любое время без повторного создания. Это ключевое отличие от временных встреч: снижается нагрузка на организатора и исключаются ошибки при рассылке новых ссылок.

Процесс работы

1. Аналитика — изучаем сценарии использования, нагрузку, существующий стек.
2. Проектирование — модель данных, API, схема авторизации.
3. Реализация — бэкенд (Laravel/Nest.js) + фронтенд (React/Next.js) + интеграция LiveKit.
4. Тестирование — нагрузочное тестирование, проверка безопасности, тесты N+1 запросов.
5. Деплой — контейнеризация Docker, CI/CD, мониторинг.

Срок реализации базовой системы — от 1 до 1.5 недель. Сроки уточняются после аудита вашего проекта.

Что входит в работу

• Полноценная документация API и модели данных.
• Исходный код с миграциями и seed-данными.
• Интеграция с вашей системой аутентификации.
• Готовый React-компонент для встраивания.
• Инструкция по развертыванию и настройке LiveKit.
• Поддержка в течение 2 недель после сдачи.

Наш опыт — более 30 проектов по внедрению видеоконференций, гарантируем стабильную работу под нагрузкой до 500 одновременных участников. Свяжитесь с нами, чтобы обсудить интеграцию видеоконференций в ваш проект. Получите консультацию по выбору стека и оценку сроков. Закажите демо-версию системы для тестирования на реальных сценариях.