快捷评论是一个操作功能，并非一种消息类型。评论内容并非一条消息，而是一个 int 类型，由开发者指定评论内容与界面展示之间的联系。

快捷评论的 UI 示例见下图。

前提条件

开始圈组快捷评论相关集成前，请确保：

• 已开通圈组的快捷评论功能。圈组的快捷评论功能需要在开通圈组功能的基础上额外开通后才能使用。
• 已完成圈组初始化。

实现方法

添加/移除快捷评论

API 调用时序

sequenceDiagram



note over NIM SDK: 初始化 SDK 并登录 IM
note over NIM SDK: 注册监听并登录圈组
发送方 ->> NIM SDK: 监听消息接收事件<br>(onReceiveMessage)
发送方 ->> NIM SDK: 监听系统通知接收事件<br>(onReceiveSystemNotification)
发送方 ->> NIM SDK: 登录圈组
接收方 ->> NIM SDK: 监听消息接收事件<br>(onReceiveMessage)
接收方 ->> NIM SDK: 监听系统通知接收事件<br>(onReceiveSystemNotification)
接收方 ->> NIM SDK: 登录圈组
note over NIM SDK: 双方成为同一服务器的成员
note over NIM SDK: 双方都能访问同一频道
note over NIM SDK: 双方都拥有发送消息的权限
note over NIM SDK: 消息收发
发送方 ->> NIM SDK: 在频道发送消息
NIM SDK ->> 接收方: 投递消息(QChatMessage)
接收方 ->> NIM SDK: 为接收到的消息添加快捷评论<br>(addQuickComment)
NIM SDK ->> 发送方: 系统通知
NIM SDK -->接收方: 系统通知
接收方 ->> NIM SDK: 移除快捷评论<br>(removeQuickComment)
NIM SDK ->> 发送方: 系统通知
NIM SDK ->> 接收方: 系统通知

具体流程

1. 发送方和接收方注册回调函数并登录。

   • 注册onReceiveMessage消息接收事件流，监听消息接收。
   • 注册onReceiveSystemNotification系统通知接收事件流，监听快捷评论添加和移除。

   示例代码如下：

   注册消息接收事件流

   dartNimCore.instance.qChatObserver.onReceiveMessage.listen((event) {
     // 收到消息qChatMessages
     for (var qChatMessage in event) {
       // 处理消息
     }
   });
   

   注册系统通知接收事件流

   dartNimCore.instance.qChatObserver.onReceiveSystemNotification.listen((event) {
     // 收到系统通知
     for (var qChatSystemNotification in event) {
       // 处理系统通知
     }
   });
   

2. 接收方在收到消息后，调用addQuickComment方法为接收到的消息添加快捷评论。调用成功后，系统通知接收事件流的回调触发，发送方和接收方收到系统通知（QChatSystemNotificationType.update_quick_comment）。

   该方法的入参结构QChatRemoveQuickCommentParam需要传入待评论的消息QChatMessage和评论类型。

   用户也可在搜索/查询消息后为消息添加快捷评论，本文仅以接收消息后添加快捷评论作为示例进行说明。

   
   

   示例代码如下：

   dartfinal message = getMessage();
   final type = 1;
   final param = QChatAddQuickCommentParam(message, type);
   NimCore.instance.qChatMessageService.addQuickComment(param).then((value) {
     if (value.isSuccess) {
       // 添加成功
     } else {
       // 添加失败
     }
   });
   

3. （可选）接收方调用removeQuickComment 方法移除快捷评论。调用成功后，系统通知接收事件流的回调函数触发，发送方和接收方收到系统通知（QChatSystemNotificationType.UPDATE_QUICK_COMMENT）。

   该方法的入参结构QChatRemoveQuickCommentParam需要传入待评论的消息QChatMessage和评论类型（int类型）。

   示例代码如下： ​

   dartfinal message = getMessage();
   final type = 1;
   final param = QChatRemoveQuickCommentParam(message, type);
   NimCore.instance.qChatMessageService.removeQuickComment(param).then((value) {
     if (value.isSuccess) {
       // 删除成功
     } else {
       // 删除失败
     }
   });
   

查询快捷评论列表

调用getQuickComments可查询指定消息所包含的快捷评论列表。

• 该方法的入参结构QChatGetQuickCommentsParam中需要传入需要查询的serverId、channelId和消息列表。回参结构QChatGetQuickCommentsResult返回快捷评论详情 Map，key 为消息的msgIdServer，value 为QChatMessageQuickCommentDetail。

  其中QChatMessageQuickCommentDetail的参数说明如下：

  类型	参数	说明
  int	serverId	服务器 ID
  int	channelId	频道 ID
  int	msgIdServer	消息的服务端 ID
  int	totalCount	总评论数
  int	lastUpdateTime	消息评论最后一次操作的时间
  List<QChatQuickCommentDetail>	details	评论详情列表

  其中QChatQuickCommentDetail的参数说明如下：

  类型	参数	说明
  int	type	评论类型
  int	getCount	评论数量
  bool	hasSelf	自己是否添加了该类型评论
  List<String>	severalAccids	若干个添加了此类型评论的用户 ID （accid）列表，随机获取结果

• 示例代码

  dartfinal msgList = getMsgList();
  final param = QChatGetQuickCommentsParam(serverId: serverId, channelId: channelId, msgList: msgList);
  NimCore.instance.qChatMessageService.getQuickComments(param).then((value) {
    if (value.isSuccess) {
      // 查询成功，消息快捷评论详情Map，key为MsgIdServer，value为QChatMessageQuickCommentDetail
      var messageQuickCommentDetailMap = value.data?.messageQuickCommentDetailMap;
    } else {
      // 查询失败
    }
  });