SDKsAndroid

Subscribe to user online status

Use subscribeUsersOnlineStatus() to subscribe to online status for specified users.

List<String> userIDs = Arrays.asList("user_a", "user_b");

OpenIMClient.getInstance().userInfoManager.subscribeUsersOnlineStatus(
    new OnBase<List<UsersOnlineStatus>>() {
        @Override
        public void onSuccess(List<UsersOnlineStatus> states) {
            // Use states to display online status.
        }

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

Remove empty and duplicate IDs, and subscribe only to users whose status is needed. The callback returns the initial List<UsersOnlineStatus>. Each item contains userID, status, and platformIDs.

Status fields

Field	Description
`userID`	Target user ID.
`status`	Online status value defined by the server contract.
`platformIDs`	Platforms on which the user is online.

Receive onUserStatusChanged through OnUserListener when a user's online status changes:

@Override
public void onUserStatusChanged(UsersOnlineStatus status) {
    // Handle the online-status change.
}

Subscription creates or updates the subscription set. When a user's status is no longer needed, cancel the subscription through Unsubscribe from user status.

Was this page helpful?