Skip to content

This Sample Android App (Kotlin) demonstrates the use of the EnableX Video APIs and Android Toolkit to build a 1-to-1 real-time video chat application. This sample app is designed for Kotlin developers interested in video streaming and real-time communication (RTC).

Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



25 Commits

Repository files navigation

1-to-1 RTC: An Android App with EnableX Android Toolkit

TThis Sample Android App is a complete toolkit to build a 1-to-1 Real-Time Communication (RTC) application. Built on EnableX Video APIs and the Android Toolkit, the app covers the entire spectrum of a real-time video chat application. This sample app offers: Virtual Room Creation: The app creates a virtual room instantly, hosted on the EnableX platform. Users can join these rooms using generated room credentials. Real-Time Communication: Provides high-quality, real-time video and audio streaming capabilities. Moderator Functions: Allows setting user roles for stream control, including the ability to have one moderator. Code Flexibility: Developed in Kotlin, designed for straightforward integration and customization.

Important Links:

EnableX Platform Video APIs- Android Toolkit - EnableX Developer Center:

How to Get Started For a step-by-step guide from prerequisites like obtaining your App ID and App Key to configuring the Android client and setting up your own application server, follow the structured sections below.

EnableX Developer Center:

1. How to get started

1.1 Prerequisites

1.1.1 App Id and App Key

1.1.2 Sample Android Client

1.1.3 Test Application Server

You need to set up an Application Server to provision Web Service API for your Android Application to enable Video Session.

To help you to try our Android Application quickly, without having to set up Applciation Server, this Application is shipped pre-configured to work in a "try" mode with EnableX hosted Application Server i.e.

Our Application Server restricts a single Session duations to 10 minutes, and allows 1 moderator and not more than 3 participants in a Session.

Once you tried EnableX Android Sample Application, you may need to set up your own Application Server and verify your Application to work with your Application Server. Refer to point 2 for more details on this.

1.1.4 Configure Android Client

  • Open the App
  • Go to WebConstants and change the following:
 /* To try the App with Enablex Hosted Service you need to set the kTry = true When you setup your own Application Service, set kTry = false */
     val   kTry = true;
 /* Your Web Service Host URL. Keet the defined host when kTry = true */
     val kBaseURL = ""
 /* Your Application Credential required to try with EnableX Hosted Service
     When you setup your own Application Service, remove these */
     val kAppId = "App_ID"
     val kAppkey = "App_Key"

Note: The distributable comes with demo username and password for the Service.

1.2 Test

1.2.1 Open the App

  • Open the App in your Device. You get a form to enter Credentials i.e. Name & Room Id.
  • You need to create a Room by clicking the "Create Room" button.
  • Once the Room Id is created, you can use it and share with others to connect to the Virtual Room to carry out an RTC Session either as a Moderator or a Participant (Choose applicable Role in the Form).

Note: Only one user with Moderator Role allowed to connect to a Virtual Room while trying with EnableX Hosted Service. Your Own Application Server may allow upto 5 Moderators.

Note:- In case of emulator/simulator your local stream will not create. It will create only on real device.

2 Set up Your Own Application Server

You may need to set up your own Application Server after you tried the Sample Application with EnableX hosted Server. We have differnt variants of Appliciation Server Sample Code. Pick one in your preferred language and follow instructions given in respective file.

Note the following:

  • You need to use App ID and App Key to run this Service.
  • Your Android Client End Point needs to connect to this Service to create Virtual Room and Create Token to join the session.
  • Application Server is created using EnableX Server API, a Rest API Service helps in provisioning, session access and post-session reporting.

To know more about Server API, go to:

3 Android Toolkit

This Sample Applcation uses EnableX Android Toolkit to communicate with EnableX Servers to initiate and manage Real Time Communications. Please update your Application with latest version of EnableX Android Toolkit as and when a new release is available.

4 Application Walk-through

4.1 Create Token

We create a Token for a Room Id to get connected to EnableX Platform to connect to the Virtual Room to carry out a RTC Session.

To create Token, we make use of Server API. Refer following documentation:

4.2 Connect to a Room, Initiate & Publish Stream

We use the Token to get connected to the Virtual Room. Once connected, we intiate local stream and publish into the room. Refer following documentation for this process:

4.3 Play Stream

We play the Stream into EnxPlayerView Object.

private var enxPlayerView: EnxPlayerView? = null
enxPlayerView = EnxPlayerView(this, EnxPlayerView.ScalingType.SCALE_ASPECT_BALANCED, true)
// Attach & render Stream to Player 

// Add Player to View

More on Player:

4.4 Handle Server Events

EnableX Platform will emit back many events related to the ongoing RTC Session as and when they occur implicitly or explicitly as a result of user interaction. We use Call Back Methods to handle all such events.

/* Example of Call Back Methods */

/* Call Back Method: onRoomConnected 
Handles successful connection to the Virtual Room */ 

override fun onRoomConnected(enxRoom: EnxRoom?, jsonObject: JSONObject) {
    /* You may initiate and publish stream */

/* Call Back Method: onRoomError
 Error handler when room connection fails */
override fun onRoomError(jsonObject: JSONObject) {

/* Call Back Method: onStreamAdded
 To handle any new stream added to the Virtual Room */
override fun onStreamAdded(enxStream: EnxStream?) {
    /* Subscribe Remote Stream */

/* Call Back Method: onActiveTalkerList
 To handle any time Active Talker list is updated */
 override fun onActiveTalkerList(jsonObject: JSONObject) {
    /* Handle Stream Players */

5 Trial

EnableX provides hosted Demo Application Server of different use-case for you to try out.

Try a quick Video Call: Sign up for a free trial


This Sample Android App (Kotlin) demonstrates the use of the EnableX Video APIs and Android Toolkit to build a 1-to-1 real-time video chat application. This sample app is designed for Kotlin developers interested in video streaming and real-time communication (RTC).







No releases published