Friends
Last updated on
Overview
AccelByte Cloud's Friends service allows players to connect socially with other players. This service uses WebSocket to ensure all players get real-time updates about their Friend List. Players can manage their friends in several different ways, including:
- Request Friend allows players to add another player as a friend using that player's User ID. Players will be notified when they receive a friend request.
- Accept Friend Request allows players to accept friend requests they've received. After the player accepts the request, the requester will be notified and the two players will be linked as friends.
- Reject Friend Request allows players to deny a friend request from a player they don't want to be friends with.
- Cancel Friend Request allows players to cancel and remove a pending friend request they have sent to another player, in case they have changed their mind or sent the request to the wrong player.
- Get Friendship Status shows players their friendship status with another player. Possible statuses include:
- Not Friend indicates that the players are not connected as friends.
- Outgoing Friend indicates that the friend request sent by the player to another player is still pending.
- Incoming Friend indicates that the player has received a friend request that is still pending.
- Friend indicates that the two players are connected as friends.
- List of Friends shows the player all of the players they're currently friends with.
- List of Incoming Friends shows the player a list of players that have requested to be their friend. Players can accept or reject these requests.
- List of Outgoing Friends shows players the list of pending friend requests they have sent to other players.
- Unfriend allows players to stop being friends with other players. Unfriending a player will remove that player from their friend list. If the player wants to be friends with an unfriended player, they will have to send that player another friend request.
- Bulk Synchronization of Third-party Platform Friends allows players to connect their friends from third-party platforms to the AccelByte Cloud platform.
Permissions
Permissions are used to grant access to specific resources within our services. Make sure your account has the following permissions before you attempt to manage friends in the Admin Portal.
| Usage | Resource | Action |
|---|---|---|
| Add Friends Without Confirmation | NAMESPACE:{namespace}:USER:{userId}:FRIENDS | Create |
| Get List of Friends | NAMESPACE:{namespace}:USER:{userId}:FRIENDS | Read |
| Get Blocked Players by User ID | ADMIN:NAMESPACE:{namespace}:USER:{userId}:PLAYER:BLOCK | Read |
| Get Players Who Blocked This Player by User ID | ADMIN:NAMESPACE:{namespace}:USER:{userId}:PLAYER:BLOCK | Read |
| Configure a New 3rd Party Integration | ADMIN:NAMESPACE:{namespace}:THIRDPARTY:CONFIG | Create |
Permissions work slightly differently depending on whether they are assigned to IAM Clients or Roles assigned to users. For more information, read the Authentication and Authorization.