To download the Kinesis Video Streams WebRTC SDK in Android, run the following command:
git clone https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-android.git
Follow the instructions here to set up an Amazon Cognito user pool for secure login.
Follow the instructions here to set up an Amazon Cognito identity pool.
Import the downloaded SDK into the Android Studio integrated development environment by opening the amazon-kinesis-video-streams-webrtc-sdkandroid/build.gradle with Open an existing Android Studio project
.
You will need all the information from the above steps copied in clipboard, then paste them into this file on your local file awsconfiguration.json. Your completed awsconfiguration.json should look something like this:
{
"Version": "1.0",
"CredentialsProvider": {
"CognitoIdentity": {
"Default": {
"PoolId": "us-west-2:01234567-89ab-cdef-0123-456789abcdef",
"Region": "us-west-2"
}
}
},
"IdentityManager": {
"Default": {}
},
"CognitoUserPool": {
"Default": {
"AppClientSecret": "abcdefghijklmnopqrstuvwxyz0123456789abcdefghijklmno",
"AppClientId": "0123456789abcdefghijklmnop",
"PoolId": "us-west-2_qRsTuVwXy",
"Region": "us-west-2"
}
}
}
Import Google WebRTC (aka libwebrtc). Choose one of the following:
a. Build libwebrtc yourself, following https://webrtc.github.io/webrtc-org/native-code/android/#getting-the-code. After it's been built, place the .aar
file in libs.
b. Acquire a pre-built binary of libwebrtc and import it.
Click gradle Sync and Build
Run the demo application in simulator or in Android device (connected through USB).
On your Android device, open AWSKinesisVideoWebRTCDemoApp and sign up with Create New Account
or sign in with existing accounts.
Note: This account information is stored in your Cognito User Pool and is not your AWS Console user name/password.
Once login is successful, you will entering the following channel information to start peer to peer streaming.
demo-channel
us-west-2
audio
if you would like to send both audio or video data.Optionally, when using it in viewer
mode, you can enter a unique Client Id
. Client ID is required only if multiple viewers are connected to a channel. This helps channel's master identify respective viewers.
To verify peer to peer streaming, do any of the following setup. In these setup, ensure that the signaling channel name, region, viewer ID, and the AWS account ID are the same.
master
mode for starting a new session. Remote peer will be joining as viewer to this master. There should be only one master for any given channel.master
) in viewer
mode; this will connect to an existing session (channel) where a master is connected.master
mode on a camera device.viewer
mode - you should be able to check the video (and audio if selected both in embedded SDK) showing up in the Android device from the camera.master
mode for starting a new session.viewer
.Candidate trickling is a technique through which a caller may incrementally provide candidates to the callee after the initial offer has been dispatched; the semantics of "Trickle ICE" are defined in [RFC8838].
Trickle ICE is the default behavior within the Kinesis Video Stream WebRTC SDK for Android since it reduces the time it takes for the ICE negotiation process. However, in the case that it needs to be disabled, locate the RTCConfiguration property called ContinualGatheringPolicy and change it to GATHER_ONCE instead of GATHER_CONTINUALLY (default).
PeerConnection.RTCConfiguration rtcConfig = new PeerConnection.RTCConfiguration();
rtcConfig.continualGatheringPolicy = PeerConnection.ContinualGatheringPolicy.GATHER_CONTINUALLY;
This SDK has been tested with Java 11, 17 to build the Gradle dependencies and Java 8, 11, and, 17 in the compile options in build.gradle
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
For more details about the different Java versions, please check Java versions in Android builds
This library is licensed under the Apache 2.0 License.