Implementation

Once installation is complete and you have a valid token, launching the full video UI takes only a few lines of Kotlin code. The core integration is a single component — EnxVideoView — which you initialize with your token and add to your Activity's layout. Everything else — rendering, controls, event handling, chat, screen share — is managed internally.

Before writing integration code, confirm the following are in place:

• A valid room token obtained from your app server (see Installation — Step 4)
• Camera permission granted at runtime by the user
• Microphone permission granted at runtime by the user

Add the following imports to your Activity file. EnxVideoView is the main UI component, and EnxVideoStateObserver is the interface your Activity implements to receive lifecycle callbacks.

import com.enablex.enxuikit_android.observer.EnxVideoStateObserver
import com.enablex.enxuikit_android.view.EnxVideoView

EnxVideoView is a subclass of RelativeLayout. You instantiate it by passing four arguments: your Activity context, the room token, an observer for callbacks, and an optional Low Code embed URL. Once created, you set layout parameters and add it to the Activity's content view.

The optional embedUrl parameter links the session to a configuration defined in the EnableX Low Code Visual Builder in the Portal. If you are not using Visual Builder, pass an empty string or omit it.

// Initialize EnxVideoView
enxVideoView = EnxVideoView(
    this,                    // Activity context
    token,                   // Valid room token from your server
    this,                    // Observer for lifecycle callbacks
    "Low Code Embed URL"     // Optional: imports Low Code settings
)

// Set layout parameters to fill the screen
val rlp = RelativeLayout.LayoutParams(
    RelativeLayout.LayoutParams.MATCH_PARENT,
    RelativeLayout.LayoutParams.MATCH_PARENT
)

// Add the video view to your Activity's layout
this.addContentView(enxVideoView, rlp)

Your Activity must implement the EnxVideoStateObserver interface. This interface defines two required callbacks that notify you of session end and connection failure events. Use these callbacks to clean up your UI, navigate the user away, or display an error message.

disconnect

Called when the user successfully disconnects from the video room — either by pressing the end-call button in the UI or programmatically. The jsonObject parameter contains details about why the session ended.

// Called when the user disconnects from the video room
override fun disconnect(jsonObject: JSONObject?) {
    // jsonObject contains the reason for disconnection
    // Clean up your UI, navigate away, release resources, etc.
}

connectError

Called when the connection to the video room fails. This can happen if the token is invalid or expired, if the room does not exist, or if there is a network error during the initial connection handshake. The jsonObject parameter contains the error details.

// Called when connection to the video room fails
override fun connectError(jsonObject: JSONObject?) {
    // jsonObject contains the error details
    // Show an error message to the user, log for diagnostics, etc.
}