游戏引擎 / 系统课时

用RPC传递玩家行为

用RPC传递玩家行为

多人游戏里,按键发生在某个客户端,但真正改变游戏状态的通常应是服务器。本篇用一次“玩家开火”串起 Server、Client 和 NetMulticast RPC,建立事件该往哪里发送、谁能调用、谁最终执行的判断方法。

学习目标

  • 区分 Server、Client 与 NetMulticast RPC 的调用方向和执行位置
  • 用 Server RPC 把玩家请求交给服务器,并用 Client 或 NetMulticast 返回不同类型的事件
  • 根据事件可靠性和持久性选择 RPC,而不是把 RPC 当作状态复制

RPC负责传递事件而不是复制真相

RPC 适合表达“发生了一次动作”,例如请求开火、只给某个玩家弹出失败提示、让相关客户端播放一次枪口特效。持续存在的结果,例如弹药数、血量、占领状态,更适合由服务器修改后通过属性复制同步。

RPC 是否能跨网络执行,还取决于 Actor 已启用复制以及网络所有权。尤其是客户端调用 Server RPC 时,通常必须从该客户端拥有的 Actor 发起;玩家自己的 PlayerController、Pawn 或 Character 是常见入口。

Server、Client与NetMulticast RPC的调用方向

三种RPC的方向

UFUNCTION(Server, ...) 表示函数从拥有该 Actor 的客户端请求到服务器执行。它最适合“我想做什么”,例如开火、交互、使用技能;服务器收到后仍要校验冷却、资源、距离等条件。

UFUNCTION(Client, ...) 由服务器调用,在该 Actor 的拥有者客户端执行。它适合只反馈给一个玩家的事件,例如“弹药不足”提示或只属于本人的界面反馈。

UFUNCTION(NetMulticast, ...) 应由服务器调用。它会在服务器以及对该 Actor 网络相关的客户端执行,适合非持久、允许重复触发的表现事件。若客户端直接调用 Multicast RPC,它不会变成一次服务器广播。

让开火请求经过Server

下面是片段示例,依赖一个已启用联网的 UE5 C++ 项目,并放在 ACharacter 子类中。输入端调用 TryFireFromInput();服务器负责扣弹药,失败时只通知拥有者,成功时向网络相关客户端广播表现事件。

cpp
// NetRpcCharacter.h
#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "NetRpcCharacter.generated.h"

UCLASS()
class ANetRpcCharacter : public ACharacter
{
    GENERATED_BODY()

public:
    ANetRpcCharacter();
    void TryFireFromInput();

    virtual void GetLifetimeReplicatedProps(
        TArray<FLifetimeProperty>& OutLifetimeProps
    ) const override;

private:
    UPROPERTY(Replicated)
    int32 Ammo = 10;

    UFUNCTION(Server, Reliable)
    void ServerTryFire();

    UFUNCTION(Client, Reliable)
    void ClientFireRejected();

    UFUNCTION(NetMulticast, Unreliable)
    void MulticastPlayFireFX();
};

// NetRpcCharacter.cpp
#include "NetRpcCharacter.h"
#include "Net/UnrealNetwork.h"

ANetRpcCharacter::ANetRpcCharacter()
{
    bReplicates = true;
}

void ANetRpcCharacter::TryFireFromInput()
{
    if (IsLocallyControlled())
    {
        ServerTryFire();
    }
}

void ANetRpcCharacter::ServerTryFire_Implementation()
{
    if (Ammo <= 0)
    {
        ClientFireRejected();
        return;
    }

    --Ammo;
    UE_LOG(LogTemp, Log, TEXT("ServerTryFire: Ammo=%d"), Ammo);
    MulticastPlayFireFX();
}

void ANetRpcCharacter::ClientFireRejected_Implementation()
{
    UE_LOG(LogTemp, Warning, TEXT("ClientFireRejected: no ammo"));
}

void ANetRpcCharacter::MulticastPlayFireFX_Implementation()
{
    UE_LOG(LogTemp, Log, TEXT("MulticastPlayFireFX"));
}

void ANetRpcCharacter::GetLifetimeReplicatedProps(
    TArray<FLifetimeProperty>& OutLifetimeProps
) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);
    DOREPLIFETIME(ANetRpcCharacter, Ammo);
}

预期结果:在两名玩家的 PIE 网络测试中,拥有角色的客户端触发开火后,服务器把 Ammo 从 10 减到 9;服务器和对该角色网络相关的客户端都会执行 MulticastPlayFireFX。当 Ammo 为 0 时,不再广播开火表现,仅拥有该角色的客户端收到拒绝通知。

text
Server: ServerTryFire: Ammo=9
Server / relevant clients: MulticastPlayFireFX
Ammo == 0 时 owning client: ClientFireRejected: no ammo

选择Reliable与Unreliable

Reliable 表示该 RPC 使用可靠传输机制保证按连接顺序可靠送达,但它并不适合“越多越好”。大量高频可靠 RPC 会占用可靠发送队列,使真正关键的消息也被拖慢。

关键且低频的玩家请求,例如“确认购买”“提交交互”,通常可以使用 Reliable。高频、可丢一两次且之后会有新事件覆盖的视觉效果,更适合 Unreliable。移动同步通常应使用引擎已有的 Character Movement 网络机制,而不是自己每帧发送 Reliable RPC。

验证与常见边界

PIE 至少用两名玩家测试,并分别观察服务器与客户端日志。先确认客户端调用的 Actor 确实归该客户端所有,再确认服务器才修改权威状态,最后检查 Multicast 只承担瞬时表现。

若 Server RPC“调用了却没有到服务器”,优先检查 Actor 是否 bReplicates = true、调用方是否拥有该 Actor,以及调用是否发生在正确的网络实例。若事件属于长期状态,就停止继续堆 RPC,改用复制属性表达最终结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用RPC传递玩家行为

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通