浏览 SDKs · Android
平台
SDKsAndroid含商业版能力

获取收到的好友申请

分页查询当前账号收到的好友申请列表。

复制

分页查询当前登录账号收到的好友添加申请列表及其审批状态。常用于联系人模块的“新的朋友”页面。

GetFriendApplicationListAsRecipientReq request =
    new GetFriendApplicationListAsRecipientReq(0, 20);

OpenIMClient.getInstance().friendshipManager.getRecvFriendApplicationList(
    new OnBase<List<FriendApplicationInfo>>() {
        @Override
        public void onSuccess(List<FriendApplicationInfo> applications) {
            // 使用 applications 更新收到的好友申请列表
        }

        @Override
        public void onError(int code, String error) {
            // 处理错误
        }
    },
    request
);

参数说明

参数类型是否必填说明
baseOnBase<List<FriendApplicationInfo>>是异步请求回调。
requestGetFriendApplicationListAsRecipientReq是收到的好友申请分页查询对象,构造方法传入 offset 和 count。

分页请求对象属性

字段类型说明
offsetint分页起始偏移量,首批传 0。
countint本页期望返回的申请数量。

返回结果

成功回调返回当前分页的 List<FriendApplicationInfo> 申请记录列表。客户端应以申请人 userID(fromUserID)为主键对申请列表进行去重合并。每项包含以下属性:

字段说明
fromUserID / fromNickname / fromFaceURL申请发起人的用户 ID、公开昵称及头像地址。
toUserID / toNickname / toFaceURL申请接收人(当前登录用户)的 ID、昵称及头像。
reqMsg申请人填写的附言说明。
handleResult审批结果:0 待处理,1 已同意,-1 或 2 已拒绝。
handlerUserID处理该申请的操作人 ID。
handleMsg处理人填写的处理附言。
handleTime处理该申请的时间戳。
createTime申请发起的时间戳。
ex申请记录的扩展字符串。

好友申请新增、接受、拒绝和删除时,可通过 OnFriendshipListener 接收以下回调:

@Override
public void onFriendApplicationAdded(FriendApplicationInfo application) {
    // 处理新增或更新的好友申请
}

@Override
public void onFriendApplicationAccepted(FriendApplicationInfo application) {
    // 处理已接受的好友申请
}

@Override
public void onFriendApplicationRejected(FriendApplicationInfo application) {
    // 处理已拒绝的好友申请
}

@Override
public void onFriendApplicationDeleted(FriendApplicationInfo application) {
    // 处理已删除的好友申请
}

按 toUserID 是否等于当前登录用户 ID,将记录分流到收到或发出的列表。申请被接受后,通过 onFriendAdded 接收新好友关系通知,详见分页获取好友列表。