🚀 Interactive Live Streaming for React Native using Video SDK

VideoSDK's Interactive Live Streaming (ILS) enables real-time webinars, events, and social engagements with up to 100 hosts/co-hosts and 2,000 viewers. Perfect for large-scale interactions, it supports dynamic tools like Q&A and live chat for seamless engagement.

🥳 Get 10,000 minutes free every month! Try it now!

📚 Table of Contents

• 🔥 Features
• ⚡ Quick Setup
• 🔧 Prerequisites
• 🔧 Live Stream Mode Overview
• 📦 Running the Sample App
• 🧠 Key Concepts
• 🔑 Token Generation
• 📖 Examples
• 📝 VideoSDK's Documentation
• 💬 Join Our Community

🔥 Features

Media Controls

• ✅ Toggle Media: Easily control audio, video, and screen sharing. Hosts can also manage participant media settings.
• ✅ Customizable Streams: Personalize video and audio streams with quality and setting options.

Enhanced Video & Audio Capabilities

• ✅ AI Virtual Background: Apply virtual backgrounds seamlessly during video streams.
• ✅ AI Noise Removal: Enhance audio clarity by eliminating background noise.
• ✅ AI Filter: Apply real-time filters to enhance video streams.

Interactive Features

• ✅ Chat: Engage in live chat with host moderation to ensure a smooth experience.
• ✅ Gifts: Send and receive virtual gifts during the session.
• ✅ Invite Co-hosts: Bring audience members on stage to co-host the session.
• ✅ Whiteboard: Collaborate visually with an interactive whiteboard.

Accessibility

• ✅ Real-time Captioning: Enable live captions for improved accessibility and engagement.

Moderation Tools

• 🔄 Content Moderation: Ensure a safe and appropriate environment by moderating shared content. (In progress)
• ✅ Kick Participants: Maintain control by removing disruptive participants.

Live Stream Management

• 🔄 Relay Speaker(PK-Host): Send speakers to other live streams for expanded engagement. (In progress)
• 🔄 Switch Live Streams: Seamlessly transition between different live streams. (In progress)

⚡ Quick Setup

1. Sign up on VideoSDK to grab your API Key and Secret.
2. Familiarize yourself with Token

🛠 Prerequisites

• Node.js: v10 or later
• Expo setup
• Android Studio/Xcode: For Android/iOS development
• Valid Video SDK Account

🎥 Live Stream Mode Overview

1. SEND_AND_RECV (For Host or Co-host):

• Designed primarily for the Host or Co-host.
• Allows sending and receiving media.
• Hosts can broadcast their audio/video and interact directly with the audience.

2. RECV_ONLY (For Audience):

• Tailored for the Audience.
• Enables receiving media shared by the Host.
• Audience members can view and listen but cannot share their own media.

📦 Running the Sample App

Follow these steps to get the sample app up and running:

1. Clone the sample project

Clone the repository to your local environment.

git clone https://github.com/videosdk-live/videosdk-ils-react-native-sdk-example

2. Copy the .env.example file to .env file.

Open your favorite code editor and copy .env.example to .env file.

cp .example.env .env;

3. Modify .env file

Generate a temporary token from Video SDK Account.

REACT_APP_VIDEOSDK_TOKEN = "TEMPORARY-TOKEN";

4. Install the dependencies

Install all the dependencies to run the project.

npm install

5. Configure iOS screen sharing (iOS only)

The iOS broadcast extension requires a registered App Group and your Apple Team ID. Both are placeholders in this repo and must be replaced with values from your own Apple Developer account before iOS screen sharing will work.

1. In Apple Developer → Identifiers, create an App Group (e.g. group.<your-bundle-id>.appgroup) and note your Team ID.
2. Replace group.undefined.appgroup with your App Group ID in all four files:
   • ios/broadcast/broadcast.entitlements
   • ios/reactnativeilsexample/reactnativeilsexample.entitlements
   • ios/reactnativeilsexample/Info.plist
   • ios/broadcast/SampleHandler.swift
3. Replace appleTeamId in app.json (the @videosdk.live/expo-ios-screen-share plugin block) with your own Team ID.

6. Run the sample app

Bingo, it's time to push the launch button.

// For Android
npm run android

// For iOS
npm run ios

Result of Example:

Screen.Recording.2025-01-21.at.5.50.43.PM.mp4

🧠 Key Concepts

Understand the core components of our SDK:

• Meeting - A Meeting represents Real-time audio and video communication.

  Note: Don't confuse the terms Room and Meeting; both mean the same thing 😃

• Sessions - A particular duration you spend in a given meeting is referred as a session, you can have multiple sessions of a specific meetingId.

• Participant - A participant refers to anyone attending the meeting session. The local participant represents yourself (You), while all other attendees are considered remote participants.

• Stream - A stream refers to video or audio media content that is published by either the local participant or remote participants.

🔐 Token Generation

The token is used to create and validate a meeting using API and also initialize a meeting.

🛠️ Development Environment:

• You may use a temporary token for development. To create a temporary token, go to VideoSDK's dashboard .

🌐 Production Environment:

• You must set up an authentication server to authorize users for production. To set up an authentication server, please take a look at our official example repositories. videosdk-rtc-api-server-examples

📖 Examples

• React SDK Example
• Android Java SDK Example
• iOS SDK Example

📝 Documentation

Explore more and start building with our Documentation

🤝 Join Our Community

• Discord: Engage with the Video SDK community, ask questions, and share insights.
• X: Stay updated with the latest news, updates, and tips from Video SDK.