Unreal Engine：如何移除接口警告并保留蓝图兼容性？

问题描述 #

我在开发Unreal Engine项目时，希望在蓝图中使用C++类，但某个接口遇到了警告问题。

我的FBloc接口代码如下：

UINTERFACE(BlueprintType)
class UFBloc : public UInterface {
    GENERATED_BODY()
public:
    UFBloc() {}
    ~UFBloc() {}
};

class IFBloc {
    GENERATED_BODY()

public:
    TScriptInterface<UFBloc> next;

    UFUNCTION(BlueprintCallable, Category="Bloc")
    virtual void Execute() const = 0;
    UFUNCTION(BlueprintCallable, Category="Bloc")
    virtual void Update() const = 0;

    UFUNCTION(BlueprintCallable, Category="Bloc")
    virtual TScriptInterface<UFBloc> GetNextNode() const { return next.GetObject(); }
    UFUNCTION(BlueprintCallable, Category="Bloc")
    virtual void setNext(TScriptInterface<UFBloc>newNext) {next = newNext;}

    // UFUNCTION(BlueprintNativeEvent, BlueprintCallable, Category="Bloc")
    // void DoSomething();
    
};

该接口能正常工作，但会触发以下警告：

Warning: Interfaces with BlueprintCallable functions but no events should explicitly declare NotBlueprintable on the interface.

添加NotBlueprintable可以消除警告，但会导致接口无法在蓝图中使用；添加BlueprintNativeEvent函数后警告仍未消失：

UFUNCTION(BlueprintNativeEvent, BlueprintCallable, Category="Bloc")
void DoSomething();

解决方法 #

问题核心是Unreal的接口规则：可蓝图使用的接口要么包含可蓝图实现的事件（BlueprintImplementableEvent），要么明确声明NotBlueprintable。你添加的BlueprintNativeEvent未满足规则要求，因此警告未消除。以下两种方式可保留蓝图可用性并移除警告：

方式一：添加空的BlueprintImplementableEvent函数 #

在IFBloc类中声明一个无实际逻辑的蓝图可实现事件，无需编写C++实现，仅需满足规则检查：

UFUNCTION(BlueprintImplementableEvent, Category="Bloc")
void DummyBlueprintEvent();

这个函数不需要被调用，仅用来让Unreal识别接口支持蓝图事件，从而消除警告。

方式二：补全BlueprintNativeEvent的实现 #

BlueprintNativeEvent必须存在对应的_Implementation函数，否则Unreal不会将其视为有效的蓝图事件。具体操作如下：

1. 显式标注接口的蓝图属性（可选但更清晰）：

UINTERFACE(BlueprintType, Blueprintable)
class UFBloc : public UInterface {
    GENERATED_BODY()
public:
    UFBloc() {}
    ~UFBloc() {}
};

2. 在IFBloc类中声明事件，并在.cpp文件中补全实现：

// 头文件声明
UFUNCTION(BlueprintNativeEvent, BlueprintCallable, Category="Bloc")
void DoSomething();

// .cpp文件实现
void IFBloc::DoSomething_Implementation() {
    // 可留空或编写默认逻辑
}

补全实现后，Unreal会识别到该Native事件的存在，警告即可消失。

关键说明 #

• Unreal的警告逻辑是：若接口包含BlueprintCallable函数，但无任何可蓝图交互的事件（BlueprintImplementableEvent或正确实现的BlueprintNativeEvent），则会提示开发者要么将接口设为不可蓝图使用，要么添加事件支持。
• BlueprintNativeEvent必须搭配_Implementation函数，否则无法被Unreal判定为有效蓝图事件。

内容的提问来源于stack exchange，提问作者Alexandre Boucard