《UE5_C++多人游戏开发实战》学习笔记3 ——《P4 局域网联机测试与蓝图网络事件（LAN Testing Blueprint Networking）》

1. 局域网联机测试基础准备在UE5中实现局域网联机功能前我们需要先搭建好开发环境。我推荐使用最新的UE5.3版本这个版本对多人游戏网络同步做了不少优化。创建一个第三人称模板项目时记得选择C选项这样我们既能用蓝图快速搭建功能又能通过C实现底层逻辑控制。多人游戏开发最让人头疼的就是网络同步问题。我在实际项目中遇到过角色移动不同步的情况后来发现是移动组件的网络复制设置没配好。建议一开始就检查CharacterMovementComponent的Replication属性确保bReplicateMovement设置为true。另外角色的Mesh组件也要勾选Replicates选项否则其他玩家根本看不到你的角色模型。测试环境搭建有个小技巧我习惯在项目设置里把默认地图改成自己创建的空关卡这样可以减少测试时的加载时间。在项目设置→地图和模式里把Game Default Map和Editor Startup Map都设成新建的空白关卡。这个空白关卡我一般命名为NetworkTestMap专门用来测试网络功能。2. 蓝图网络事件实现2.1 创建基础网络事件在内容浏览器中右键创建新的蓝图类选择继承自PlayerController的子类命名为BP_NetworkController。这个控制器将负责处理所有网络相关的事件。打开蓝图后我们先添加三个键盘事件数字键1创建监听服务器数字键2作为客户端连接数字键3断开当前连接实现创建服务器的逻辑时我发现很多人会忽略ServerTravel和OpenLevel的区别。ServerTravel是服务器端切换关卡会带着所有客户端一起切换而OpenLevel是本地切换关卡。正确的做法是使用ServerTravel并带上?listen参数这样服务器才会开启监听端口。// 在PlayerController中调用 GetWorld()-ServerTravel(/Game/Maps/Lobby?listen);2.2 处理连接事件客户端连接功能需要特别注意IP地址的获取。我建议在蓝图中添加一个文本框组件让玩家可以手动输入要连接的服务器IP。这样测试时就不需要每次修改蓝图重新编译了。连接逻辑的实现有个坑要注意直接调用ClientTravel连接服务器时如果当前是独立运行的游戏实例需要带上绝对路径。我通常会这样处理APlayerController* PC GetPlayerController(); if(PC) { FString Command FString::Printf(TEXT(open %s), *ServerAddress); PC-ConsoleCommand(Command); }3. 局域网测试实战技巧3.1 多实例测试方法在开发初期我习惯用编辑器自带的PIE(Play In Editor)功能测试多人游戏。在编辑器偏好设置里找到Level Editor→Play把Play Number of Clients设为2。这样点击播放按钮时会自动启动一个服务器窗口和一个客户端窗口。测试时发现的一个常见问题是客户端控制不了角色。这是因为PlayerController的Possess没有正确执行。解决方法是在GameMode蓝图中确保DefaultPawnClass设置正确并且在PostLogin事件中调用Possessvoid AMyGameMode::PostLogin(APlayerController* NewPlayer) { Super::PostLogin(NewPlayer); if(NewPlayer) { NewPlayer-Possess(DefaultPawn); } }3.2 跨设备测试要点真正的局域网测试需要至少两台设备。我建议先用两台电脑连接同一个路由器进行测试。在打包项目前记得在项目设置里启用打包→打包游戏内容否则客户端可能加载不了地图。测试时经常遇到的连接失败问题90%都是防火墙导致的。我现在的做法是在Windows防火墙中为UE5编辑器添加入站规则为打包后的游戏exe文件也添加规则关闭所有第三方安全软件如果还是连接不上可以用命令行ping一下目标IP确认网络是否通畅。另一个检查方法是使用netstat -ano命令查看端口监听情况。4. 网络同步问题排查4.1 常见同步问题角色移动不同步是最常见的问题之一。除了前面提到的移动组件设置还要检查Character蓝图中是否使用了网络预测(Network Prediction)。我建议在项目初期就开启这个功能UCharacterMovementComponent::SetNetworkPredictionEnabled(true);另一个头疼的问题是RPC调用失败。我总结了几点经验服务器调用的RPC函数必须标记为Server客户端调用的必须标记为Client多播(Multicast)函数要在服务器端调用RPC函数的参数类型要支持网络序列化4.2 网络调试工具UE5提供了强大的网络分析工具。在编辑器命令窗口输入stat net可以显示实时网络状态。我常用的调试命令还有net.NetShowCorrections 1显示网络修正p.NetShowPing 1显示ping值net.DebugCapsule 1显示碰撞胶囊体对于更复杂的同步问题我会使用Session Frontend工具。在编辑器菜单栏选择窗口→开发者工具→Session Frontend可以查看详细的网络同步数据。5. 性能优化建议5.1 网络带宽优化多人游戏最怕的就是网络带宽不足。UE5提供了网络优先级系统我们可以为不同的Actor设置不同的NetPriorityAActor::SetNetPriority(1.5f); // 数值越大优先级越高复制频率也需要优化。对于移动缓慢的物体可以降低更新频率AActor::SetNetUpdateFrequency(5.0f); // 每秒更新5次5.2 客户端预测优化为了减少网络延迟带来的卡顿我们需要合理使用客户端预测。UE5的CharacterMovementComponent已经内置了预测功能但需要正确配置UCharacterMovementComponent::SetPredictiveMovement(true); UCharacterMovementComponent::SetEnableNetworkReplication(true);对于自定义的移动逻辑可以使用FNetworkPredictionData_Client类来实现预测。我建议参考UE5源码中的CharacterMovementComponent实现方式。6. 打包与部署6.1 打包注意事项打包多人游戏项目时有几个关键设置不能忽略在项目设置中启用打包→包含Prerequisites设置正确的Default Game.ini配置确保所有用到的地图都加入了打包→地图列表我遇到过最棘手的问题是打包后客户端连接不上服务器后来发现是因为没有把服务器专用的地图打包进去。解决方法是在高级设置→打包→额外非烹饪资产中添加服务器地图。6.2 部署技巧部署到多台测试机器时我习惯使用批处理脚本自动复制文件。创建一个deploy.bat文件xcopy /E /Y Build\Windows \\TargetPC\SharedFolder\Game测试时建议使用有线网络连接WiFi的延迟和丢包率会影响测试结果。如果必须用WiFi可以在项目设置中调整网络缓冲参数UNetDriver::SetNetServerMaxTickRate(30); UNetDriver::SetNetServerMaxClientRate(10000);多人游戏开发是个需要耐心的工作我建议每次只实现一个小功能就立即测试这样可以快速定位问题。记住网络同步问题越早发现越容易解决。