Connection Status

Monitor real-time WebSocket connection status to CometChat servers in the Android SDK with listeners and reconnect handling.

AI Integration Quick Reference

// Add connection listener
CometChat.addConnectionListener("LISTENER_ID", object : ConnectionListener {
    override fun onConnected() { /* Connection established */ }
    override fun onConnecting() { /* Attempting to connect */ }
    override fun onDisconnected() { /* Connection lost */ }
    override fun onFeatureThrottled() { /* Features throttled */ }
    override fun onError(e: CometChatException) { /* Connection error */ }
})

// Get current connection status
val status = CometChat.getConnectionStatus()
// Returns: WS_STATE_CONNECTED, WS_STATE_CONNECTING, WS_STATE_DISCONNECTED, or WS_STATE_FEATURE_THROTTLED

// Remove listener
CometChat.removeConnectionListener("LISTENER_ID")

Use ConnectionListener to monitor real-time WebSocket connection state. The SDK automatically attempts to reconnect when disconnected.

Callback	Description
onConnecting	SDK is attempting to establish a WebSocket connection
onConnected	Connection successfully established
onDisconnected	Connection lost (network fluctuation, etc.)
onFeatureThrottled	CometChat toggled off certain features to prevent performance loss

Error callbacks receive a CometChatException with details about the connection failure.

Java

CometChat.addConnectionListener("UNIQUE_LISTENER_ID", new CometChat.ConnectionListener() {
  @Override
    public void onConnected() {
    Log.i(TAG, "onConnected: ");
  }
  
  @Override
    public void onConnecting() {
    Log.i(TAG, "onConnecting: ");
  }

  @Override
    public void onDisconnected() {
    Log.i(TAG, "onDiconnected: ");
  }
  
  @Override
    public void onFeatureThrottled() {
    Log.i(TAG, "onFeatureThrottled: ");
  }
  
  @Override
    public void onConnectionError(CometChatException e) {
    Log.i(TAG, "onConnectionError: ");
  }
});

Kotlin

CometChat.addConnectionListener("UNIQUE_LISTENER_ID", object : ConnectionListener {
  override fun onConnected() {
    Log.i(TAG, "onConnected: ")
  }

  override fun onConnecting() {
    Log.i(TAG, "onConnecting: ")
  }

  override fun onDisconnected() {
    Log.i(TAG, "onDiconnected: ")
  }

  override fun onFeatureThrottled() {
    Log.i(TAG, "onFeatureThrottled: ")
  }
  
  override fun onError(e: CometChatException) {
    Log.i(TAG, "onError: ")
  }
}) 

Get Current Status

Use getConnectionStatus() to check the current connection state at any time:

Java

String connectionStatus = CometChat.getConnectionStatus();  

Kotlin

val connectionStatus = CometChat.getConnectionStatus() 

Returns one of:

Value	Description
CometChatConstants.WS_STATE_CONNECTED	Active connection
CometChatConstants.WS_STATE_CONNECTING	Attempting to connect
CometChatConstants.WS_STATE_DISCONNECTED	No connection
CometChatConstants.WS_STATE_FEATURE_THROTTLED	Feature throttled

Know more about CometChat SDK connection behaviour click here

---

Next Steps

Connection Behaviour

Learn about SDK connection behavior and reconnection logic

Setup

Initialize the SDK and establish connection

User Presence

Track user online/offline status

Real-Time Listeners

Register listeners for messages, users, groups, and calls