Rate this page:

Android

Android SDK has four dependencies: okhttp, gson, androidx annotations, and relinker. You can check the levels of dependencies directly in Maven. Note that the last release appear in Maven with a delay.

Add Voximplant libraries to your project

Copy URL
  1. Add Voximplant to the build.gladle's dependencies section. Paste the current version from the changelog:
dependencies {
    ...
    // Paste the actual version from the changelog
    implementation 'com.voximplant:voximplant-sdk:2.38.0'
}
  1. Since the 2.5.0 version, it is required to add Java 8 support to your project in the build.gradle file:
android {
    ... //other configs
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

Initialize the SDK

Copy URL

With the latest version of the Android SDK, you do not need to declare permissions in the AndroidManifest.xml file manually.

Our SDK automatically declares the following permissions:

  • ACCESS_NETWORK_STATE

  • BLUETOOTH

  • BLUETOOTH_CONNECT

  • CAMERA

  • CHANGE_NETWORK_STATE

  • MODIFY_AUDIO_SETTINGS

  • RECORD_AUDIO

  • INTERNET

  • WRITE_EXTERNAL_STORAGE

Bluetooth permissions

On Android 12 or higher, the BLUETOOTH_CONNECT permission is required. The permission must be granted before the call. Without granting this permission, Bluetooth audio devices will not be available. There is no need to request the permission on Android 11 or lower.

See Available Roles
Audio and video permissions

The CAMERA and RECORD_AUDIO permissions need a user prompt since Android 6.0 (use the Voximplant.getMissingPermissions method to see the permissions which are not granted by the user).

See Available Roles

Сreate a Voximplant client instance of IClient type and initialize it:

IClient

IClient

Connect and login

Copy URL

Use the IClient.connect method to connect to the Voximplant cloud and the IClient.login method to login your user.

To track connection and authorization errors, use the IClientSessionListener and IClientLoginListener event listeners.

Refer to this code example to understand how it works:

Connect and login

Connect and login

Start implementing functionality

Copy URL

Now you have your application and SDK set up and successfully connected to the Voximplant cloud. To start implementing desired functionality, such as calls, conferences, messages, and more, go to the Guides section of our documentation and pick the features you need.

Android SDK demos

Copy URL

Implement the desired functionality by following step-by-step Guides or download and test our latest Android SDK here:

  • Audio call with ConnectionService: Demonstrates how to integrate ConnectionService with a voice call created with the Voximplant Android SDK.

  • Video call: Demonstrates the basic video call and screen sharing functionality of the Voximplant Android SDK.

  • Video call with DeepAR: Demonstrates how to integrate Voximplant Android SDK with DeepAR SDK to add face masks to a video call app.

  • Videoconf solution: Demonstrates how videoconf.voximplant.com works. Using it, you can create conferences, join existing conferences, use reactions, create chats, and do many more useful things.

  • Messaging: Demonstrates how to create your web and mobile messaging client based on the Voximplant SDKs.