Scripts/Managers/FriendManager.cs

The FriendManager is the core runtime component of the Universal Friend List system. It implements the IFriendManager interface and provides all friend-related functionality including managing friends, handling requests, blocking users, and coordinating with the game type system.

Configuration Section

These events can be connected to UI elements or other scripts directly in the Unity Inspector without code:

Beyond UnityEvents, FriendManager also exposes standard C# events that you can subscribe to in code for more control:

Example Subscription

// Subscribe to friend added event
FriendManager.Instance.OnFriendAdded += (friend) => {
    Debug.Log($"New friend added: {friend.DisplayName}");
};

// Subscribe to status changes
FriendManager.Instance.OnFriendStatusChanged += (friend) => {
    Debug.Log($"Friend {friend.DisplayName} is now {friend.Status}");
};

Initialization

Friend Operations

Block Operations

Invitation Operations

Basic Friend Operations

// Get the FriendManager instance
var friendManager = FriendManager.Instance;

// Send a friend request
friendManager.SendFriendRequest("user123", (success, error) => {
    if (success) {
        Debug.Log("Friend request sent!");
    } else {
        Debug.LogError($"Failed: {error}");
    }
});

// Accept a request
friendManager.AcceptFriendRequest(requestId, (success, error) => {
    // Handle result
});

// Remove a friend
friendManager.RemoveFriend(friendUserId, (success, error) => {
    // Handle result
});

Event-Driven UI Updates

// In your UI controller Start method
private void Start() {
    var fm = FriendManager.Instance;

    fm.OnFriendAdded += OnFriendAdded;
    fm.OnFriendRemoved += OnFriendRemoved;
    fm.OnFriendStatusChanged += OnFriendStatusChanged;
    fm.OnInvitationReceived += OnInvitationReceived;
}

private void OnFriendAdded(Friend friend) {
    // Add friend to your UI list
    Debug.Log($"Added friend: {friend.DisplayName}");
}

private void OnFriendRemoved(Friend friend) {
    // Remove from UI list
    Debug.Log($"Removed friend: {friend.DisplayName}");
}

private void OnFriendStatusChanged(Friend friend) {
    // Update status display (Online/Offline/InRoom)
    Debug.Log($"{friend.DisplayName} is now {friend.Status}");
}

private void OnInvitationReceived(FriendInvitation invitation) {
    // Show invitation popup to player
    Debug.Log($"Invite from: {invitation.FromUserId}");
}

Scene Persistence

FriendManager automatically makes itself persistent (DontDestroyOnLoad) to survive scene transitions. Only one instance should exist at a time.

Data Persistence

If PersistFriendList is enabled, the friend list is saved to PlayerPrefs between sessions. The block list similarly persists if PersistBlockList is enabled.

Automatic Refresh

When initialized, FriendManager automatically refreshes the friend list at intervals specified by RefreshInterval. This can be disabled by setting the interval to 0 or a negative value.