Twilio Video Android App
To make sure your app is ready for Android 11 please visit this page.
This application demonstrates multi-party voice and video built with Twilio’s Programmable Video Android SDK.
- Video conferencing with real-time video and audio
- Enable/disable camera
- Mute/unmute mic
- Switch between front and back camera
- Dominant speaker indicator
- Network quality indicator
- Bandwidth Profile API
|Android Studio Version||Android API Version Min|
In order to run this application on an Android device or emulator, complete the following steps.
Deploy Twilio Access Token Server
NOTE: The Twilio Function that provides access tokens via a passcode should NOT be used in a production environment. This token server supports seamlessly getting started with the collaboration app, and while convenient, the passcode is not secure enough for production environments. You should use an authentication provider to securely provide access tokens to your client applications. You can find more information about Programmable Video access tokens in this tutorial.
- Install Twilio CLI.
twilio loginand follow prompts to login to your Twilio account.
twilio plugins:install @twilio-labs/plugin-rtc.
twilio rtc:apps:video:deploy --authentication passcode.
- The passcode that is output will be used later to sign in to the app.
The passcode will expire after one week. To generate a new passcode, run
twilio rtc:apps:video:deploy --authentication passcode --override.
Troubleshooting The Twilio CLI
If any errors occur after running a Twilio CLI RTC Plugin command, then try the following steps.
twilio plugins:updateto update the rtc plugin to the latest version.
twilio rtc:apps:video:deleteto delete any existing authentication servers.
twilio rtc:apps:video:deploy --authentication passcodeto deploy a new authentication server.
App Behavior with Different Room Types
NOTE: Usage charges will apply for most room types. See pricing for more information.
After running the command to deploy a Twilio Access Token Server, the room type will be returned in the command line output. Each room type provides a different video experience. More details about these room types can be found here. The rest of this section explains how these room types affect the behavior of the video app.
Group - The Group room type allows up to fifty participants to join a video room in the app. The Network Quality Level (NQL) indicators and dominant speaker are demonstrated with this room type. Also, the VP8 video codec with simulcast enabled along with a bandwidth profile are set by default in order to provide an optimal group video app experience.
Small Group - The Small Group room type provides an identical group video app experience except for a smaller limit of four participants.
Peer-to-peer - Although up to ten participants can join a room using the Peer-to-peer (P2P) room type, it is ideal for a one to one video experience. The NQL indicators, bandwidth profiles, and dominant speaker cannot be used with this room type. Thus, they are not demonstrated in the video app. Also, the VP8 video codec with simulcast disabled and 720p minimum video capturing dimensions are also set by default in order to provide an optimal one to one video app experience. If more than ten participants join a room with this room type, then the video app will present an error.
Go - The Go room type provides a similar Peer-to-peer video app experience except for a smaller limit of two participants. If more than two participants join a room with this room type, then the video app will present an error.
If the max number of participants is exceeded, then the video app will present an error for all room types.
There are different product flavors for the application:
- Internal - The application intended for internal testing and QA at Twilio. This variant can only be built by Twilions.
- Community - The application intended for developers interested in using Programmable Video. This variant can be built by all developers.
- debug and release build types are supported.
Building the Community Flavor
The community flavor of the application is meant for developers who would like to work with the Video Android SDK in the context of a full-fledged application.
To get started with the community flavor follow these steps:
- Select the
- Run the application.
Start Video Conference
For each device:
- Run the app.
- Enter any unique name in the
- Enter the passcode from Deploy Twilio Access Token Server in the
- Enter a room name.
The passcode will expire after one week. Follow the steps below to sign in with a new passcode.
- Android Studio - Right click and run unit tests on package
- Terminal -
UI tests require credentials that are only available to Twilio employees.
Twilio employees should follow these instructions for internal testing.
Apache 2.0 license. See LICENSE.txt for details.