Skip to main content

​
Minimum SDK version

The Daily Client SDK for Android requires a minSdkVersion of 21 or greater.

​
Installing using Maven

In your top-level build.gradle file, add the Maven Central repository: 
repositories {
    // ...
    mavenCentral()
}
In your app’s build.gradle file, add the Daily Client SDK dependency: 
dependencies {
    // ...
    implementation 'co.daily:client:0.37.0'
}
Optionally, to use the camera video processor (for background blur and replacement), also add the following dependency: 
dependencies {
    // ...
    implementation 'co.daily:client-videoprocessor-plugin:0.1.1'
}

​
App setup

Make sure the following permissions are in your app’s AndroidManifest.xml: 
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<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>
  <!--
    A foreground service is needed in the following cases:
    - if you wish to screen share
    - if you wish to keep your call running while the app is in background
  -->
  <service
        android:name=".YourForegroundService"
        android:exported="false"
        android:foregroundServiceType="phoneCall|camera|microphone|mediaProjection" />
</application>
The foregroundServiceType phoneCall, camera and microphone are needed in order to give your app the ability to continue running calls while in the background
The foregroundServiceType mediaProjection is only needed if you wish to do screen sharing.

​
Continuing calls in the background

In order to give your app the ability to continue running calls while in the background, you can start a foreground service that shows an in-call notification while your call is active. You can read more about foreground services in the Android documentation. For an example of a foreground service that customizes and shows a notification, see the one that is bundled with react-native-daily-js.
To learn more about building an app with the Daily Client SDK for Android, see our Android Overview and Android demo app.