Integracao BigBlueButton (BBB) — padrao open-source de aulas ao vivo

Por que BBB e padrao

Aspecto	BBB	Zoom/Teams/Meet
Custo	Open-source + hosting ($20-200/mes)	$14-25/host/mes (Zoom) ou incluido (M365/Google)
Iframe embed	Sim (aluno fica no Studeia)	NAO (X-Frame-Options bloqueia)
Lousa colaborativa	Sim, nativa	Limitada (Zoom Whiteboard, Microsoft Whiteboard)
Breakout rooms	Sim, ilimitados	Sim (limites por tier)
Polls / Levantar mao	Sim, nativos	Sim
Status emoji (concordo/discordo)	Sim, nativo	Limitado
Gravacao	Sim, nativa BBB	Sim
Multi-share	Sim (multiplas pessoas screen-share simultaneo)	NAO em Zoom (1 por vez)

Self-hosted vs Managed

Self-hosted (recomendado para escolas medias/grandes)

Requirements (1 instancia para 150 users):

16 CPU cores
16 GB RAM
500 GB disk (gravacoes)
Ubuntu 20.04 LTS
Dominio + TLS (Let's Encrypt)

Installation via bbb-install.sh (~30min).

Custo: VPS $30-100/mes (Hetzner, DigitalOcean, Vultr).

Managed (mais simples para escolas pequenas/medias)

Providers brasileiros e globais:

BlindsideNetworks (criadores BBB): $50-500/mes
HigherEdLab: $20-200/mes
EduMeet / Blindside Networks BBB hosting

Inclui: hosting + atualizacoes + backup + suporte. Pague por simultaneous users.

Setup em Studeia

Conseguir BBB instance URL (ex: https://bbb.escola.edu.br/bigbluebutton/api)
Conseguir Shared Secret do servidor BBB (bbb-conf --secret no servidor)
Studeia > Settings > Video Provider > BBB > Add:
- URL
- Shared Secret
- Set as default
Testar: Studeia chama /api/getMeetings e valida resposta

Como funciona

Admin/Professor cria LiveClass (videoProvider=bbb ou null=default)
  ↓
Studeia BBBAdapter.createMeeting()
  → SHA-256 checksum (BBB nao usa OAuth)
  → GET https://bbb.../api/create?meetingID=...&checksum=...
  → Retorna meetingID + joinUrl
  ↓
Aluno entra via /live-classes/[id]
  → joinMethod=iframe — Studeia renderiza iframe BBB DENTRO da pagina
  → Aluno nao sai do Studeia

Gravacoes

BBB grava no servidor proprio:

Format: BBB recording format (proprietary) ou MP4/WebM (via plugin)
URL: https://bbb.../playback/presentation/2.3/[recordingId]
Studeia salva recordingUrl em LiveClass apos webhook BBB notifica

Limitacoes

Sem app mobile nativo BBB — alunos usam browser mobile (funcional mas nao otimo)
WebRTC: aluno precisa de browser moderno (Chrome, Firefox, Edge, Safari 14+)
Bandwidth: ~1 Mbps download por aluno (para video). Verificar conexao escolar
Latencia: BBB e otimo em LAN, OK em WAN. Para alunos rurais com conexao fraca: pode ter delay > 500ms

Veja tambem

FAQ

BigBlueButton e gratuito?

Software e gratuito (open-source AGPL 3.0). Mas voce precisa hospedar uma instancia BBB (servidor proprio com ~16 CPU + 16 GB RAM para ~150 alunos simultaneos) OU contratar managed BBB provider ($20-200/mes dependendo do tamanho). Sem hosting/provider: BBB nao funciona.

Por que BBB e o video provider padrao do Studeia?

Tres razoes: (1) Open-source educacional — recursos nativos pra ensino (lousa colaborativa, breakout rooms, polls, levantar mao, status emoji). (2) Iframe embed — aluno fica DENTRO do Studeia, nao precisa abrir outra aba (Zoom/Teams/Meet bloqueiam iframe via X-Frame-Options). (3) Sem custos por meeting — uma vez paga a instancia, ilimitado.

Como configurar BBB no Studeia?

Settings > Video Provider > BBB > URL (ex: https://bbb.escola.edu.br/bigbluebutton/api) + Shared Secret (do servidor BBB). Auth via SHA-256 checksum (BBB nao usa OAuth). Studeia testa conexao via /api/getMeetings.

BBB e adequado para 1000 alunos simultaneos em uma aula?

Uma instancia BBB tipica aguenta ~150 alunos por servidor. Para >150: configure BBB Scalelite (load balancer + multiplas instancias). Para >1000 simultaneos: considere Zoom Webinar (limite 10000 attendees passivos) em vez de BBB.