Facebook Friends

This feature allows retrieving the player's Facebook friends who also play the game.

To use this feature, Facebook Authorization must be enabled.

---

1. Configure

Configuration is done in the
Settings Inspector → Facebook section
under the Base, iOS and Android tabs.

---

2. iOS Configuration

Fill in the following fields
(ask your release manager for correct values):

• Facebook Enabled — enable/disable Facebook integration on iOS
• Facebook Auth Enabled — enable/disable Facebook Authorization on iOS
• Facebook App Id — your Facebook project ID
• Facebook ClientToken — Facebook Client Token

Note: Facebook friends retrieval requires Facebook Enabled, Facebook Auth Enabled and valid App Id / ClientToken.

---

3. Android Configuration

Fill in the following fields in the Settings Inspector:

• Facebook Enabled — enable/disable Facebook integration
• Facebook Auth Enabled — enable/disable Facebook Authorization
• Facebook App Id — Facebook project ID
• Facebook Game Link — link to your game on Facebook (used for invites / sharing)
• Facebook Game Preview — preview image URL for game sharing

---

4. Usage

Get Social Friends

To request the user's friend list:

P101XP.GetInstance().GetSocialFriends();

The result is delivered through SocialFriendsEvent.

---

5. Event Subscription

Always subscribe before making the request:

private void SocialFriendsHandler(FriendsContainer friendsContainer)
{
}

P101XP.GetInstance().SocialFriendsEvent += SocialFriendsHandler;

Unsubscribe in OnDestroy to avoid duplicate callbacks:

P101XP.GetInstance().SocialFriendsEvent -= SocialFriendsHandler;

---

6. FriendsContainer

public class FriendsContainer
{
    public List<SocialFriend> friends;
    public string error;
}

Fields

Field	Type	Description
friends	List<SocialFriend>	List of friends playing this game
error	string	Error message or null if request succeeded

---

7. SocialFriend

public class SocialFriend
{
    public int level;
    public long mobileId;
    public string name;
    public string pictureUrl;
    public string socialNetId;
}

Fields

Field	Type	Description
level	int	Player's in-game level
mobileId	long	101XP mobile ID
name	string	Friend's display name
pictureUrl	string	URL to the friend’s social avatar
socialNetId	string	Social network user ID

---