For AI agents: this page in Markdown: https://www.pubnub.com/docs/chat/kotlin-chat-sdk/learn/chat-entities/channel.md. Documentation index: https://www.pubnub.com/llms-full.txt.
Channel entity
The Channel object represents a single chat room where users can send and receive messages.
Properties
The Channel interface has the following properties:
1interface Channel {
2 val chat: Chat
3 val id: String
4 val name: String?
5 val custom: Map<String, Any?>?
6 val description: String?
7 val updated: String?
8 val status: String?
9 val type: ChannelType?
10
11 ...
12}
chat#- Reference to the main
Chatobject. name#- Display name or title of the channel.
custom#- Any custom properties or metadata associated with the channel in the form of a map of key-value pairs. App Context filtering language doesn’t support filtering by custom properties.
description#- Brief description or summary of the channel's purpose or content.
updated#- Timestamp for the last time the channel was updated or modified.
status#- Current status of the channel, like
online,offline, orarchived. type#- One of the available channel types:
direct(1:1)group(multiple people, restricted by invitation)public(open chat for a large audience, anyone can join it)unknownfor channels created using the Kotlin SDK instead of Chat SDK, whose type provided in channel metadata is different than the three default Chat SDK types.
API limits
To learn about the maximum length of parameters used to set channel metadata, refer to REST API docs.
Methods
The Channel object exposes the following methods.
Regular methods
createMessageDraftdelete()deleteFile()emitCustomEvent()fetchReadReceipts()forwardMessage()getFiles()getHistory()getMember()getMembers()getMessage()getMessageReportsHistory()getPinnedMessage()getUserRestrictions()getUsersRestrictions()getUserSuggestions()hasMember()invite()inviteMultiple()isPresent()join()leave()pinMessage()registerForPush()sendText()setRestrictions()startTyping()stopTyping()unpinMessage()unregisterFromPush()update()whoIsPresent()
Event listeners
onCustomEvent()onDeleted()onMessageReceived()onMessageReported()onPresenceChanged()onReadReceiptReceived()onTypingChanged()onUpdated()(deprecated)connect()(deprecated)getTyping()(deprecated)streamMessageReports(deprecated)streamPresence()(deprecated)streamReadReceipts()(deprecated)streamUpdates()
Use case
For example, you can use the Channel object methods to:
- Let users send messages.
- Create and manage a 1:1, group, or public channel (chat).
- Invite others to join the channel.
- Configure a typing indicator to track when someone in the room is writing a message.
- Register the channel for mobile push notifications, not to miss a single message.
- Emit custom events on the channel.