Unreal Paper2D：如何在C++中动态为Sprite Actor设置Sprite

我为游戏中的各类“物品”导入了大量资源，并将每个资源转换为Sprite。我在C++中创建了继承自APaperSpriteActor的子类ASLBaseSpriteActor，以便在世界中动态生成各类“物品”。

我正面临动态为新生成的ASLBaseSpriteActor设置特定Sprite的难题：

• 将如下代码放在构造函数中时能正常工作，生成后可在世界中看到“苹果”物品：

ASLBaseSpriteActor::ASLBaseSpriteActor() {
   UE_LOG(LogTemp, Warning, TEXT("ASLBaseSpriteActor::constructor"));
   UPaperSprite* sprite = Cast<UPaperSprite>(StaticLoadObject(UPaperSprite::StaticClass(), NULL, TEXT("/Script/Paper2D.PaperSprite'/Game/Assets/Items/apple_Sprite.apple_Sprite'")));
   UE_LOG(LogTemp, Warning, TEXT("ASLBaseSpriteActor::Initialize2"));
   if (sprite) {
      UE_LOG(LogTemp, Warning, TEXT("ASLBaseSpriteActor::Initialize got sptire"));
      UPaperSpriteComponent* renderComponent = this->GetRenderComponent();
      if (renderComponent) {
         this->GetRenderComponent()->SetSprite(sprite);
         UE_LOG(LogTemp, Warning, TEXT("ASLBaseSpriteActor::Initialize got render comp"));
      }
   }
}

但问题在于Sprite路径最终需要作为参数传入，而将相同代码放到BeginPlay中时，尽管日志显示sprite和renderComponent均不为空，却无法在世界中看到物品。

我也尝试了延迟生成，在游戏模式中执行如下代码：

void ASLGameModeBase::BeginPlay() {
   UWorld* const World = GetWorld();
   if (World) {
      const FTransform SpawnLocAndRotation;
      ASLBaseSpriteActor* newItem = World->SpawnActorDeferred<ASLBaseSpriteActor>(ASLBaseSpriteActor::StaticClass(), SpawnLocAndRotation);
      newItem->Initialize();
      newItem->FinishSpawning(SpawnLocAndRotation);
   }
}

并将构造函数中的代码移至ASLBaseSpriteActor::Initialize方法中，但同样无效。

除了为每个物品都子类化APaperSpriteActor并在构造函数中设置Sprite路径外，我别无他法。请问如何仅用单个ASLBaseSpriteActor类，在生成时根据路径参数动态为其实例绑定Sprite？

方法1：修正延迟生成流程，确保组件正确初始化 #

问题出在延迟生成时，Initialize方法执行时机可能早于Sprite组件的完全初始化。可以调整流程，将Sprite路径作为参数传递给Initialize，并在设置Sprite后强制刷新组件：

1. 修改ASLBaseSpriteActor，添加带参数的初始化方法：

// ASLBaseSpriteActor.h
public:
    void Initialize(const FString& SpritePath);

private:
    UPaperSpriteComponent* GetSpriteComponent();

// ASLBaseSpriteActor.cpp
void ASLBaseSpriteActor::Initialize(const FString& SpritePath) {
    if (SpritePath.IsEmpty()) return;

    // 加载Sprite资源
    UPaperSprite* Sprite = Cast<UPaperSprite>(StaticLoadObject(UPaperSprite::StaticClass(), nullptr, *SpritePath));
    if (!Sprite) {
        UE_LOG(LogTemp, Error, TEXT("Failed to load sprite from path: %s"), *SpritePath);
        return;
    }

    // 获取Sprite组件（APaperSpriteActor默认组件为Sprite，通过类直接获取更可靠）
    UPaperSpriteComponent* SpriteComp = GetSpriteComponent();
    if (SpriteComp) {
        SpriteComp->SetSprite(Sprite);
        // 强制刷新渲染状态与边界，确保Sprite生效
        SpriteComp->MarkRenderStateDirty();
        SpriteComp->UpdateBounds();
    }
}

UPaperSpriteComponent* ASLBaseSpriteActor::GetSpriteComponent() {
    return Cast<UPaperSpriteComponent>(GetComponentByClass(UPaperSpriteComponent::StaticClass()));
}

2. 修改游戏模式的延迟生成代码，传递Sprite路径参数：

void ASLGameModeBase::BeginPlay() {
    Super::BeginPlay();
    UWorld* const World = GetWorld();
    if (!World) return;

    const FTransform SpawnTransform;
    // 替换为目标Sprite资源路径
    const FString TargetSpritePath = TEXT("/Script/Paper2D.PaperSprite'/Game/Assets/Items/apple_Sprite.apple_Sprite'");

    ASLBaseSpriteActor* NewItem = World->SpawnActorDeferred<ASLBaseSpriteActor>(ASLBaseSpriteActor::StaticClass(), SpawnTransform);
    if (NewItem) {
        NewItem->Initialize(TargetSpritePath);
        NewItem->FinishSpawning(SpawnTransform);
    }
}

方法2：在PostInitializeComponents中设置Sprite #

如果不想用延迟生成，可以重写PostInitializeComponents方法——这是组件初始化完成后的回调，比BeginPlay更早且更可靠：

// ASLBaseSpriteActor.h
public:
    UPROPERTY()
    FString SpritePathToLoad;

protected:
    virtual void PostInitializeComponents() override;

// ASLBaseSpriteActor.cpp
void ASLBaseSpriteActor::PostInitializeComponents() {
    Super::PostInitializeComponents();

    if (SpritePathToLoad.IsEmpty()) return;

    UPaperSprite* Sprite = Cast<UPaperSprite>(StaticLoadObject(UPaperSprite::StaticClass(), nullptr, *SpritePathToLoad));
    if (Sprite) {
        UPaperSpriteComponent* SpriteComp = GetSpriteComponent();
        if (SpriteComp) {
            SpriteComp->SetSprite(Sprite);
            SpriteComp->MarkRenderStateDirty();
        }
    }
}

使用时直接设置路径后生成Actor：

void ASLGameModeBase::BeginPlay() {
    Super::BeginPlay();
    UWorld* const World = GetWorld();
    if (!World) return;

    const FTransform SpawnTransform;
    ASLBaseSpriteActor* NewItem = World->SpawnActor<ASLBaseSpriteActor>(ASLBaseSpriteActor::StaticClass(), SpawnTransform);
    if (NewItem) {
        NewItem->SpritePathToLoad = TEXT("/Script/Paper2D.PaperSprite'/Game/Assets/Items/apple_Sprite.apple_Sprite'");
    }
}

关键注意点 #

• 避免直接使用GetRenderComponent()，APaperSpriteActor的默认渲染组件是UPaperSpriteComponent，通过GetComponentByClass获取更稳定。
• 设置Sprite后必须调用MarkRenderStateDirty()和UpdateBounds()，确保引擎及时更新渲染状态。
• 延迟生成时，SpawnActorDeferred会暂停Actor初始化，直到调用FinishSpawning，此时在Initialize中设置Sprite是安全的，但要确保组件已创建。

内容的提问来源于stack exchange，提问作者Lenka Pitonakova