UE C++库暴露给蓝图时，为何函数参数无法正确显示在蓝图中？

Question

在 Unreal Engine 中，当将 C++ 函数暴露给蓝图时，有时会发现函数参数无法正确显示在蓝图节点中。这一问题的常见原因包括：1) 缺少 `UFUNCTION` 宏或未正确设置其属性（如 `BlueprintCallable` 或 `meta = (Keywords, ToolTip)`），导致引擎无法识别该函数为蓝图可用；2) 参数类型不支持蓝图绑定，例如自定义结构体未使用 `USTRUCT()` 宏标记，或某些复杂类型（如模板、裸指针）无法直接用于蓝图；3) 函数声明中存在默认参数，但未正确处理，默认值可能干扰蓝图解析；4) 函数所在类未标记为 `UCLASS()` 或未正确生成反射数据。解决方法是确保所有相关宏正确应用，并验证类型兼容性与元数据配置。

Answer 1

Unreal Engine 中蓝图函数参数问题分析与解决

1. 问题概述

在 Unreal Engine 的开发中，将 C++ 函数暴露给蓝图是一项常见的需求。然而，开发者有时会遇到函数参数无法正确显示在蓝图节点中的问题。这一现象可能由多种原因引发，包括宏配置、类型兼容性、默认参数处理以及类反射数据生成等。

• 缺少必要的宏（如 `UFUNCTION`）或未正确设置其属性。
• 参数类型不支持蓝图绑定。
• 函数声明中存在未正确处理的默认参数。
• 函数所在类未标记为 `UCLASS()` 或未正确生成反射数据。

以下章节将详细探讨这些问题的成因及解决方案。

2. 常见原因分析

以下是导致蓝图函数参数无法正常显示的主要原因及其分析：

2.1 缺少 UFUNCTION 宏

在 Unreal Engine 中，只有通过 `UFUNCTION` 宏标记的函数才能被识别为蓝图可用。如果忘记添加该宏或未正确设置其属性（如 `BlueprintCallable`），引擎将无法生成相应的蓝图节点。

UFUNCTION(BlueprintCallable, Category = "Example")
void ExampleFunction();

确保 `UFUNCTION` 宏已正确应用，并检查是否包含 `BlueprintCallable` 属性以允许蓝图调用。

2.2 参数类型不支持蓝图绑定

某些类型（如模板、裸指针）无法直接用于蓝图。此外，自定义结构体若未使用 `USTRUCT()` 宏标记，也无法被蓝图识别。

问题类型	解决方案
裸指针	改用 UPROPERTY 标记的对象引用。
自定义结构体	使用 USTRUCT 宏标记结构体。

3. 解决方案详解

针对上述问题，以下提供具体的解决方法：

3.1 确保宏配置正确

除了 `UFUNCTION` 宏外，还需确保函数所在的类已标记为 `UCLASS()`。此外，可通过 `meta` 属性为函数添加元数据，例如关键词和工具提示。

UCLASS()
class MYPROJECT_API AMyClass : public AActor
{
    GENERATED_BODY()

public:
    UFUNCTION(BlueprintCallable, meta = (Keywords = "example", ToolTip = "This is an example function"))
    void MyBlueprintFunction();
};

3.2 验证类型兼容性

对于不支持蓝图绑定的类型，需进行适当调整。例如，将裸指针替换为对象引用，或将自定义结构体标记为 `USTRUCT()`。

USTRUCT(BlueprintType)
struct FMyStruct
{
    GENERATED_BODY()

    UPROPERTY(EditAnywhere, BlueprintReadWrite)
    int32 Value;
};

3.3 处理默认参数

如果函数声明中包含默认参数，需确保这些参数不会干扰蓝图解析。建议避免在蓝图暴露的函数中使用复杂的默认值。

sequenceDiagram participant Developer participant Engine Developer->>Engine: 提供带有默认参数的函数 Engine-->>Developer: 默认值可能导致解析失败 Developer->>Engine: 修改函数签名，移除复杂默认值

3.4 检查反射数据生成

确保函数所在类已正确生成反射数据。这通常需要在编译时验证 `UCLASS()` 和 `GENERATED_BODY()` 是否正确应用。

通过以上步骤，可以有效解决蓝图函数参数无法正常显示的问题。同时，结合实际开发场景灵活调整策略，有助于提升开发效率和代码质量。