BUILT FOR ANDROID

Android
Chat UI Kit

Add Kotlin messaging screens with Tencent RTC’s Android Chat UI Kit. Bring conversations, messages, and contacts into your app with a matching visual style.

DEVELOPER RESOURCES

Android Chat UI Kit Docs & Examples

Support inside your product

Keep service requests and the customer conversation within the same app.

ANDROID CHAT CAPABILITIES

The essentials, ready to connect

Conversation lists

  • Recent conversations
  • Unread message indicators

Messaging UI

  • Connected message views
  • An integrated composer

Media sharing

  • Photos and attachments
  • Native media permissions

People and groups

  • Direct conversations
  • Group interactions

Make it yours

  • Adapt the UI source
  • Fit your navigation

Connected components

  • Chat SDK underneath
  • Your application identity

Explore the Android Chat Components

See how the components fit together.

Conversations

Start with the conversation list

Add the list page and connect conversation taps to your navigation.

Read the Documentation
ConversationsActivity.kt
import io.trtc.tuikit.chat.uikit.pages.ConversationsPageView

val page = ConversationsPageView(this)
page.setHeaderTitle("Messages")
page.onConversationClick = { conversationID ->
    // Open your ChatPageView with this conversationID.
}
setContentView(page)

CUSTOMIZATION

Customize Your Android Chat UI

Bring your visual style and application flow into chat.

Make your brand feel at home

Set your primary color and switch between light and dark themes with ThemeStore.

Read the Documentation

GET STARTED

Your first conversation starts here

  1. 01

    Create your app

    Set up a Chat application and your test users.

    Open Chat Console
  2. 02

    Add the Android Chat UI Kit

    Follow the platform guide to connect your project.

    Follow the Integration Guide
  3. 03

    Connect your users

    Sign in two test users and send your first message.

    Connect Your Users
Android Chat UI Kit
app/build.gradle.kts
// After importing the modules in settings.gradle.kts
dependencies {
    implementation(project(":uikit"))
    implementation(project(":atomic_x"))
}
ConversationsActivity.kt
import io.trtc.tuikit.chat.uikit.pages.ConversationsPageView

val page = ConversationsPageView(this)
page.setHeaderTitle("Messages")
page.onConversationClick = { conversationID ->
    // Open your ChatPageView with this conversationID.
}
setContentView(page)

Android Chat UI Kit FAQs

What does the current Android UI Kit require?

The current guide uses Kotlin, the uikit and atomic_x modules, and LoginStore. A ChatPageView host needs a Material Components theme and must release the view on destruction. Follow the guide for module imports, native permissions, and optional Call dependencies.

How is the Android UI Kit different from the SDK?

The UI Kit adds connected interface components on top of the messaging SDK. Use the Core SDK when you want to build the entire interface yourself.

How do I authenticate users of the Android Chat UI Kit?

Generate production UserSig on your backend. Pass it to the client for authentication and keep your application secret on the server.

Are these Android snippets a complete application?

They show individual integration steps. Follow the full guide for imports, initialization, login, error handling, and target-specific configuration. Test messaging with separate accounts before release.

How is Android Chat UI Kit usage priced?

Hosted Chat service usage follows your selected plan. Check the included features and allowances for your application; optional plugins and Call services can have separate requirements.

How do I integrate Android Chat UI Kit with Kotlin or Java?

Follow the Android project and manifest setup, then handle runtime permissions and Activity cleanup where required. Test on actual devices, including app background and foreground transitions.

How do I test Android Chat UI Kit before releasing my app?

Check login, SDK readiness, send and receive events, and message state after reconnecting.

How do I customize the interface for Android Chat UI Kit?

Configure the native page objects rather than React-style props. For example, call ConversationsPageView.setHeaderTitle("Messages") and connect onConversationClick to your ChatPageView screen. The Activity hosting ChatPageView must use a Material Components theme; missing theme attributes can cause runtime crashes. Preserve the selected conversation ID when customizing navigation, and keep any source changes in your imported Chat modules.

Find support for your next step

Talk about your application

Discuss your product, expected usage, and integration needs.

Contact Sales

Build your next conversation

Build your app with the Android Chat UI Kit.