Open Live for Android

English | 中文

The OpenLive for Android Sample App is an open-source demo that will help you get live video broadcasting integrated directly into your Android applications using the Agora Video SDK.

With this sample app, you can:

Join / leave channel
Set role as broadcaster or audience
Mute / unmute audio
Switch camera
Setup resolution, frame rate and bit rate

Prerequisites

Android Studio 3.3 or above
Real devices (Nexus 5X or other devices)
Some simulators are function missing or have performance issue, so real device is the best choice

Quick Start

This section shows you how to prepare, build, and run the sample application.

Obtain an App ID

To build and run the sample application, get an App ID:

Create a developer account at agora.io. Once you finish the signup process, you will be redirected to the Dashboard.
Navigate in the Dashboard tree on the left to Projects > Project List.
Save the App ID from the Dashboard for later use.
Generate a temp Access Token (valid for 24 hours) from dashboard page with given channel name, save for later use.
Update "app/src/main/res/values/strings_config.xml" with your App ID and Access Token.

<string name="private_app_id"><#YOUR APP ID#></string>
<!-- Obtain a temp Access Token at https://dashboard.agora.io -->
<!-- You will need to deploy your own token server for production release -->
<!-- Leave this value empty if Security keys/Token is not enabled for your project -->
<string name="agora_access_token"><#YOUR TOKEN#></string>

Integrate the Agora Video SDK

The SDK must be integrated into the sample project before it can opened and built. There are two methods for integrating the Agora Video SDK into the sample project. The first method uses JCenter to automatically integrate the SDK files. The second method requires you to manually copy the SDK files to the project.

Method 1 - Integrate the SDK Automatically Using JCenter (Recommended)

Clone this repository.
Open app/build.gradle and add the following line to the dependencies list:

...
dependencies {
    ...
    implementation 'io.agora.rtc:full-sdk:3.0.0'
}

Method 2 - Manually copy the SDK files

Download the Agora Video SDK from Agora.io SDK.
Unzip the downloaded SDK package.
Copy the following files from from the libs folder of the downloaded SDK package:

Copy from SDK	Copy to Project Folder
.jar file	/apps/libs folder
arm64-v8a folder	/app/src/main/jniLibs folder
x86 folder	/app/src/main/jniLibs folder
armeabi-v7a folder	/app/src/main/jniLibs folder

Run the Application

Open project with Android Studio, connect your Android device, build and run.

Or use Gradle to build and run.

Resources

For potential issues, take a look at our FAQ first
Dive into Agora SDK Samples to see more tutorials
Take a look at Agora Use Case for more complicated real use case
Repositories managed by developer communities can be found at Agora Community
You can find full API documentation at Document Center
If you encounter problems during integration, you can ask question in Stack Overflow
You can file bugs about this sample at issue

License

The MIT License (MIT)

guobihai / AgoraDemo