Skip to main content
Version: 0.1.x

Setup

Setting up android sdk

Android SDK is client for real-time communication for android devices. It inherits the same terminology as all other SDKs does.

Minimum OS/SDK versions

It supports the following OS/SDK versions.

Android: minSdkVersion >= 21

Installation

  1. If your Android Studio Version is older than Android Studio Bumblebees, add the repository to project's build.gradle file.
    If your are using Android Studio Bumblebees or newer Version, add the repository to settings.gradle file.
note

You can use imports with Maven Central after rtc-android-sdk version 0.1.12.

Whether on Maven or Jitpack, the same version numbers always refer to the same SDK.

build.gradle
allprojects {
repositories {
// ...
google()
mavenCentral()
maven { url "https://maven.aliyun.com/repository/jcenter" }
}
}
settings.gradle
dependencyResolutionManagement{
repositories {
// ...
google()
mavenCentral()
maven { url "https://maven.aliyun.com/repository/jcenter" }
}
}

Step 2: Add the following dependency in your app's app/build.gradle.

app/build.gradle
dependencies {
implementation 'live.videosdk:rtc-android-sdk:0.1.13'

// library to perform Network call to generate a meeting id
implementation 'com.amitshekhar.android:android-networking:1.0.2'

// other app dependencies
}
info

Android SDK compatible with armeabi-v7a, arm64-v8a, x86_64 architectures. If you want to run the application in an emulator, choose ABI x86_64 when creating a device.

Integration

Step 1: Add the following permissions in AndroidManifest.xml.

AndroidManifest.xml
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

Step 2: Create MainApplication class which will extend the android.app.Application.

MainApplication.kt
package live.videosdk.demo;

import live.videosdk.android.VideoSDK

class MainApplication : Application() {
override fun onCreate() {
super.onCreate()
VideoSDK.initialize(applicationContext)
}
}

Step 3: Add MainApplication to AndroidManifest.xml.

AndroidManifest.xml
<application
android:name=".MainApplication"
...
>
<!-- ... -->
</application>

Step 4: In your JoinActivity add the following code in onCreate() method.

JoinActivity.kt
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_join)

val meetingId = "<meeting-id>"
val participantName = "John Doe"

var micEnabled = true
var webcamEnabled = true

// generate the jwt token from your api server and add it here
VideoSDK.config("JWT TOKEN GENERATED FROM SERVER")

// create a new meeting instance
meeting = VideoSDK.initMeeting(
this@MeetingActivity, meetingId, participantName,
micEnabled, webcamEnabled,null,null)

// get permissions and join the meeting with meeting.join();
// checkPermissionAndJoinMeeting();
}

All set! Here is the link to the complete sample code on Github. Please refer to the documentation for a full list of available methods, events and features of the SDK.