NexconnChatSDK/ai.nexconn.chat.handler/MessageHandler

MessageHandler

public interface MessageHandler

Message event handler.

Listens for all message-related event notifications, including:

Receive: real-time and offline message reception, offline sync completion
Lifecycle: message deletion (recall), modification, and blocking (sensitive word filtering)
Read receipts: read receipt responses from other users
Metadata: message metadata (expansion) updates and deletions
Speech-to-text: voice message transcription completion
Stream messages: stream request init, incremental chunks, and completion
Community: community channel message metadata changes

Register via NCEngine.addMessageHandler. All callback methods have default empty implementations; override only the callbacks you need.

NCEngine.addMessageHandler("MSG_HANDLER_ID", object : MessageHandler {
    override fun onMessageReceived(event: MessageReceivedEvent) {
        println("Received: ${event.message.messageId}")
    }

    override fun onMessageReceiptResponse(event: MessageReceiptResponseEvent) {
        event.responses.forEach { response ->
            println("Message ${response.messageId} read count: ${response.readCount}")
        }
    }

    override fun onMessageBlocked(event: MessageBlockedEvent) {
        println("Message blocked: ${event.info.messageId}, reason: ${event.info.blockType}")
    }
})

Functions

onCommunityChannelMessageMetadataChanged

public Unit onCommunityChannelMessageMetadataChanged(CommunityChannelMessageMetadataChangedEvent event)

Called when community channel message metadata (expansion) is changed.

onMessageBlocked

public Unit onMessageBlocked(MessageBlockedEvent event)

Called when a sent message is blocked due to sensitive words.

onMessageDeleted

public Unit onMessageDeleted(MessageDeletedEvent event)

Called when a message is deleted (recalled).

onMessageMetadataDeleted

public Unit onMessageMetadataDeleted(MessageMetadataDeletedEvent event)

Called when message metadata (expansion) keys are deleted.

onMessageMetadataUpdated

public Unit onMessageMetadataUpdated(MessageMetadataUpdatedEvent event)

Called when message metadata (expansion) is updated.

onMessageReceiptResponse

public Unit onMessageReceiptResponse(MessageReceiptResponseEvent event)

Called when read receipts are received.

onMessageReceived

public Unit onMessageReceived(MessageReceivedEvent event)

Called when a message is received.

onMessagesModified

public Unit onMessagesModified(MessagesModifiedEvent event)

Called when a message is modified.

onModifiedMessageSyncCompleted

public Unit onModifiedMessageSyncCompleted(ModifiedMessageSyncCompletedEvent event)

Called when offline modified message records have been fully synced.

onOfflineMessageSyncCompleted

public Unit onOfflineMessageSyncCompleted(OfflineMessageSyncCompletedEvent event)

Called when offline message sync completes.

onSpeechToTextCompleted

public Unit onSpeechToTextCompleted(SpeechToTextCompletedEvent event)

Called when speech-to-text conversion completes.

onStreamMessageRequestComplete

public Unit onStreamMessageRequestComplete(StreamMessageRequestCompleteEvent event)

Called when a stream message request completes.

onStreamMessageRequestDelta

public Unit onStreamMessageRequestDelta(StreamMessageDeltaEvent event)

Called when an incremental stream chunk is received.

onStreamMessageRequestInit

public Unit onStreamMessageRequestInit(StreamMessageRequestInitEvent event)

Called when a stream message request is initialized.