一、基础概念区分

Event Dispatcher（事件分发器）：蓝图内自定义的广播通道，相当于消息中转站。
Call Event Dispatcher（Broadcast 广播节点）：Call Event Dispatcher 就是分发器自带的 Broadcast 节点，作用：主动发送消息、传递参数，所有提前 Bind Event 绑定过的对象都会收到这条消息并执行自身回调逻辑。
完整流程闭环：
1. 创建事件分发器（定义消息参数）
2. A 对象：Call Event Dispatcher（Broadcast）发消息
3. B/C/D 对象：Bind Event 订阅消息
4. 不需要监听时：Unbind Event 取消订阅

关键特性

一对多广播：一次 Broadcast，所有绑定对象同时触发回调
支持传递自定义参数（int、bool、Actor、向量、结构体等）
解耦代码：发送方不需要知道有哪些监听者，降低蓝图耦合

二、案例需求

做玩家拾取金币加分系统，完整流程：

金币 Actor（发送方）：碰撞触发 → Call Event Dispatcher 广播加分消息（传递金币分值）
玩家蓝图（监听方）：游戏开始绑定分发器事件，收到广播自动增加分数
兜底逻辑：玩家销毁时 Unbind 防止崩溃

三、分步详细操作（UE5.1~5.7 通用）

第一部分：创建全局消息载体 GameInstance（存放事件分发器）

把分发器放在 GameInstance，实现全局任意 Actor 都能广播 / 监听

步骤 1：新建 GameInstance 蓝图

内容浏览器右键 → 蓝图类 → 搜索 Game Instance → 命名 GI_GameMain
打开蓝图，切换到【我的蓝图】面板
新建事件分发器：
- 点「+ 事件分发器」，命名 OnCoinPickUp
- 右键分发器 → 添加参数：
  
  参数名：CoinValue，类型：整数 Integer

作用：广播时可以传递本次拾取金币的分数

步骤 2：项目设置指定自定义 GameInstance

顶部菜单栏：编辑 → 项目设置 → 地图 & 模式 → 游戏实例
游戏实例类选择刚才创建的 GI_GameMain，保存设置
编译蓝图

第二部分：创建发送方 BP_Coin（金币，核心使用 Call Event Dispatcher）

步骤 1：创建金币 Actor 蓝图

右键蓝图类 → Actor → BP_Coin
添加组件：StaticMesh（金币模型）、Sphere Collision（球形碰撞盒）
新建变量：
- CoinScore 整数，默认值 10，公开，用来设置单个金币分值

步骤 2：获取 GameInstance 引用

Event Graph 空白处右键搜索 Get Game Instance

输出引脚提升转换为 GI_GameMain 类型，命名 MainGI

步骤 3：制作碰撞拾取逻辑 + Call Event Dispatcher（Broadcast）

添加事件：Event Actor BeginOverlap（玩家走进碰撞触发拾取）
过滤碰撞对象：

从重叠 Actor 拖出 Cast To BP_Player，判断是不是玩家，失败则直接结束流程
核心：Call Event Dispatcher（Broadcast 广播节点）
- 从 MainGI（GameInstance 引用）引脚拖出，搜索分发器名称 OnCoinPickUp
- 选择 Call OnCoinPickUp（也就是你说的 Call Event Dispatcher，官方显示为 Broadcast）
参数赋值：CoinValue 引脚连接本地变量 CoinScore
广播后销毁金币：Broadcast 输出执行线连接 Destroy Actor

完整执行线：

Event Actor BeginOverlap → Cast 玩家成功 → Get MainGI → Call OnCoinPickUp (CoinValue=CoinScore) → Destroy Actor

这里的 Call OnCoinPickUp 就是Call Event Dispatcher 节点，功能是对外广播消息

第三部分：创建监听方 BP_Player（玩家，Bind 订阅广播）

步骤 1：玩家蓝图基础设置

蓝图类 → 第三人称角色 → BP_Player
新建变量：
- PlayerScore 整数，默认 0（存储玩家总分）

步骤 2：创建回调自定义事件（接收广播参数）

我的蓝图面板 → 新建自定义事件 UpdateScore

添加参数：InAddScore 整数（接收金币传递的分值）

事件内部逻辑：

PlayerScore = PlayerScore + InAddScore

添加 Print String 打印当前总分，用于测试查看

步骤 3：游戏开始 Bind Event 订阅分发器

事件 Event BeginPlay
Get Game Instance 转为 GI_GameMain → MainGI
从 MainGI 拖出 → Bind Event to OnCoinPickUp
Event 引脚选择自定义事件 UpdateScore

执行线：Event BeginPlay → Bind Event

步骤 4：销毁时 Unbind Event（防崩溃必备）

事件 Event Destroyed
同样获取 MainGI
拖出 Unbind Event from OnCoinPickUp，Event 依旧选 UpdateScore

执行线：Event Destroyed → Unbind Event

四、关卡部署与测试步骤

关卡放入 BP_Player（自动生成第三人称玩家）
拖入多个 BP_Coin 金币，可在细节面板修改每个金币 CoinScore 分值（10/20/50）
全部蓝图编译保存
运行游戏：
1. 操控玩家走到金币碰撞范围
2. 金币执行 Call Event Dispatcher 广播分值
3. 玩家绑定的 UpdateScore 事件自动触发，分数累加打印
4. 金币自动销毁，多次拾取分数持续上涨

五、Call Event Dispatcher 节点完整参数详解

以 Call OnCoinPickUp 为例：

Execute（输入执行）：触发广播的执行线（碰撞、按键、定时器等）
Target（对象）：分发器所在载体（GameInstance/Actor/Widget 引用）
自定义参数引脚：创建分发器时添加的参数，广播时向外传递数据
Completed（输出执行）：广播完成后执行后续逻辑（销毁物体、播放特效、播放音效）

六、两种分发器存放载体使用区别

方案 1：分发器放在 GameInstance（本案例）

适用：全局消息（得分、玩家死亡、游戏通关、全局 UI 更新）

优点：任意 Actor 随时调用 Call Event Dispatcher，无需获取特定 Actor 引用

方案 2：分发器放在单个 Actor（开关 / 门等交互物）

适用：局部交互（开关灯光、开门）

操作：需要先通过 Get All Actors of Class 获取目标 Actor 引用，再拖出 Call Event Dispatcher 广播

示例：BP_Door 门 Actor 内置 OnOpenDoor 分发器，按下 E 键执行 Call OnOpenDoor 广播

七、完整蓝图逻辑文字梳理

1. 发送方 BP_Coin（Call Event Dispatcher 核心）

plaintext

Event Actor BeginOverlap
    → Cast To BP_Player (成功分支)
        → Get Game Instance 转 GI_GameMain (MainGI)
            → Call OnCoinPickUp (CoinValue = CoinScore) // Call Event Dispatcher广播
                → Destroy Actor

2. 全局载体 GI_GameMain

仅定义事件分发器 OnCoinPickUp(int CoinValue)，无额外逻辑

3. 监听方 BP_Player

plaintext

// 订阅广播
Event BeginPlay
    → Get MainGI
        → Bind Event to OnCoinPickUp (Event=UpdateScore)

// 回调接收消息
Custom Event UpdateScore(InAddScore)
    → PlayerScore += InAddScore
    → Print String 输出总分

// 取消订阅
Event Destroyed
    → Get MainGI
        → Unbind Event from OnCoinPickUp (Event=UpdateScore)