Unreal Engine 5 C++中UINTERFACE函数无法返回结构体的问题

嘿，我看到你在UE5的C++/Blueprint项目里碰到了UINTERFACE函数返回结构体的问题，先别慌，咱们把这个问题拆解开来一步步解决。

首先得明确一个关键前提：你要返回的结构体必须是Unreal反射系统认可的USTRUCT，而不是普通的C++结构体。如果你的AdditionalInfo还没定义成USTRUCT，那第一步就得改这个：

// AdditionalInfo.h
#pragma once
#include "CoreMinimal.h"
#include "AdditionalInfo.generated.h"

USTRUCT(BlueprintType)  // 标记为BlueprintType让蓝图也能识别
struct FAdditionalInfo
{
    GENERATED_BODY()  // 必须加这个，让Unreal生成反射代码

    // 给结构体成员加UPROPERTY，这样蓝图也能访问
    UPROPERTY(BlueprintReadWrite, Category = "Additional Info")
    int32 SomeData;

    UPROPERTY(BlueprintReadWrite, Category = "Additional Info")
    FString SomeText;

    // 其他你需要的成员变量或函数
};

接下来是你的UINTERFACE和接口类的正确写法。记住，UFBloc这个UINTERFACE类只是给Unreal反射系统用的壳子，真正的接口逻辑在IFBloc里，而且要让接口函数能返回结构体，必须给函数加上UFUNCTION宏，并且指定合适的属性：

// ProgrammingSystem.h
#pragma once
#include "CoreMinimal.h"
#include "AdditionalInfo.h"
#include "ProgrammingSystem.generated.h"

UINTERFACE(BlueprintType)
class UFBloc : public UInterface
{
    GENERATED_BODY()

public:
    UFBloc() {}
};

class IFBloc
{
    GENERATED_BODY()

public:
    // 如果你想让这个函数是纯C++的，且子类必须实现，用BlueprintCallable + 纯虚函数
    UFUNCTION(BlueprintCallable, Category = "Bloc Interface")
    virtual FAdditionalInfo GetBlocData() const = 0;

    // 如果你想让蓝图也能重写这个函数，用BlueprintNativeEvent
    UFUNCTION(BlueprintNativeEvent, Category = "Bloc Interface")
    FAdditionalInfo GetBlocEventData();
};

然后，当你在其他类（比如Actor、ActorComponent）里实现这个接口时，要注意正确重写函数：

// MyBlocActor.h
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "ProgrammingSystem.h"
#include "MyBlocActor.generated.h"

UCLASS()
class YOURPROJECT_API AMyBlocActor : public AActor, public IFBloc
{
    GENERATED_BODY()
    
public:    
    AMyBlocActor();

protected:
    virtual void BeginPlay() override;

public:    
    virtual void Tick(float DeltaTime) override;

    // 重写纯虚函数
    virtual FAdditionalInfo GetBlocData() const override;

    // 重写NativeEvent函数，注意要加_Implementation后缀
    virtual FAdditionalInfo GetBlocEventData_Implementation() override;
};

// MyBlocActor.cpp
#include "MyBlocActor.h"

AMyBlocActor::AMyBlocActor()
{
    PrimaryActorTick.bCanEverTick = true;
}

void AMyBlocActor::BeginPlay()
{
    Super::BeginPlay();
}

void AMyBlocActor::Tick(float DeltaTime)
{
    Super::Tick(DeltaTime);
}

FAdditionalInfo AMyBlocActor::GetBlocData() const
{
    FAdditionalInfo Result;
    Result.SomeData = 42;
    Result.SomeText = TEXT("Hello from C++");
    return Result;
}

FAdditionalInfo AMyBlocActor::GetBlocEventData_Implementation()
{
    FAdditionalInfo Result;
    Result.SomeData = 100;
    Result.SomeText = TEXT("Hello from Native Event");
    return Result;
}

最后再给你几个容易踩坑的点：

• 一定要确保所有头文件都正确包含，尤其是结构体的头文件要在UINTERFACE头文件之前包含
• 接口里的函数如果要返回结构体，不能省略UFUNCTION宏，否则Unreal反射系统识别不了，蓝图里也看不到这个函数
• 如果用BlueprintNativeEvent，实现的时候函数名必须加上_Implementation后缀，这是Unreal的约定

这样处理之后，你的UINTERFACE函数应该就能正常返回结构体了，不管是在C++里调用还是在蓝图里使用都没问题。

备注：内容来源于stack exchange，提问作者Alexandre Boucard