SpawnActor

weixin_46257843

于 2024-09-27 16:02:09 发布

阅读量675

点赞数 18

文章标签： ue5 c++

本文链接：https://blog.csdn.net/weixin_46257843/article/details/142595912

版权

SpawnActor 是 Unreal Engine 中用于在场景中动态创建（生成）Actor 实例的函数。它允许你在游戏运行时根据需要创建新的 Actor，例如敌人、道具、特效等。这在动态场景生成、游戏逻辑控制等方面非常有用。

1. `SpawnActor` 的基本用法

SpawnActor 函数有多个重载版本，最常见的签名如下：

AActor* SpawnActor( UClass* Class, const FTransform& Transform, const FActorSpawnParameters& SpawnParameters = FActorSpawnParameters() );

参数解释：

Class：要生成的 Actor 类型，通常是一个 UClass* 或者 TSubclassOf<AActor>。
Transform：生成的 Actor 在世界中的变换（包括位置、旋转和缩放）。使用 FTransform 结构体来表示。
SpawnParameters：生成参数，可以控制生成的细节，例如生成的所有者（Owner）、是否允许碰撞等。

返回值：

返回生成的 Actor 指针，如果生成失败则返回 nullptr。

2. `SpawnActor` 的示例代码

2.1 简单生成一个 `Actor`

以下是一个基本的示例，展示如何在特定位置生成一个 Actor：

void AMyGameMode::SpawnMyActor() { // 要生成的 Actor 类型（例如 AMyActor） TSubclassOf<AActor> ActorClass = AMyActor::StaticClass(); // 生成位置和旋转 FVector Location(0.0f, 0.0f, 100.0f); // 生成位置 FRotator Rotation(0.0f, 0.0f, 0.0f); // 生成旋转 // 生成 Actor AActor* SpawnedActor = GetWorld()->SpawnActor<AActor>(ActorClass, Location, Rotation); if (SpawnedActor) { UE_LOG(LogTemp, Warning, TEXT("Successfully spawned: %s"), *SpawnedActor->GetName()); } else { UE_LOG(LogTemp, Error, TEXT("Failed to spawn actor.")); } }

2.2 使用 `FTransform` 生成 `Actor`

你也可以使用 FTransform 来指定生成的变换（位置、旋转、缩放）：

FVector Location(0.0f, 0.0f, 100.0f); FRotator Rotation(0.0f, 0.0f, 0.0f); FVector Scale(1.0f, 1.0f, 1.0f); // 创建 FTransform FTransform Transform(Rotation, Location, Scale); // 使用 Transform 生成 Actor AActor* SpawnedActor = GetWorld()->SpawnActor<AActor>(ActorClass, Transform);

2.3 使用 `FActorSpawnParameters` 指定生成参数

FActorSpawnParameters 允许你设置更多的生成选项，如生成的所有者、是否允许碰撞、是否调用 BeginPlay 等：

FActorSpawnParameters SpawnParams; SpawnParams.Owner = this; // 设置生成的所有者 SpawnParams.Instigator = GetInstigator(); // 设置生成的 Instigator（通常用于表示伤害来源） AActor* SpawnedActor = GetWorld()->SpawnActor<AActor>(ActorClass, Location, Rotation, SpawnParams); if (SpawnedActor) { UE_LOG(LogTemp, Warning, TEXT("Successfully spawned actor with parameters.")); }

2.4 生成蓝图类

你可以通过 TSubclassOf 或 UClass* 引用蓝图类来生成蓝图对象：

// 假设我们有一个蓝图类引用，指向 BP_MyActor（它是 AMyActor 的子类） TSubclassOf<AMyActor> BlueprintClass = BP_MyActorClass; // 使用蓝图类生成对象 AMyActor* SpawnedActor = GetWorld()->SpawnActor<AMyActor>(BlueprintClass, Location, Rotation); if (SpawnedActor) { UE_LOG(LogTemp, Warning, TEXT("Successfully spawned blueprint actor.")); }

3. 常见的生成参数

FActorSpawnParameters 结构体中包含以下常用生成参数：

Owner：生成 Actor 的所有者（通常是控制该 Actor 的对象）。
Instigator：生成 Actor 的激励者（通常是引发生成行为的对象，如攻击的来源）。
bNoCollisionFail：是否在生成时忽略碰撞检测。如果为 true，则在生成时不考虑物体之间的碰撞。
SpawnCollisionHandlingOverride：定义碰撞处理方式的枚举。可以设置为以下值：
- ESpawnActorCollisionHandlingMethod::AlwaysSpawn：总是生成，即使有碰撞也生成。
- ESpawnActorCollisionHandlingMethod::AdjustIfPossibleButAlwaysSpawn：如果可能的话调整生成位置，但无论如何都会生成。
- ESpawnActorCollisionHandlingMethod::AdjustIfPossibleButDontSpawnIfColliding：如果有碰撞就不生成。
- ESpawnActorCollisionHandlingMethod::DontSpawnIfColliding：如果有碰撞就不生成。

生成带有碰撞检测的 Actor 示例：

FActorSpawnParameters SpawnParams; SpawnParams.SpawnCollisionHandlingOverride = ESpawnActorCollisionHandlingMethod::AdjustIfPossibleButAlwaysSpawn; AActor* SpawnedActor = GetWorld()->SpawnActor<AActor>(ActorClass, Location, Rotation, SpawnParams);