Initialization

You must initialize the Chat UI SDK before using any Chat UI screens.

When to initialize

Call the initialization method in Application#onCreate():

Kotlin

kotlin

import ai.nexconn.chat.params.InitParams
import ai.nexconn.chatui.NCChatUI

override fun onCreate() {
  super.onCreate()
  val appKey = "Your_AppKey"
  NCChatUI.initialize(InitParams(applicationContext, appKey))
}

Java

Java

import ai.nexconn.chat.params.InitParams;
import ai.nexconn.chatui.NCChatUI;

@Override
public void onCreate() {
    super.onCreate();
    String appKey = "Your_AppKey";
    NCChatUI.initialize(new InitParams(getApplicationContext(), appKey));
}

Connect

After initialization, call the connect method when your business login succeeds:

Kotlin

kotlin

import ai.nexconn.chat.params.ConnectParams

val token = "Your_Token"
NCChatUI.connect(ConnectParams(token)) { userId, error ->
  if (error == null) {
    // Connection succeeded
  } else {
    // Connection failed
  }
}

Java

Java

import ai.nexconn.chat.params.ConnectParams;
import ai.nexconn.chat.error.NCError;
import ai.nexconn.chat.handler.ConnectHandler;

String token = "Your_Token";
NCChatUI.connect(new ConnectParams(token), new ConnectHandler() {
    @Override
    public void onResult(String userId, NCError error) {
        if (error == null) {
            // Connection succeeded
        } else {
            // Connection failed
        }
    }
});

Disconnect and logout

Kotlin

kotlin

// Disconnect but keep push notifications enabled
NCChatUI.disconnect()

// Disconnect and disable push notifications
NCChatUI.logout()

Java

Java

// Disconnect but keep push notifications enabled
NCChatUI.disconnect();

// Disconnect and disable push notifications
NCChatUI.logout();

Check initialization status

Kotlin

kotlin

if (NCChatUI.isInitialized()) {
  // safe to use ChatUI APIs
}

Java

Java

if (NCChatUI.isInitialized()) {
    // safe to use ChatUI APIs
}

Notes

• Initialize only once per application lifecycle.
• Initialize before connecting.
• Manage connection listeners at the UI layer and handle errors appropriately.