메뉴
Complete catalog of CometChat Android UI Kit v5 components. Reference before writing integration code — never invent component names.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Angular-specific integration patterns for CometChat UI Kit v5 (@cometchat/chat-uikit-angular@5) — standalone bootstrap with main.ts init-before-bootstrap, functional route guards (CanActivateFn), lazy standalone routes (loadComponent), NgZone correctness for SDK callbacks, OnPush change detection, and SSR/Angular-Universal considerations.
Framework-specific patterns for integrating CometChat React UI Kit v6 into Astro projects using React islands. Covers client:only rendering, island communication, CSS handling, and common pitfalls.
Shared rules for CometChat React UI Kit v6. Always loaded alongside framework + placement skills. Read this first.
Add features (calls, reactions, polls, file sharing, presence, etc.) to an already-integrated CometChat project. Routes to the right sub-flow based on feature type — default (already enabled), extension (API toggle), ai-feature (API toggle + OpenAI key), dashboard-only (third-party config), package-install (calls), or component-swap (rich text).
Localization (i18n) across all CometChat UI Kit families — React, React Native, Angular, Android (V5/V6), iOS, Flutter (V5/V6). Covers CometChatLocalize.init signature differences (positional vs object), bundled languages, custom-language registration, RTL support, fallback to English, and cross-family drift risks. Cross-family — applies wherever the agent is configuring CometChat localization.
Integration patterns for bare React Native CLI projects — pod install, Info.plist + AndroidManifest permissions, Apple privacy manifest, native module linking, Metro config.
| name | cometchat-android-v5-components |
| description | Complete catalog of CometChat Android UI Kit v5 components. Reference before writing integration code — never invent component names. |
| license | MIT |
| compatibility | Android 7.0+; Java 8+; Kotlin 1.8+; com.cometchat:chat-uikit-android:5.x |
| metadata | {"author":"CometChat","version":"3.0.0","tags":"chat cometchat android components catalog reference ui-kit views"} |
Ground truth:
com.cometchat:chat-uikit-android:5.x(legacy/maintenance-only) component catalog (javap the AAR) +docs/ui-kit/android. Official docs: https://www.cometchat.com/docs/ui-kit/android/components-overview · Docs MCP:claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp(or fetch the URL directly without MCP). Verify symbols against the installed package/source before relying on them.
Companion skills:
cometchat-android-v5-corecovers initialization and login;cometchat-android-v5-placementcovers where to put these components;cometchat-android-v5-customizationcovers how to modify component behavior.
This is the single source of truth for CometChat Android UI Kit v5 component names, key methods, and usage. Check this catalog before writing any CometChat view code. If a component is not listed here, it does not exist in the UI Kit.
Most top-level components extend MaterialCardView and can be used in XML layouts or created programmatically. Some lower-level views have different base classes — e.g. CometChatDate extends LinearLayout, CometChatMessageReceipt extends AppCompatImageView, CometChatEmojiKeyboard extends BottomSheetDialogFragment, and CometChatConfirmDialog extends Dialog. The main components follow a consistent pattern: set a User or Group object, configure visibility/style via setters, and attach callbacks for user interactions.
CometChat* viewcometchat-android-v5-corecometchat-android-v5-themingcometchat-android-v5-customizationThese are the components you use to build a chat experience. Most integrations use some combination of these.
Renders a scrollable list of the logged-in user's conversations (both 1:1 and group).
Key methods:
| Method | Type | Description |
|---|---|---|
setOnItemClick(OnItemClick<Conversation>) | Callback | Called when user taps a conversation |
setSelectionMode(UIKitConstants.SelectionMode) | Config | NONE, SINGLE, MULTIPLE |
setSearchBoxVisibility(int) | Visibility | Show/hide the search bar |
setUserStatusVisibility(int) | Visibility | Show/hide online status indicators |
setReceiptsVisibility(int) | Visibility | Show/hide read receipts |
setDeleteConversationOptionVisibility(int) | Visibility | Show/hide delete option on swipe |
setBackIconVisibility(int) | Visibility | Show/hide back button |
setOnError(OnError) | Callback | Error handler |
setOnLoad(OnLoad<Conversation>) | Callback | Called when conversations are loaded |
setOnEmpty(OnEmpty) | Callback | Called when list is empty |
XML usage:
<com.cometchat.chatuikit.conversations.CometChatConversations
android:id="@+id/conversations"
android:layout_width="match_parent"
android:layout_height="match_parent" />
Java:
CometChatConversations conversations = findViewById(R.id.conversations);
conversations.setOnItemClick((view, position, conversation) -> {
// Navigate to message screen with conversation.getConversationWith()
});
Kotlin:
val conversations = findViewById<CometChatConversations>(R.id.conversations)
conversations.setOnItemClick { view, position, conversation ->
// Navigate to message screen with conversation.conversationWith
}
Renders messages for a specific user or group conversation. The main chat area.
Key methods:
| Method | Type | Description |
|---|---|---|
setUser(User) | Config | Show messages with this user (mutually exclusive with setGroup) |
setGroup(Group) | Config | Show messages in this group (mutually exclusive with setUser) |
setParentMessage(long) | Config | If set, shows only thread replies (note: list takes the parent ID as long via setParentMessage, NOT setParentMessageId) |
setOnThreadRepliesClick(ThreadReplyClick) | Callback | Called when "Reply in Thread" is tapped |
setOnError(OnError) | Callback | Error handler |
setOnLoad(OnLoad<BaseMessage>) | Callback | Called when messages are loaded |
setReplyInThreadOptionVisibility(int) | Visibility | Show/hide thread reply option |
setReplyOptionVisibility(int) | Visibility | Show/hide reply option |
setCopyMessageOptionVisibility(int) | Visibility | Show/hide copy option |
setEditMessageOptionVisibility(int) | Visibility | Show/hide edit option |
setDeleteMessageOptionVisibility(int) | Visibility | Show/hide delete option |
setReceiptsVisibility(int) | Visibility | Show/hide read receipts |
setAvatarVisibility(int) | Visibility | Show/hide sender avatars |
setTextFormatters(List<CometChatTextFormatter>) | Config | Custom text formatters |
setTemplates(List<CometChatMessageTemplate>) | Config | Custom message bubble templates |
Java:
CometChatMessageList messageList = findViewById(R.id.messageList);
messageList.setUser(user); // or messageList.setGroup(group);
Kotlin:
val messageList = findViewById<CometChatMessageList>(R.id.messageList)
messageList.setUser(user) // or messageList.setGroup(group)
A text input with send button, attachment options, emoji, and voice note support. Sends messages to the specified user or group.
Key methods:
| Method | Type | Description |
|---|---|---|
setUser(User) | Config | Send messages to this user |
setGroup(Group) | Config | Send messages to this group |
setParentMessageId(long) | Config | Thread mode — sends replies to this message |
setOnSendButtonClick(SendButtonClick) | Callback | Custom send button handler |
setOnError(OnError) | Callback | Error handler |
setAttachmentButtonVisibility(int) | Visibility | Show/hide attachment button |
setVoiceNoteButtonVisibility(int) | Visibility | Show/hide voice note button |
setSendButtonVisibility(int) | Visibility | Show/hide send button |
setHeaderView(View) | Custom view | Custom view above the composer |
setFooterView(View) | Custom view | Custom view below the composer |
setAuxiliaryButtonView(View) | Custom view | Custom auxiliary button (takes a plain View) |
disableTypingEvents(boolean) | Config | Disable typing indicators (note: no set prefix) |
setDisableMentions(boolean) | Config | Disable @mentions |
Java:
CometChatMessageComposer composer = findViewById(R.id.composer);
composer.setUser(user); // or composer.setGroup(group);
Kotlin:
val composer = findViewById<CometChatMessageComposer>(R.id.composer)
composer.setUser(user) // or composer.setGroup(group)
Displays the name, avatar, and status of the user or group at the top of a message view.
Key methods:
| Method | Type | Description |
|---|---|---|
setUser(User) | Config | Show header for this user |
setGroup(Group) | Config | Show header for this group |
setBackIconVisibility(int) | Visibility | Show/hide back button |
setOnBackPress(OnBackPress) | Callback | Back button handler |
setUserStatusVisibility(int) | Visibility | Show/hide online status |
setVideoCallButtonVisibility(int) | Visibility | Show/hide video call button |
setVoiceCallButtonVisibility(int) | Visibility | Show/hide voice call button |
setSubtitleView(Function3) | Custom view | Custom subtitle view |
setTrailingView(Function3) | Custom view | Custom trailing view |
setLeadingView(Function3) | Custom view | Custom leading view |
Java:
CometChatMessageHeader header = findViewById(R.id.header);
header.setUser(user);
header.setBackIconVisibility(View.VISIBLE);
header.setOnBackPress(() -> finish());
Kotlin:
val header = findViewById<CometChatMessageHeader>(R.id.header)
header.setUser(user)
header.setBackIconVisibility(View.VISIBLE)
header.setOnBackPress { finish() }
Renders a scrollable list of users with alphabetical sticky headers.
Key methods:
| Method | Type | Description |
|---|---|---|
setOnItemClick(OnItemClick<User>) | Callback | Called when user taps a user |
setSelectionMode(UIKitConstants.SelectionMode) | Config | NONE, SINGLE, MULTIPLE |
setSearchBoxVisibility(int) | Visibility | Show/hide search bar |
setUserStatusVisibility(int) | Visibility | Show/hide online status |
setOnSelect(OnSelection<User>) | Callback | Called when selection changes (note: setOnSelect for Users + Conversations; setOnSelection for Groups + GroupMembers) |
Renders a scrollable list of groups.
Key methods:
| Method | Type | Description |
|---|---|---|
setOnItemClick(OnItemClick<Group>) | Callback | Called when user taps a group |
setSelectionMode(UIKitConstants.SelectionMode) | Config | NONE, SINGLE, MULTIPLE |
setSearchBoxVisibility(int) | Visibility | Show/hide search bar |
setOnSelection(OnSelection<Group>) | Callback | Called when selection changes |
Renders the member list for a specific group.
Key methods:
| Method | Type | Description |
|---|---|---|
setGroup(Group) | Config | Required — the group to show members for |
setOnItemClick(OnItemClick<GroupMember>) | Callback | Called when user taps a member |
setSelectionMode(UIKitConstants.SelectionMode) | Config | NONE, SINGLE, MULTIPLE |
Renders a list of past calls with duration, type, and timestamp.
Incoming call notification banner with accept/reject buttons. Typically added to your root Activity layout.
Outgoing call screen with ringing indicator.
Active call view (video/audio, controls).
Search component for finding conversations and messages.
Full reaction list showing who reacted with which emoji.
Thread header with parent message preview and reply count.
These are lower-level views used inside the main components:
| View | Description |
|---|---|
CometChatAvatar | User/group avatar (image + fallback initials) |
CometChatBadge | Unread count badge |
CometChatStatusIndicator | Online/offline status dot |
CometChatMessageReceipt | Message delivery/read receipt icons |
CometChatDate | Formatted date display |
CometChatMessageBubble | Message bubble container |
CometChatEmojiKeyboard | Emoji picker grid |
CometChatConfirmDialog | Confirmation dialog |
CometChatPopupMenu | Context menu / popup menu |
The most common pattern — conversation list on one side, active chat on the other. On phones, this is typically two Activities or Fragments with navigation between them.
Java:
// In ConversationsFragment or Activity
CometChatConversations conversations = findViewById(R.id.conversations);
conversations.setOnItemClick((view, position, conversation) -> {
Intent intent = new Intent(this, MessagesActivity.class);
if (conversation.getConversationType().equals("user")) {
intent.putExtra("uid", ((User) conversation.getConversationWith()).getUid());
} else {
intent.putExtra("guid", ((Group) conversation.getConversationWith()).getGuid());
}
startActivity(intent);
});
// In MessagesActivity
CometChatMessageHeader header = findViewById(R.id.header);
CometChatMessageList messageList = findViewById(R.id.messageList);
CometChatMessageComposer composer = findViewById(R.id.composer);
String uid = getIntent().getStringExtra("uid");
if (uid != null) {
CometChat.getUser(uid, new CometChat.CallbackListener<User>() {
@Override
public void onSuccess(User user) {
header.setUser(user);
messageList.setUser(user);
composer.setUser(user);
}
@Override
public void onError(CometChatException e) { }
});
}
Kotlin:
// In ConversationsFragment or Activity
val conversations = findViewById<CometChatConversations>(R.id.conversations)
conversations.setOnItemClick { view, position, conversation ->
val intent = Intent(this, MessagesActivity::class.java)
when (conversation.conversationType) {
"user" -> intent.putExtra("uid", (conversation.conversationWith as User).uid)
"group" -> intent.putExtra("guid", (conversation.conversationWith as Group).guid)
}
startActivity(intent)
}
// In MessagesActivity
val header = findViewById<CometChatMessageHeader>(R.id.header)
val messageList = findViewById<CometChatMessageList>(R.id.messageList)
val composer = findViewById<CometChatMessageComposer>(R.id.composer)
val uid = intent.getStringExtra("uid")
uid?.let {
CometChat.getUser(it, object : CometChat.CallbackListener<User>() {
override fun onSuccess(user: User) {
header.setUser(user)
messageList.setUser(user)
composer.setUser(user)
}
override fun onError(e: CometChatException) { }
})
}
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<com.cometchat.chatuikit.messageheader.CometChatMessageHeader
android:id="@+id/header"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
<com.cometchat.chatuikit.messagelist.CometChatMessageList
android:id="@+id/messageList"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1" />
<com.cometchat.chatuikit.messagecomposer.CometChatMessageComposer
android:id="@+id/composer"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
</LinearLayout>
// In HomeActivity — switch fragments based on bottom nav selection
binding.bottomNavigationView.setOnItemSelectedListener(item -> {
Fragment fragment;
if (item.getItemId() == R.id.nav_chats) {
fragment = new ChatsFragment();
} else if (item.getItemId() == R.id.nav_users) {
fragment = new UsersFragment();
} else if (item.getItemId() == R.id.nav_groups) {
fragment = new GroupsFragment();
} else if (item.getItemId() == R.id.nav_calls) {
fragment = new CallsFragment();
} else {
return false;
}
getSupportFragmentManager().beginTransaction()
.replace(R.id.fragment_container, fragment)
.commit();
return true;
});
setUser() and setGroup() are mutually exclusive. Set one or the other, never both.CometChatUIKit.getLoggedInUser() != null before mounting.MaterialCardView. They can be used in XML or created programmatically.CometChatMessageList.setParentMessage(long) (no Id suffix on the list) and CometChatMessageComposer.setParentMessageId(long). Both must point to the same parent message ID. Without them, the list and composer show the main conversation, not the thread.