Red5Pro-Android-App
Android-based Application with Red5 Pro Streaming and Second Screen integration.
This project is maintained by infrared5
Interested in the iOS version?
Red5 Pro Android Application.
This Android application project shows how to integrate the Red5 Pro SDKs to enable live streaming and second screen experiences on a mobile device.
To quickly get up and running and build* the APK:
$ git clone https://github.com/infrared5/red5pro-android-app.git
$ cd red5pro-android-app
$ echo "sdk.dir=/path/to/android/sdk/install" > local.properties
$ ./gradlew clean build*Change the `sdk.dir` path to your local Android SDK installation directory.
Project SetUp
Use these handy project setup instructions to start building and using the Red5 Pro Android Application quickly!
Requirements
The Red5 Pro SDKs have a minimum support for Android 4.1 / API Level: 16.
Red5 Pro Server
The Red5 Pro Server is build on the Open Source Red5 Server and allows to build scalable live streaming and second screen applications.
The example application provided in this project repository integrates the Red5 Pro Native SDKs and libraries that enable live streaming and second screen experiences. You will need to setup a Red5 Pro server - either on your local machine or remotely - in order to stream video and communicate with a second screen host.
More information about Red5 Pro, its SDKs and setup can be found in the online Red5 Pro Documentation.
To register an account and start using Red5 Pro in production, visit the Red5 Pro Accounts!
Android SDK
Visit the Android SDK Homepage. From the Android SDK downloads page you can choose to install the SDK bundle for:
Follow the instructions found on those pages for either choice.
If you choose to install with Android Studio, follow along with the Android Studio Project Setup instructions for importing and building the project.
Building on the Command Line
Begin by cloning the repoditory:
$ git clone git@github.com:infrared5/red5pro-android-app.git
$ cd red5pro-android-appOnce you have cloned this repository onto your local machine and are in the repositories root directory, you can build the project.
Gradle Build
The Gradle Wrapper is used to build the Red5 Pro APK.
This project includes the Gradle libraries required to build the application, so there are no additional dependencies to be installed in order to continue.
After installing the Standalone Android SDK, you will need to modify the sdk.dir path from local.properties.template and save the file as local.properties in the project root directory. This file is used by Gradle to build the project.
On *nix
Define the Android SDK target and build:
$ echo "sdk.dir=/path/to/android/sdk/install" > local.properties
$ ./gradlew clean buildBe sure to change the sdk.dir value to your local Android SDK install directory.
On Windows
Open the local.properties.template file, modify the sdk.dir value to the path where you installed the Android SDK and save the file as local.properties.
Once the local.properties file is set, double-click on the gradlew.bat file.
Android Studio Project Setup
This section requires that you have the Android Studio IDE already installed on your machine.
Follow the instructions on the download page to install the Android Studio IDE onto you machine.
Begin by cloning the repoditory:
$ git clone git@github.com:infrared5/red5pro-android-app.git
$ cd red5pro-android-appOnce you have cloned this repository onto your local machine and are in the repositories root directory, you can launch Android Studio and import the project.
Import the Red5 Pro Project
The project included in this repository uses Gradle for its build process. Thankfully, Android Studio makes Gradle integration pretty seemless.
Launch Android Studio and select Import project.
In the file browser dialog shown in the Android Studio IDE, navigate to your local clone of this repoditory, select the root directory and click OK.
You may see an alert regarding unconfigured Gradle settings. This is fine.
We have taken care including the bare minimum to get up and running in Android Studio with Gradle integration. The Android Studio IDE will handle setting up the project with the proper Gradle dependencies that are defined in the build file and wrapper.
Click OK to continue.
Once the Android Studio IDE generates the project, it will present the workspace. Additionally, if you visit the directory into which you cloned this repository you will see .iml files and a new .gradle/ directory. This is part of the Android Studio workspace setup and expected.
From the Android Studio IDE, select to launch the application onto a connected device by clicking either the green arrow or bug icon to the right of the Red5 Pro Configuration in the top bar of the workspace:
Once the application is launched on your chosen device, happy streaming and second screening!
Note: Due to the Android Emulator not providing a proper Network Resource, the Red5 Pro application requires to be launched onto a physical device in order to test and use.