Installation

Requirements

Platform	Minimum version
iOS	Deployment target >= 12.0 (14.0 for screen sharing)
Android	`minSdkVersion` >= 24
React Native	>= 0.60 (autolinking required)

Install packages

Install react-native-daily-js and its peer dependencies:

npm i @daily-co/react-native-daily-js \
  @react-native-async-storage/async-storage@^1.15.7 \
  react-native-background-timer@^2.3.1 \
  react-native-get-random-values@^1.9.0
npm i --save-exact @daily-co/react-native-webrtc@124.0.6-daily.1

@daily-co/react-native-webrtc must be installed with --save-exact. Using a version range can cause native build failures.

Expo projects

If your project uses Expo, use the @daily-co/config-plugin-rn-daily-js package to automatically configure the native project. This handles all of the iOS and Android steps below. Add the plugin to your app.json:

{
  "expo": {
    "plugins": [
      [
        "@daily-co/config-plugin-rn-daily-js",
        {
          "enableCamera": true,
          "enableMicrophone": true,
          "enableScreenShare": true
        }
      ]
    ]
  }
}

Then generate your native project:

npx expo prebuild

This project cannot be used with Expo Go because it requires custom native code. Use a development build instead.

Bare React Native projects

iOS

Update the platform in your Podfile:

platform :ios, '12.0'

Then install pods:

npx pod-install

Next, add the following keys to your Info.plist. The app will crash silently without the camera and microphone entries.

<key>NSCameraUsageDescription</key>
<string>Your app needs camera access for video calls</string>
<key>NSMicrophoneUsageDescription</key>
<string>Your app needs microphone access for audio calls</string>
<key>UIBackgroundModes</key>
<array>
    <string>voip</string>
</array>

UIBackgroundModes: voip ensures audio continues uninterrupted when your app is backgrounded.

Android

Add permissions and the foreground service to your AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus"/>

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_CAMERA"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION"/>
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

<application>
  <!-- ... -->
  <service
    android:name="com.daily.reactlibrary.DailyOngoingMeetingForegroundService"
    android:foregroundServiceType="camera|microphone"/>
</application>

FOREGROUND_SERVICE_MEDIA_PROJECTION is only required if you intend to support screen sharing.

Update minSdkVersion in your top-level build.gradle:

minSdkVersion = 24

Screen sharing requires additional setup on both platforms. iOS: Screen sharing requires iOS 14.0 or later (update your Podfile platform accordingly). Additional setup is needed to integrate Daily’s React Native Screen Share Extension. See that repo’s README for a full walkthrough. Android: No additional steps beyond adding FOREGROUND_SERVICE_MEDIA_PROJECTION to your AndroidManifest.xml as shown above.

Verify installation

Once installed, join a call to confirm everything is working:

import Daily from '@daily-co/react-native-daily-js';

const call = Daily.createCallObject();
await call.join({ url: 'https://your-domain.daily.co/room-name' });

​Requirements

​Install packages

​Expo projects

​Bare React Native projects

​iOS

​Android

​Screen sharing

​Verify installation

Requirements

Install packages

Expo projects

Bare React Native projects

iOS

Android

Screen sharing

Verify installation