Skip to main content

Broadcasting Overview

The Social Plus Video SDK provides comprehensive room-based broadcasting capabilities that enable interactive live streaming with co-hosting support across all platforms.

What is Room Broadcasting?

Room broadcasting enables collaborative live streaming where multiple hosts can broadcast together using LiveKit infrastructure. Unlike traditional single-host livestreams, rooms support real-time co-streaming, viewer interaction through live chat, and comprehensive moderation controls.

Key Features

Co-Hosting

Multiple broadcasters in one stream
  • Invite co-hosts to join the broadcast
  • Real-time audio/video synchronization
  • Host and co-host role management

LiveKit Integration

Professional streaming infrastructure
  • Low-latency video transmission
  • Adaptive bitrate streaming
  • Automatic quality optimization

Live Chat

Real-time viewer engagement
  • Integrated chat channels
  • Host and co-host badges
  • Moderation tools

Recording & Playback

Complete content lifecycle
  • Automatic recording
  • Post-broadcast playback
  • Recording management

Room Lifecycle

Room States

StatusDescriptionActions Available
IdleRoom created but not broadcastingStart stream, invite co-hosts
LiveRoom is actively broadcastingManage broadcast, invite co-hosts
Waiting ReconnectTemporary disconnectionAuto-reconnect, manual stop
EndedBroadcast finishedWait for recording
RecordedRecording availablePlayback, download

Broadcasting Workflow

1. Create Room

Set up a room with title, description, and optional configuration.

2. Create Room Post

Link the room to a post for social distribution in feeds or communities.

3. Get Broadcaster Data

Retrieve LiveKit credentials (coHostToken, coHostUrl) for streaming.

4. Connect to LiveKit

Use the LiveKit SDK to establish the streaming connection.

5. Start Broadcasting

Enable camera and microphone to begin the live broadcast.

6. Manage Broadcast

Invite co-hosts, monitor connection, interact with viewers.

7. End Broadcast

Disconnect from LiveKit and stop the room.

Platform Support

PlatformStatusNotes
iOS✅ Full SupportAVFoundation + LiveKit SDK
Android✅ Full SupportCamera2 API + LiveKit SDK
TypeScript/Web✅ Full SupportWebRTC + LiveKit SDK

Broadcasting Architecture

The room broadcasting system uses LiveKit for real-time video streaming:
  • Host creates the room and gets broadcaster credentials
  • Co-Hosts are invited and receive their own credentials
  • Viewers watch via HLS playback URL (no LiveKit connection needed)
  • Live Chat runs through integrated chat channels

Quick Start

1

Create a Room

Use RoomRepository.createRoom() to create a new room
2

Create a Room Post

Create a post linked to the room for visibility
3

Get Broadcaster Data

Call getBroadcastData() to get LiveKit credentials
4

Connect & Broadcast

Use LiveKit SDK to connect and publish video/audio tracks

Next Steps