Unreal Engine如何实现Actor仅向指定客户端复制

核心用UE原生的网络相关性（Network Relevancy）机制实现，完全保留服务端权威复制逻辑，不需要自行开发整套复制后端，比多播Spawn Actor的方案稳定性高很多，优先推荐纯蓝图实现。

纯蓝图实现方案（UE4.26/UE5全支持，零C++依赖） #

• 基础复制配置
  打开需要定向复制的Actor蓝图，在细节面板Replication分类下做如下设置：
  • 勾选Replicates开启Actor复制
  • 取消勾选Always Relevant（必须关闭，否则引擎默认强制同步给所有客户端，自定义规则不生效）
  • 按需设置Net Update Frequency，协同编辑类Actor设10-30的同步频率足够
  • 给Actor新增两个蓝图变量：
    1. bPublishToAll：布尔类型，默认值false，标记是否已经确认效果要全量同步给所有人
    2. AllowedSyncPCs：PlayerController类型的数组，默认空，存允许提前看到Actor、参与协同编辑的客户端对应的服务端PlayerController引用
• 重写网络相关性判断逻辑
  在蓝图编辑器左侧「我的蓝图」面板，找到「函数重写」按钮，搜索并添加Is Net Relevant For重写函数：

  这个函数仅在服务端执行，引擎每次做网络复制检查时会自动为每个已连接客户端调用一次，返回True代表当前检查的客户端可以收到该Actor的所有复制数据（包括Actor本身、属性变更、绑定的复制RPC、生命周期同步），返回False则该客户端完全感知不到这个Actor，和原生复制逻辑完全一致。
  函数内按如下逻辑写判断：

  1. 如果bPublishToAll为True，直接返回True（或者调用父类节点返回默认结果），代表全量同步
  2. 如果bPublishToAll为False，判断函数传入的Viewer参数（就是当前待检查客户端对应的服务端PlayerController）是否存在于AllowedSyncPCs数组中，存在返回True，不存在返回False
• 分阶段同步流程
  1. 服务端Spawn该Actor后，先把需要参与协同编辑的队友对应的服务端PlayerController添加到AllowedSyncPCs数组，调用一次Actor的Force Net Update节点触发即时复制，此时只有数组内的客户端能收到Actor，后续参数调整会自动实时同步给这些客户端
  2. 等协同调整完成、效果确认后，服务端将bPublishToAll设为True，再次调用Force Net Update，引擎会自动把Actor同步给之前不在允许列表的所有客户端，后续所有参数变更也会全量同步
• 属性级细粒度复制（可选）
  如果不需要整个Actor定向隐藏，只是部分参数要对不同客户端可见，直接选中对应开启复制的蓝图变量，在细节面板的Replication Condition下拉菜单选择对应规则即可，比如COND_OwnerOnly代表仅同步给Actor所有者，COND_SkipOwner代表同步给除所有者外的所有人，配合上面的全局相关性规则可以满足大部分细粒度需求。

C++实现补充方案 #

逻辑和蓝图完全一致，适合需要更高自定义灵活度的场景：

• 构造函数里初始化复制配置：

AYourCollabActor::AYourCollabActor()
{
    bReplicates = true;
    bAlwaysRelevant = false;
    NetUpdateFrequency = 20.f;
}

• 重写IsNetRelevantFor接口：

// 头文件声明
virtual bool IsNetRelevantFor(const AActor* RealViewer, const AActor* ViewTarget, const FVector& SrcLocation) const override;

// 源文件实现
bool AYourCollabActor::IsNetRelevantFor(const AActor* RealViewer, const AActor* ViewTarget, const FVector& SrcLocation) const
{
    // 全量发布阶段走默认逻辑
    if (bPublishToAll)
    {
        return Super::IsNetRelevantFor(RealViewer, ViewTarget, SrcLocation);
    }
    // 校验当前客户端是否在允许列表
    if (const APlayerController* ViewerPC = Cast<APlayerController>(RealViewer))
    {
        return AllowedSyncPCs.Contains(ViewerPC);
    }
    return false;
}

• 属性级复制条件直接在UPROPERTY宏里指定即可：

// 示例：仅自定义条件下同步的编辑参数
UPROPERTY(Replicated, ReplicatedCondition = COND_Custom)
float CollabEditParam;

避坑提示 #

• 绝对不要用多播RPC的方式Spawn Actor，多播是一次性触发的调用，后续Actor的属性同步、移动、销毁、相关性更新全需要自行实现，相当于抛弃了UE整套原生复制体系，维护成本极高。
• IsNetRelevantFor里不要写复杂逻辑，这个函数调用频率很高，只做轻量的存在性、标记判断即可，避免卡网络线程。
• 动态修改允许列表、切换全量同步标记后，记得调用ForceNetUpdate()（蓝图对应Force Net Update节点），避免客户端等待默认的网络更新周期导致感知延迟。
• 初始Spawn Actor时，先配置好允许列表/全量标记再触发复制，避免出现刚Spawn时默认同步给所有人的单帧异常。

内容的提问来源于stack exchange，提问作者Walter Ostrander