Browse SDKs · Android
SDKsAndroid

Get received friend requests

Use getRecvFriendApplicationList() to query received friend requests by page.

Copy
GetFriendApplicationListAsRecipientReq request =
    new GetFriendApplicationListAsRecipientReq(0, 20);

OpenIMClient.getInstance().friendshipManager.getRecvFriendApplicationList(
    new OnBase<List<FriendApplicationInfo>>() {
        @Override
        public void onSuccess(List<FriendApplicationInfo> applications) {
            // Use applications to update the received-request list.
        }

        @Override
        public void onError(int code, String error) {
            // Handle the error.
        }
    },
    request
);

offset starts at 0, and count is the page size. To filter by handling state, use setHandleResults(int[]) with values defined by the server contract. The callback returns the current page as List<FriendApplicationInfo>.

FieldDescription
fromUserID / fromNickname / fromFaceURLApplicant ID, nickname, and avatar.
toUserID / toNickname / toFaceURLRecipient ID, nickname, and avatar.
reqMsgFriend request message.
handleResultHandling result: 0 pending, 1 accepted, 2 rejected.
handlerUserIDUser ID that handled the request; it can be empty while pending.
handleMsgHandling message.
handleTimeHandling time; do not treat it as valid while pending.
createTimeRequest creation time.
exFriend request extension string.

Receive friend request added, accepted, rejected, and deleted callbacks through OnFriendshipListener:

@Override
public void onFriendApplicationAdded(FriendApplicationInfo application) {
    // Handle a new or updated friend request.
}

@Override
public void onFriendApplicationAccepted(FriendApplicationInfo application) {
    // Handle an accepted friend request.
}

@Override
public void onFriendApplicationRejected(FriendApplicationInfo application) {
    // Handle a rejected friend request.
}

@Override
public void onFriendApplicationDeleted(FriendApplicationInfo application) {
    // Handle a deleted friend request.
}

Use whether toUserID equals the signed-in user ID to route a record to the received or sent list. After an application is accepted, receive the new friendship through onFriendAdded; see Get the friend list by page.