浏览 SDKs · Android
平台
SDKsAndroid商业版

上报群消息已读

上报指定群聊消息的已读回执。

复制

在群聊中上报当前用户已浏览消息的已读回执。当消息列表滚动或进入可视区域时,将当前屏幕内已展示的消息 ID 列表上报至服务端,用于群内发信人统计已读与未读成员状态。

String conversationID = "g_group_123";
List<String> visibleClientMsgIDs = Arrays.asList("msg_001", "msg_002");

OpenIMClient.getInstance().messageManager.sendGroupMessageReadReceipt(
    conversationID,
    visibleClientMsgIDs,
    new OnBase<String>() {
        @Override
        public void onSuccess(String data) {
            // 已读回执上报成功
        }

        @Override
        public void onError(int code, String error) {
            // 处理上报失败
        }
    }
);

参数说明

参数类型是否必填说明
conversationIDString是目标群聊会话 ID。
clientMsgIDsList<String>是当前可视区域内需要标记已读的消息客户端 ID 列表。传入的消息必须均属于目标会话。
baseOnBase<String>是异步请求回调。

返回结果

成功回调中的 data 返回确认信息。

群消息已读回执用于群内成员间同步细粒度的消息阅读状态;若需要清除当前会话在本地及服务器上的总未读计数,请调用标记会话已读。

监听群消息已读回执

群内发信方及相关端通过 OnAdvanceMsgListener.onRecvGroupMessageReadReceipt 接收群消息已读状态的增量更新:

@Override
public void onRecvGroupMessageReadReceipt(GroupMessageReceipt receipt) {
    // 根据 receipt 中记录的消息 clientMsgID 更新已读数及已读状态
}

如需查看某条具体消息的已读或未读成员明细,请参阅查询群消息已读成员。