com.quickblox.chat.listeners

Interface QBRosterListener

public interface QBRosterListener

A listener that is fired any time a roster is changed or the presence of a user in the roster is changed.

See Also:

QBRoster.addRosterListener(QBRosterListener)

Method Summary

Modifier and Type	Method and Description
void	entriesAdded(java.util.Collection<java.lang.Integer> userIds) Called when roster entries are added.
void	entriesDeleted(java.util.Collection<java.lang.Integer> userIds) Called when a roster entries are removed.
void	entriesUpdated(java.util.Collection<java.lang.Integer> userIds) Called when a roster entries are updated.
void	presenceChanged(QBPresence presence) Called when the presence of a roster entry is changed.

Method Detail

entriesDeleted

void entriesDeleted(java.util.Collection<java.lang.Integer> userIds)

Called when a roster entries are removed.

Parameters:

userIds - collection of users identifiers that have been removed

entriesAdded

void entriesAdded(java.util.Collection<java.lang.Integer> userIds)

Called when roster entries are added.

Parameters:

userIds - collection of users identifiers that have been added to the roster.

entriesUpdated

void entriesUpdated(java.util.Collection<java.lang.Integer> userIds)

Called when a roster entries are updated.

Parameters:

userIds - collection of users identifiers that have been updated in the roster.

presenceChanged

void presenceChanged(QBPresence presence)

Called when the presence of a roster entry is changed. Care should be taken when using the presence data delivered as part of this event. Specifically, when a user account is online with multiple resources, the UI should account for that. For example, say a user is online with their desktop computer and mobile phone. If the user logs out of the IM client on their mobile phone, the user should not be shown in the roster (contact list) as offline since they're still available as another resource.

To get the current "best presence" for a user after the presence update, query the roster:

    String user = presence.getFrom();
    QBPresence bestPresence = roster.getPresence(user);
 

That will return the presence value for the user with the highest priority and availability. Note that this listener is triggered for presence (mode) changes only (e.g presence of types available and unavailable. Subscription-related presence packets will not cause this method to be called.

Parameters:

presence - the presence that changed.

See Also:

QBRoster.getPresence(int)