Actor介绍和作用
- Actor类是游戏中一切实体Actor的基类(继承UObject)。
- 代表着游戏中的一个实体或物体。
- 是可见的角色、道具、敌人、NPC、触发器等。
- 可以在游戏世界中被放置、创建和操作。
- 需要挂载组件的时候，你才应该继承自Actor类。
- 运行中通过网络来复制属性和函数调用
image.png
Actor的行为表现
- 在游戏世界中的位置（位置矢量）和变换（旋转和缩放）
- 组件系统：Actor由一个或多个组件组成，每个组件代表Actor的一个功能或特性。
- 组件可以附加和管理Actor的行为、外观和交互。
- 通过脚本或视觉蓝图来定义其行为和交互。
- 控制Actor的移动、动画、碰撞、触发事件等,能够响应玩家的输入、与其他Actor进行交互。
- 碰撞和触发器：设置碰撞体积和形状，导致伤害、触发事件或改变游戏状态。
Actor的常用函数
- BeginPlay():第一次被放置到场景中并准备开始游戏时被调用。
- Tick() :它在每一帧中被调用，用于更新 Actor 的逻辑和状态。
- OnActorBeginOverlap() 和 OnActorEndOverlap()：碰撞事件的回调函数
- Destroy() :用于销毁当前的 Actor。
- SetActorLocation() 和 SetActorRotation()：设置 Actor 的位置和旋转。
- SetActorHiddenInGame() 可以设置 Actor 在游戏中是否隐藏。
- GetWorld() 返回当前 Actor 所属的 World 对象。
- GetOwner() 返回当前 Actor 的所有者 Actor。
- GetActorScale3D() 和 SetActorScale3D() 用于获取和设置 Actor 的缩放值。
Actor的优秀子类
- AStaticMeshActor(内部包含UStaticMeshComponent): 呈现具有实体属性的静态网格模型。
- ACharacter: 继承APawn, 具有角色属性和动画的角色.
- AProjectile: 用于表示游戏中的抛射物或子弹的 Actor 子类
- ATriggerVolume: 继承AVolume, 用于创建触发器区域的 Actor 子类
- APlayerStart:指定玩家初始或重生位置的 Actor 子类
- ACameraActor:(内部包含CameraComponent), 控制摄像机位置、旋转和视角。
Actor的创建
- 创建方式:
- 1 从磁盘加载（Load From Disk）: 用于已经在关卡中的Actor(LoadMap, 关卡流送)
- 2 在编辑器PIE中运行: Actor从编辑器中复制而来，并非从磁盘中加载。
- 3 代码生成: 调用 UWorld::SpawnActor(才会有World::OnActorSpawned 回调)
- 4 延迟生成: SpawnActorDeferred 生成流程性Actor，允许在蓝图构建脚本之前进行额外设置。
- 多种创建的Actor的销毁路径是相同的
Actor EndPlay的全部情形：
- 1 对Destroy显式调用。
- 2 "在编辑器中运行（Play in Editor）"终结。
- 3 关卡过渡（无缝行程或加载地图）。
- 4 包含Actor的流送关卡被卸载。
- 5 Actor的生命周期已过。
- 6 应用程序关闭（全部Actor被销毁）。
- Actor将被标记为 RF_PendingKill，在下个垃圾回收周期中，UE会将其从内存中解除。
Actor的回收函数
- UObject::BeginDestroy - 利用此机会释放内存并处理其他多线程资源。大多数Gameplay功能应在EndPlay中处理。
- UObject::IsReadyForFinishDestroy - GC调用，以确定对象是否可以永久解除分配或延迟对象销毁。
- UObject::FinishDestroy - 释放内部数据结构。内存释放前的最后一次调用。
创建和组件初始化
-
销毁和回收
销毁和回收
Actor的组件系统
- Actor包含一个或多个Actor组件
- 组件控制Actor的移动方式,渲染等行为、外观和其他属性。
Actor的创建和配置
- 编辑器中直接摆放
- 通过C++代码运行时动态生成
- 编辑器可见性 和 灵活性和可编程性 不同
- 直接摆放 适合于静态场景布置和设计，对于位置、外观和属性相对固定。
Actor的交互和行为
- DECLARE_EVENT来关心Actor的事件,并进行绑定.
- DECLARE_MULTICAST_DELEGATE 多播委托
- DECLARE_DYNAMIC_MULTICAST 动态多播委托(支持蓝图)
- public 的方法直接调用
Actor的优化和性能
- 包括减少组件数量、使用合适的碰撞设置等。
- 对Actor的生命周期合理管理，避免资源泄漏和性能问题。
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "Materials/Material.h"
#include "Components/PointLightComponent.h"
#include "Components/SphereComponent.h"
#include "Components/StaticMeshComponent.h"
#include "MyActor.generated.h"
- 头文件包含注意: #include "MyActor.generated.h" 必须在最后一行
UCLASS()
class AMyActor : public AActor
{
GENERATED_BODY()
public:
// 声明事件
DECLARE_EVENT(AMyActor, FMyCrashEvent);
// 外部使用此函数来绑定和广播
FMyCrashEvent& OnCrashed() { return CrashEvent; }
// 事件内部封装
private:
FMyCrashEvent CrashEvent;
// 事件回调函数
UFUNCTION()
void HandleCrashEvent();
public:
AMyActor();
// Called every frame
virtual void Tick(float DeltaTime) override;
UFUNCTION()
void OnOverlapBegin(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor,
class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);
UFUNCTION()
void OnOverlapEnd(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor,
class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);
/** 切换光照组件的可见性*/
UFUNCTION()
void ToggleLight();
- 上半部分声明事件和时间的回调函数
- 下半部分声明了tick 和 重叠的开始和结束的委托函数
// Called when the game starts or when spawned
virtual void BeginPlay() override
{
Super::BeginPlay();
UE_LOG(LogTemp, Warning, TEXT("BeginPlay"));
}
virtual void EndPlay(const EEndPlayReason::Type EndPlayReason) override
{
Super::EndPlay(EndPlayReason);
UE_LOG(LogTemp, Warning, TEXT("EndPlay"));
}
virtual void BeginDestroy() override
{
Super::BeginDestroy();
UE_LOG(LogTemp, Warning, TEXT("BeginDestroy"));
}
virtual void FinishDestroy() override
{
Super::FinishDestroy();
UE_LOG(LogTemp, Warning, TEXT("FinishDestroy"));
}
- Actor的主要重载函数和执行顺序
/// <summary>
/// Actor的成员对象
/// </summary>
public:
// 点光源组件
UPROPERTY(VisibleAnywhere, Category = "Switch Components")
class UPointLightComponent* PointLight1;
/** 点光源的光照强度 */
UPROPERTY(VisibleAnywhere, Category = "Switch Variables")
float DesiredIntensity;
// 球体碰撞体组件
UPROPERTY(VisibleAnywhere, Category = "Switch Components")
class USphereComponent* Sphere1;
// 静态网格体组件
UPROPERTY(VisibleAnywhere, Category = "Switch Components")
class UStaticMeshComponent* MeshComponent1;
};
- 本Actor的成员对象
AMyActor::AMyActor()
{
PrimaryActorTick.bCanEverTick = true;
// 光源强度
DesiredIntensity = 3000.0f;
// 创建点光源(create,SetVisibility,RootComponent相关)
PointLight1 = CreateDefaultSubobject<UPointLightComponent>(TEXT("PointLight1"));
PointLight1->Intensity = DesiredIntensity;
PointLight1->SetVisibility(true);
// 设为根组件
SetRootComponent(PointLight1); // RootComponent = PointLight1;
// 创建静态网格体组件(先设StaticMesh,再设置材质)
MeshComponent1 = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("MeshComponent"));
// 查询和设置网格
static ConstructorHelpers::FObjectFinder<UStaticMesh> DefaultMeshAsset(TEXT("/Engine/BasicShapes/Sphere"));
if (DefaultMeshAsset.Succeeded())
{
MeshComponent1->SetStaticMesh(DefaultMeshAsset.Object);
}
// 查询和设置材质
static ConstructorHelpers::FObjectFinder<UMaterial> DefaultMaterialAsset(TEXT("/Engine/EngineMaterials/ScreenMaterial"));
if (DefaultMaterialAsset.Succeeded())
{
UMaterial* DefaultMaterial = (UMaterial*)DefaultMaterialAsset.Object;
MeshComponent1->SetMaterial(0, DefaultMaterial);
}
// 附加到根组件
MeshComponent1->SetupAttachment(RootComponent);
MeshComponent1->SetVisibility(true);
// 创建球形碰撞体
Sphere1 = CreateDefaultSubobject<USphereComponent>(TEXT("Sphere1"));
Sphere1->InitSphereRadius(250.0f);
Sphere1->SetupAttachment(RootComponent);
Sphere1->SetVisibility(true);
// 注册进入和离开重叠时的回调
Sphere1->OnComponentBeginOverlap.AddDynamic(this, &AMyActor::OnOverlapBegin);
Sphere1->OnComponentEndOverlap.AddDynamic(this, &AMyActor::OnOverlapEnd);
// 关心碰撞事件
OnCrashed().AddUObject(this, &AMyActor::HandleCrashEvent); // C++
OnCrashed().AddUFunction(this, FName("HandleCrashEvent")); // todo 测试蓝图
}
- 构造函数中创建和添加组件
- 注册碰撞的进入和离开回调
- 注册碰撞事件的回调函数 X 2
void AMyActor::OnOverlapBegin(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor,
class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult)
{
if (OtherActor && (OtherActor != this) && OtherComp)
{
ToggleLight();
}
OnCrashed().Broadcast();
}
// 碰撞处理事件
void AMyActor::HandleCrashEvent()
{
UE_LOG(LogTemp, Warning, TEXT("HandleCrashEvent be Called"));
}
- 碰撞开始的函数执行,并广播自定义事件:碰撞处理事件
网友评论