/react-native-webrtc

The WebRTC module for React Native

Primary LanguageJavaMIT LicenseMIT

React Native WebRTC

React-Native-WebRTC

npm version npm downloads Discourse topics

A WebRTC module for React Native.

Feature Overview

Android iOS macOS* Windows* Web* Expo*
Audio/Video ✔️ ✔️ - - ✔️ ✔️
Data Channels ✔️ ✔️ - - ✔️ ✔️
Screen Capture ✔️ ✔️ - - ✔️ ✔️
Plan B - - - - - -
Unified Plan* ✔️ ✔️ - - ✔️ ✔️
Simulcast* ✔️ ✔️ - - ✔️ ✔️

macOS - We don't currently actively support macOS at this time.
Support might return in the future.

Windows - We don't currently support the react-native-windows platform at this time.
Anyone interested in getting the ball rolling? We're open to contributions.

Web - The react-native-webrtc-web-shim project provides a shim for react-native-web support. Which will allow you to use (almost) the exact same code in your react-native-web project as you would with react-native directly.

Expo - Sadly this module is not available in the Expo Go app by default due to including much needed native code.
However you can get things working via the expo-dev-client library and out-of-tree config-plugins/react-native-webrtc package.

Unified Plan - As of version 106.0.0 Unified Plan is the only supported mode.
Those still in need of Plan B will need to use an older release.

Simulcast - As of version 111.0.0 Simulcast is now easily possible due to the use of software encode/decode factories by default.

WebRTC Revision

  • Currently used revision: M111
  • Supported architectures
    • Android: armeabi-v7a, arm64-v8a, x86, x86_64
    • iOS: arm64, x86_64
    • macOS: (temporarily disabled)

Getting Started

Use one of the following preferred package install methods to immediately get going.
Don't forget to follow platform guides below to cover any extra required steps.

npm: npm install react-native-webrtc --save
yarn: yarn add react-native-webrtc
pnpm: pnpm install react-native-webrtc

Guides

Example Projects

We have some very basic example projects included in the examples directory.
Don't worry, there are plans to include a much more broader example with backend included.

Community

Come join our Discourse Community if you want to discuss any React Native and WebRTC related topics.
Everyone is welcome and every little helps.

Related Projects

Looking for extra functionality coverage?
The react-native-webrtc organization provides a number of packages which are more than useful when developing Real Time Communication applications.