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

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

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

Модель данных

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:

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;
  }
}

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

// Хранить участников, ожидающих одобрения
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 компонент виртуальной комнаты

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, support-helpdesk. Можно добавить QR-код для офлайн-шеринга ссылки на переговорку.

Сроки

Виртуальные комнаты с постоянным URL, лобби, управлением участниками — 1–1.5 недели.