Friends List Display

Goal

Load the player’s friends list and iterate it to populate your UI.

Prerequisite

Make sure the player is authenticated first. Use use-case-1-auth-bootstrap.md for a safe startup flow.

Actions used

• GameServicesLoadFriends

• GameServicesGetLoadFriendsSuccessResult (on success; gives friendsCount)

• GameServicesGetLoadFriendsError (on failure)

• GameServicesGetFriendInfo (iterate friends)

Variables

• friendsCount (Int)

• friendIndex (Int)

• playerId (String), displayName (String), alias (String)

Flow

1. State: LoadFriends

   • Action: GameServicesLoadFriends

   • Events:

     • successEvent → GetFriendsCount

     • failureEvent → GetLoadFriendsError (or show “no friends”)

2. State: GetFriendsCount

   • Action: GameServicesGetLoadFriendsSuccessResult → friendsCount

   • Set friendIndex = 0

3. Loop:

   • While friendIndex < friendsCount:

     • Action: GameServicesGetFriendInfo (input: friendIndex)

     • Read outputs: playerId, displayName, alias

     • Add to UI

     • friendIndex++

Notes

• Friend lists can be empty due to privacy settings or no friends on the service.

• Refresh only when needed; GameServicesLoadFriends clears and repopulates the cached list.