Events

Most relationships don’t change often, but when there are changes, users want to know about them as soon as possible. The Friends SDK fetches all a user's relationships at startup, then keeps the list up-to-date using events.

The SDK sends events as soon as changes occur. User relationship changes that trigger an event include:

  • A friend updates their presence status.
  • The user adds a new relationship. A user creates a FRIEND_REQUEST relationship or a FRIEND_REQUEST is accepted creating a FRIEND relationship.
  • The user removes a relationship like a FRIEND_REQUEST, a FRIEND, or a BLOCK relationship.

You can attach callbacks to the following events within the FriendsService:

ParameterDescription
RelationshipAddedEvent invoked when a relationship involving the current user gets added.
RelationshipDeletedEvent invoked when a relationship involving the current user gets deleted.
PresenceUpdatedEvent invoked when the presence of a member associated with the current user updates their presence.
MessageReceivedEvent invoked when a user sends a message to the current user.