Skip to main content

Synchronous Groups Bandwidth Profiles

Keep talking, we’ll handle the rest: if your connection dips, we protect audio and automatically tune video so your class can keep rolling. Try starting your next session and let Sync Rooms optimize for you!

Sam Slagle avatar
Written by Sam Slagle
Updated over a week ago

What are bandwidth profiles in Sync Rooms?

  • Sync Rooms automatically adapt to your network in real time using “banded” profiles.

  • Audio gets top priority so conversations stay clear.

  • Video bitrate is capped for stability and will pause on poor networks, then re‑enable after the connection stabilizes.

  • In the lobby, slow connections are detected early and camera preview is skipped so you can join faster.


Network Quality Levels and Video Management

Uses Twilio's network quality levels (1–5 scale):

  1. Network Quality Level 1–2 (Poor)

    • Action: Video is DISABLED immediately

    • Trigger: Any quality level ≤ 2

    • Message shown: "📶 Poor Network Detected - Video paused to maintain audio quality"

    • Audio: Remains active with priority

  2. Network Quality Level 3 (Fair)

    • Action: Maintains current state (no changes)

    • Behavior: If video was off, it stays off; if on, it stays on

  3. Network Quality Level 4–5 (Good)

    • Action: Video is RE-ENABLED after stability check

    • Requirement: Maintain level ≥ 4 for 2 consecutive checks (QUALITY_STABLE_THRESHOLD = 2)

    • Purpose: Prevents rapid on/off switching (hysteresis)


Lobby Network Detection (Pre‑Room Entry)

In the lobby, the system detects slow networks using:

  • Downlink speed: ≤ 1.5 Mbps triggers "slow network" mode

  • Connection type: 'slow-2g', '2g', or '3g' triggers optimization

  • Round‑trip time: > 300 ms indicates slow connection

  • Fallback test: Tiny test image load time > 500 ms

When slow network is detected in lobby:

  • Camera/microphone preview is SKIPPED entirely

  • Shows "Slow connection detected - Preview disabled for faster loading"

  • Users can still join the room immediately when available

Did this answer your question?