语聊房中的聊天消息功能可以让用户在语聊房中自由交流，促进用户之间的沟通交流，提高用户参与度。本文介绍如何通过 NERoom 房间组件实现语聊房的聊天消息，包括文本消息、自定义消息。

功能介绍

聊天消息功能可以让用户在语聊房中建立更加紧密的社交关系，提高用户对语聊房的依赖和粘性，从而增加用户的使用时长和活跃度。

语聊房中的消息类型主要是文本消息，包括：文本、超链接、emoji 表情符号等。

功能原理

消息收发流程如下：

1. 房间内的用户 A 发送一条消息到云信的 NERoom IM 服务器。
2. IM服务器投递给房间内聊天室内的其他成员。如果消息为广播消息，则全员投递，如果为定向消息，则仅投递指定的成员。
3. 目标用户收到消息。

API 调用时序图

sequenceDiagram
    autonumber
    participant 应用层
    participant NERoom 房间组件

    应用层->>NERoom 房间组件: addEventCallback 添加监听
    应用层->>NERoom 房间组件: joinChatroom 进入聊天室
    NERoom 房间组件-->>应用层: memberJoinChatroom 成员进入聊天室的回调
    

    rect rgb(191, 223, 255)
    应用层 ->> NERoom 房间组件: sendDirectTextMessage 定向给某个人发送文本消息
    应用层 ->> NERoom 房间组件:sendGroupTextMessage 给多人发送文本消息
    NERoom 房间组件-->>应用层: chatroomMessagesReceived  收到文本消息的回调
    end

实现方法

1. 调用 addRoomListener 接口添加相关监听，聊天消息相关的事件主要如下：

    NERoomEventCallback _roomEventCallback = NERoomEventCallback(
        memberJoinChatroom:_notifyMemberJoinChatroom,
        memberLeaveChatroom:_notifyMemberLeaveChatroom,
        chatroomMessagesReceived: _notifyChatroomMessagesReceived
    );
    NERoomContext? _currentRoomContext = NERoomKit.instance.roomService.getRoomContext("roomUuid");
   _currentRoomContext?.addEventCallback(_roomEventCallback);

     void _notifyMemberJoinChatroom(List<NERoomMember> members) {
  }

  void _notifyMemberLeaveChatroom(List<NERoomMember> members) {
  }

  void _notifyChatroomMessagesReceived(List<NERoomChatMessage> messages) {
  }

2. 调用 joinChatroom 接口进入聊天室。

    NERoomContext? _currentRoomContext = NERoomKit.instance.roomService.getRoomContext("roomUuid");
    _currentRoomContext?.chatController.joinChatroom();

3. 成员进入聊天室成功后，会触发 NERoomListener 协议中的 memberJoinChatroom 回调方法，通知房间内所有成员。
4. 调用 sendDirectTextMessage 接口，定向给某个人发送文本消息。

  NERoomContext? _currentRoomContext = NERoomKit.instance.roomService.getRoomContext("roomUuid");
    _currentRoomContext?.chatController.sendDirectTextMessage(userUuid, "message");

5. 调用 sendGroupTextMessage 接口，给多人发送文本消息。

  var users=["userUuid1","userUuid2"];
    _currentRoomContext?.chatController.sendGroupTextMessage(users, "message");

6. 接收方收到文本消息时，会触发 chatroomMessagesReceived 回调。