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_REQUESTrelationship or aFRIEND_REQUESTis accepted creating aFRIENDrelationship. - The user removes a relationship like a
FRIEND_REQUEST, aFRIEND, or aBLOCKrelationship.
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. |