Documentation

Support

Friends

Friends

Events

Understand the event system for tracking changes in the status and relationships of friends.
Read time 1 minuteLast updated 19 hours ago
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
:

Parameter

Description

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.