Events

Understand the event system for tracking changes in the status and relationships of friends.

Read time 1 minute

Last updated 4 days 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
RelationshipAdded	Event invoked when a relationship involving the current user gets added.
RelationshipDeleted	Event invoked when a relationship involving the current user gets deleted.
PresenceUpdated	Event invoked when the presence of a member associated with the current user updates their presence.
MessageReceived	Event invoked when a user sends a message to the current user.

Documentation

Development

User Acquisition

Monetization

Industry