浏览 SDKs · Android
平台
SDKsAndroid商业版

查询群消息已读成员

分页查询群聊中某条消息的已读或未读成员列表。

复制

分页获取指定群消息的已读或未读成员列表。支持通过筛选条件区分已读与未读成员,常用于群消息详情页展示已读人员清单。

String conversationID = "g_group_123";
String clientMsgID = "msg_001";
int filter = 0; // 0 查询已读成员,1 查询未读成员
int offset = 0;
int count = 50;

OpenIMClient.getInstance().messageManager.getGroupMessageReaderList(
    conversationID,
    clientMsgID,
    filter,
    offset,
    count,
    new OnBase<List<GroupMembersInfo>>() {
        @Override
        public void onSuccess(List<GroupMembersInfo> members) {
            // members 为查询到的成员资料列表
        }

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

筛选类型说明

filter 字段用于指定查询已读还是未读成员:

筛选值含义
0查询已读该消息的群成员列表。
1查询尚未阅读该消息的群成员列表。

参数说明

参数类型是否必填说明
conversationIDString是目标群聊会话 ID。
clientMsgIDString是待查询的目标消息客户端 ID。
filterint是阅读状态筛选:0 查询已读成员,1 查询未读成员。
offsetint是分页起始偏移量,首页传 0。
countint是本次获取的最大记录条数。
baseOnBase<List<GroupMembersInfo>>是异步请求回调。

返回结果

成功回调返回群成员资料列表 List<GroupMembersInfo>。单条记录包含群内昵称 nickname、群内头像 faceURL、角色等级 roleLevel 等详细属性,字段说明请参阅分页查询群成员。