Actor通信

蓝图和C++提供了多种供不同Actor通信和共享信息的方法。本页面概述各种可用的Actor通信方法，以及每种方法的要求和常见用例。

此外，你还可以通过文中链接查看各种Actor通信类型的快速入门指南，获取详细信息。

直接通信

直接Actor（Direct Actor）通信是关卡中各Actor间最常用的通信方法。

这种方法需要你引用目标Actor（target actor），以便当前Actor（working actor）获取目标Actor的信息。采用这类通信时，当前Actor和目标Actor之间是一对一的关系。

使用时机

如果你引用了关卡中的某个Actor，并且需要共享信息或触发该Actor的函数，则可以使用此通信方法。

示例

• 在Actor上触发事件。

• 从关卡中的Actor中获取信息。

类型转换

类型转换是一种常用的通信方法，方法是获取Actor的引用，并尝试将其转换为其他类型。如果转换成功，则可以通过直接通信来访问其信息和功能。

此方法要求引用关卡中的Actor，以便使用 Cast 节点来将它转换成特定的类。采用此通信方法时，当前Actor和目标Actor之间是一对一关系。

使用时机

如果你已经引用了某个Actor，并且希望在访问其信息之前检查该Actor是否属于某个类型，请使用此通信方法。

示例

• 用一个体积覆盖住Pawn，然后将Pawn的引用类型转换为子类（例如Character类），访问其信息。

• 将一个Actor的引用转换为一个通用的父类，然后访问其信息。

接口

接口会定义一组常用行为或功能，这些行为或功能可以由不同的Actor类实现。此通信方法简化了在不同Actor类上实现同类型函数的过程。

此方法要求每个Actor都实现接口，以便访问它们共有的函数。此外，你还需要拥有Actor的引用，以便通过引用来调用接口函数。采用这种通信方法时，当前Actor和目标Actor之间是一对一关系。

使用时机

当你希望为不同类型的Actor创建通用功能时，请使用此方法。

示例

• 创建一个交互系统，其中，每个与玩家交互的Actor都会做出不同响应。例如，当玩家与门Actor交互时，门Actor会打开；而当玩家交互光源Actor时，光源Actor会点亮。

• 将破坏应用至关卡中的不同Actor。每个Actor都会对发生的破坏做出不同的响应。例如，墙Actor在受到破坏时将会破裂，而门Actor在受到破坏时将会打开。

事件分发器

采用事件分发器时，当某个Actor触发事件后，所有其他监听该事件的Actor都会收到通知。

此方法要求在当前Actor上创建事件分发器（Event Dispatche），并将目标Actor绑定给这些分发器。此通信方法使用一对多关系，其中单个Actor负责触发多个监听Actor的事件分发器。

使用时机

如果想要让单个事件影响多个不同Actor，可以使用此通信方法。

示例

• 在游戏中创建BossDied事件。当有敌人Boss死掉时，此事件将会触发，导致门Actor打开，HUD Actor会显示一条消息，且宝箱Actor打开。

• 创建一个日夜循环，其中的DayStarted事件负责通知NPC开始每天的例行活动。

Actor通信参考表

蓝图和C++提供了多种供不同Actor通信和共享信息的方法。本页面概述各种可用的Actor通信方法，以及每种方法的要求和常见用例。

此外，你还可以通过文中链接查看各种Actor通信类型的快速入门指南，获取详细信息。

直接通信

直接Actor（Direct Actor）通信是关卡中各Actor间最常用的通信方法。

这种方法需要你引用目标Actor（target actor），以便当前Actor（working actor）获取目标Actor的信息。采用这类通信时，当前Actor和目标Actor之间是一对一的关系。

使用时机

如果你引用了关卡中的某个Actor，并且需要共享信息或触发该Actor的函数，则可以使用此通信方法。

示例

• 在Actor上触发事件。

• 从关卡中的Actor中获取信息。

使用蓝图类进行类型转换

类型转换是一种常用的通信方法，方法是获取一个Actor类的蓝图的引用，并尝试将其转换为其他类型。如果转换成功，则可以通过直接通信来访问其信息和功能。

此方法要求引用关卡中的Actor，以便使用 Cast 节点来将它转换成特定的类。采用此通信方法时，当前Actor和目标Actor之间是一对一关系。

使用时机

如果你已经引用了某个Actor，并且希望在访问其信息之前检查该Actor是否属于某个类型，请使用此通信方法。

示例

• 用AVolume覆盖住APawn，然后将Pawn的引用类型转换为子类（例如ACharacter），访问其信息。

• 将一个Actor类的蓝图的引用转换为一个通用的父类，然后访问其信息。

接口

接口（UInterface）会定义一组常用行为或功能，这些行为或功能可以由不同的Actor类实现。此通信方法简化了在不同Actor类蓝图上实现同类型函数的过程。

此方法要求每个Actor都实现接口，以便访问它们共有的函数。此外，你还需要拥有Actor类蓝图的引用，以便通过引用来调用接口函数。采用这种通信方法时，当前Actor和目标Actor之间是一对一关系。

注：请参见接口了解详情。

使用时机

当你希望为不同类型的蓝图Actor创建通用功能时，请使用此方法。

示例

• 创建一个交互系统，其中，每个与玩家交互的Actor都会做出不同响应。例如，当玩家与门Actor交互时，门Actor会打开；而当玩家交互光源Actor时，光源Actor会点亮。

• 将破坏应用至关卡中的不同Actor。每个Actor类蓝图都会对发生的破坏做出不同响应。例如，墙Actor在受到破坏时会破裂，而门Actor在受到破坏时将会打开。

委托

委托能以一种类型安全的方式在Actor类蓝图中调用函数。委托可以动态绑定，以便某个Actor触发事件后，所有"监听"该事件的其他Actor会响应事件。

注意：如需更多文档，请参见委托。

使用时机

如果想要让单个事件影响多个不同的Actor类蓝图，可以使用此通信类型。

示例

• 在游戏中创建BossDied事件。当有敌人Boss死掉时，此事件将会触发，导致门Actor打开，HUD Actor会显示一条消息，且宝箱Actor打开。

• 创建一个日夜循环，其中的DayStarted事件负责通知NPC开始每天的例行活动。

使用蓝图类引用表进行通信