Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Android Platform Overview

Twilio's Programmable Video Android SDK lets you add real time voice and video to your native Android applications.

Prerequisites

  • Android Studio 2.0 or higher
  • Support for Android API level 16 or higher
  • Support for Java 8

Run the QuickStart app

To get started with Twilio Video, you should download and run the QuickStart application.

The QuickStart repository contains additional examples. These examples demonstrate the usage of new features and also help you build more complex applications.

To add Video to your app, follow the Getting Started Guide

Add the SDK

The Android Video SDK is distributed through jCenter.

To install the Android Video SDK, ensure the following configuration is in your build.gradle file:

Gradle

allprojects {
    repositories {
        jcenter()
    }
}

// The Video library resides on jcenter
implementation 'com.twilio:video-android:3.0.0'

android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

Proguard

Add the following lines to your proguard-project.txt file.

-keep class org.webrtc.** { *; }
-keep class com.twilio.video.** { *; }
-keepattributes InnerClasses

Supported Devices

The Android SDK supports Android API level 16 and higher. It is built for armeabi-v7a, arm64-v8a, x86, and x86_64 architectures.

Release Notifications

Watch the video-android project on Bintray to get notified of all future releases.

Migrating from 2.x to 3.x

Our 3.0 releases are now "Generally Available" (GA) and represent our latest releases with the following new features:

  • The media stack has been upgraded from WebRTC 57 to WebRTC 67. The process by which our team upgrades WebRTC has been improved and developers can expect a steadier cadence of releases with WebRTC upgrades moving forward.
  • The SDK is now compiled using Java 8 features.

Our 1.x and 2.x releases are still (GA) and represent stable APIs that are supported with critical bug fixes. Refer to our 2.x migration guide for migrating your applications from 1.x to 2.x and our 3.x migration guide for migrating your applications from 2.x to 3.x.

Migrating from 1.x to 2.x

Our 2.0 releases are "Generally Available" (GA) and provide the following features:

  • H.264 encoding and decoding.
  • Codec preferences.
  • Bandwidth controls.
  • Subscription focused APIs.
  • Track names, Track level errors.
  • Data Tracks.

Our 1.x releases are still (GA) and represent stable APIs that are supported with only critical bug fixes. Refer to our migration guide for migrating your applications from 1.x to 2.x.

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

Loading Code Sample...