EasyConnector

Unity多人游戏网络框架，支持Steam集成和多种网络传输模式。

功能特性

• 多种网络传输模式（局域网、互联网、Steam P2P、NAT穿透）
• Steam好友系统集成
• 房间管理和邀请系统
• 支持NPC参与设置
• 可配置房间容量
• 统一的网络API
• 编辑器工具支持

系统要求

• Unity 2021.3或更高版本
• Netcode for GameObjects 1.4.0+
• Unity Transport 1.3.4+
• Steamworks.NET（Steam功能）

快速开始

基础设置

1. 将EasyConnector文件夹复制到Unity项目的Assets目录
2. 等待Unity编译完成
3. 打开菜单 EasyConnector → 打开控制面板
4. 在编辑器窗口中选择网络模式并创建管理器

依赖检查

运行依赖诊断工具确保所有功能正常：

菜单：EasyConnector → 诊断 → 完整依赖检查

局域网模式

// 获取网络管理器
var networkManager = FindObjectOfType<NetworkManager>();
networkManager.SetNetworkMode(NetworkManager.NetworkMode.LAN);
networkManager.SetServerAddress("192.168.1.100", 7777);

// 创建房间
var roomManager = FindObjectOfType<RoomManager>();
var settings = new RoomSettings {
    roomName = "测试房间",
    maxPlayers = 4,
    hasNPC = true
};
roomManager.CreateRoom(settings);

Steam模式

// 初始化Steam
var steamManager = SteamManager.Instance;

// 设置Steam网络模式
var networkManager = FindObjectOfType<NetworkManager>();
networkManager.SetNetworkMode(NetworkManager.NetworkMode.Steam);

// 邀请好友
var friendsManager = FindObjectOfType<SteamFriendsManager>();
var friends = friendsManager.GetOnlineFriends();
friendsManager.InviteFriendToGame(friends[0].steamId, "join_game");

核心组件

NetworkManager

网络连接管理器，支持多种传输模式。

RoomManager

房间管理器，处理房间创建、加入、玩家管理。

SteamManager

Steam API管理器，处理Steam初始化和基础功能。

SteamFriendsManager

Steam好友管理器，提供好友列表和邀请功能。

网络模式

局域网模式

适用于同一局域网内的设备。简单配置，低延迟。

互联网模式

通过公网IP连接。需要端口转发或公网服务器。

Steam模式

使用Steam P2P网络。自动处理NAT穿透，需要Steam客户端。

NAT穿透模式

使用STUN服务器实现NAT穿透。适用于复杂网络环境。

编辑器工具

控制面板

提供统一的配置界面：

• 网络设置配置
• Steam集成配置
• 房间管理工具
• 测试工具

快速设置

一键创建完整网络场景和管理器组件。

事件系统

// 网络事件
networkManager.OnClientConnected += OnClientConnected;
networkManager.OnPlayerJoined += OnPlayerJoined;

// 房间事件
roomManager.OnRoomCreated += OnRoomCreated;
roomManager.OnPlayerReady += OnPlayerReady;

// Steam事件
steamFriends.OnFriendsListUpdated += OnFriendsListUpdated;
steamFriends.OnGameInviteReceived += OnGameInviteReceived;