Introduction

Interactive Live Streaming (ILS) lets hosts send audio and video to an audience in real time, from a React Native app.

Architecture Overview

Architecture at a Glance — Hosts join in SEND_AND_RECV mode to broadcast and collaborate, while the audience joins in RECV_ONLY mode to watch without publishing their own media.

Streaming Modes

Interactive Live Streaming (ILS): Low-latency, two-way sessions where hosts and promoted guests publish audio/video, and manage roles.

HTTP Live Streaming (HLS): Broadcast delivery for large audiences with playback-only viewers, suited to town halls and one-to-many events.

Interactive Live Streaming Quick Start

Build a React Native app with hosts, a backstage and a moderated audience.

HTTP Live Streaming Quick Start

Deliver large-scale broadcasts by following the React Native HLS configuration guide.

The guides below cover each part of this flow.

Key Features

Stage Management

Control who’s on screen, switch layouts, and coordinate presenters on mobile.

Audience Controls

Promote viewers to speakers, manage roles, and moderate large audiences.

Device Flexibility

Give hosts fine-grained access to microphones, cameras, and screen sharing.

Interactive Layers

Chat, reactions, polls and raise-hand.

Real-time Analytics

Inspect quality metrics and attendee behaviour in the dashboard.

Recording & Archives

Record rooms, generate highlights, and automate storage rules.

Geo & Network Controls

Respect geographic restrictions and regional compliance rules.

Relay & Multistream

Stream to secondary rooms or endpoints using relay media options.

Sample Projects

note

These sample projects still use React Native SDK v1.0.1. To build an app on v2.0.0, follow the Interactive Live Streaming Quick Start or the HTTP Live Streaming Quick Start. The Migration Guide lists what changed in v2.0.0.

React Native ILS Starter

Run a host and audience app built on the React Native SDK.

React Native HLS Broadcast

Use this repo to stream to large audiences while viewers watch via HLS.

Quick Start Paths

Install the SDK

Configure the Android, iOS, and Expo packages required for VideoSDK rooms.

Configure Tokens

Implement secure token issuance before enabling production traffic.

Launch the ILS Sample

Clone the React Native ILS starter to validate host and viewer journeys.

Broadcast with HLS

Run the HLS sample app.

Review Best Practices

Follow mobile-specific guidelines for UX, resource usage, and error handling.

Track Updates

Stay informed of new features and breaking changes in the release notes.