UE5 RPC调用示例详解

---

  

---

媒介

在UE5中，RPC（远程过程调用）是实现多人游戏逻辑同步的核心机制。以下通过一个玩家跳跃的示例，具体说明如何使用三种RPC范例（Server、Client、Multicast）。

---

一、示例场景

• 目标：玩家按下空格键时，所有客户端同步播放跳跃动画。
  
• 逻辑流程：
  
  
  • 客户端检测输入，调用Server RPC哀求跳跃。
    
  • 服务器验证哀求，执行现实跳跃逻辑，并通过Multicast RPC关照所有客户端。
    
  • 所有客户端收到Multicast后播放跳跃动画。
    
  
  

二、代码实现

步骤1：界说RPC函数（角色头文件）

1. // MyCharacter.h
2. #pragma once
4. #include "CoreMinimal.h"
5. #include "GameFramework/Character.h"
6. #include "MyCharacter.generated.h"
8. UCLASS()
9. class MYPROJECT_API AMyCharacter : public ACharacter
10. {
11.     GENERATED_BODY()
13. public:
14.     // 输入绑定
15.     virtual void SetupPlayerInputComponent(UInputComponent* PlayerInputComponent) override;
17.     // 客户端调用：向服务器发送跳跃请求
18.     UFUNCTION(BlueprintCallable, Category = "Jump")
19.     void RequestJump();
21.     // Server RPC：仅在服务器执行跳跃逻辑
22.     UFUNCTION(Server, Reliable, WithValidation, Category = "Jump")
23.     void Server_Jump();
25.     // Multicast RPC：所有客户端播放动画
26.     UFUNCTION(NetMulticast, Reliable, Category = "Jump")
27.     void Multicast_Jump();
29. private:
30.     void OnJumpInput(); // 本地跳跃输入处理
31. };

复制代码

步骤2：实现RPC函数（角色源文件）

1. // MyCharacter.cpp
2. #include "MyCharacter.h"
3. #include "Net/UnrealNetwork.h"
5. void AMyCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputComponent)
6. {
7.     Super::SetupPlayerInputComponent(PlayerInputComponent);
8.     // 绑定跳跃输入到本地函数
9.     PlayerInputComponent->BindAction("Jump", IE_Pressed, this, &AMyCharacter::OnJumpInput);
10. }
12. void AMyCharacter::OnJumpInput()
13. {
14.     // 仅在客户端调用Server RPC
15.     if (GetLocalRole() < ROLE_Authority && IsLocallyControlled())
16.     {
17.         RequestJump();
18.     }
19. }
21. void AMyCharacter::RequestJump()
22. {
23.     // 客户端调用Server RPC
24.     Server_Jump();
25. }
27. // Server RPC实现（_Implementation为UE自动生成的后缀）
28. void AMyCharacter::Server_Jump_Implementation()
29. {
30.     // 服务器验证跳跃合法性（例如是否冷却、是否死亡等）
31.     if (CanJump())
32.     {
33.         // 执行跳跃逻辑
34.         Jump();
36.         // 通知所有客户端播放动画
37.         Multicast_Jump();
38.     }
39. }
41. // 验证函数（可选，防止作弊）
42. bool AMyCharacter::Server_Jump_Validate()
43. {
44.     return true; // 在此处添加逻辑验证
45. }
47. // Multicast RPC实现
48. void AMyCharacter::Multicast_Jump_Implementation()
49. {
50.     // 所有客户端（包括调用者）播放动画
51.     PlayJumpAnimation();
52. }
54. void AMyCharacter::PlayJumpAnimation()
55. {
56.     // 播放跳跃动画Montage
57.     if (JumpAnimMontage)
58.     {
59.         PlayAnimMontage(JumpAnimMontage);
60.     }
61. }

复制代码

三、关键点剖析

3.1 RPC范例选择

• Server RPC (UFUNCTION(Server))：
  
  
  
  • 客户端调用，服务器执行。
    
  • 函数名需以Server_前缀开头，自动天生Server_Jump_Implementation。
    
  
  
• Multicast RPC (UFUNCTION(NetMulticast))：
  
  
  
  • 服务器调用，所有客户端（包括服务器自身）执行。
    
  • 函数名需以**Multicast_**前缀开头。
    
  
  

3.2 可靠性设置

• Reliable：保证RPC必达，适合关键动作（如跳跃）。
  
• Unreliable：不保证次序和必达，适合频繁更新（如位置同步）。
  

3.3 权限控制

• 通过**GetLocalRole()**检查角色权限：
  
  
  
  • ROLE_Authority：服务器端。
    
  • ROLE_AutonomousProxy：控制客户端的角色。
    
  • ROLE_SimulatedProxy：其他客户端角色。
    
  
  

3.4 输入处置惩罚

• 输入绑定在客户端本地执行，仅拥有客户端（IsLocallyControlled()）触发Server RPC。
  

四、测试与验证

• 启动多玩家测试：
  

• 在编辑器中开启两个PIE窗口，一个作为服务器（Number of Players = 1），另一个作为客户端。
  

• 观察活动：
  

• 客户端按下空格键时，服务器角色执行跳跃，所有客户端同步播放动画。
  

---

总结

• Server RPC：客户端发起哀求，服务器处置惩罚核心逻辑。
  
• Multicast RPC：服务器向全体客户端广播同步。
  
• 验证函数：防止客户端发送非法哀求（如作弊）。
  
• 权限控制：确保逻辑在正确的端执行。
  

通过合理使用RPC，可以高效实现多人游戏的交互同步，同时保障游戏的安全性与流畅性。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。