向蓝图公开游戏进程元素

作为一名程序员，使用蓝图可以使代码非常灵活，从而为您提供许多好处。例如， 游戏进程设计人员可能希望在游戏中实现一种新型武器。作为程序员， 您现在编写武器代码的方式与传统方式几乎完全相同，而不同之处仅在于您公开了一些重要的功能， 比如射速和Fire()函数。在游戏测试后，设计师确定他们需要改变枪支的射速 以呈曲线射击。设计师可以简单地进入蓝图并直接更改射速， 而不是对射速重新编码并重新编译游戏， 从而节省设计师和程序员的时间。

有关在项目中优化C++/蓝图发布版的详细信息，或在创建向蓝图公开的API时要记住的技巧， 请参阅蓝图编程指南。

使类可蓝图化

为了创建从某一个类扩展而来的蓝图，必须将该类定义为 可蓝图化（Blueprintable）； 这涉及到在类定义之前的 UCLASS() 宏中添加此关键字。此关键字使蓝图系统能够感知该类， 以便它显示在 新建蓝图（New Blueprint） 对话框的类列表中， 并且可以选择它作为所创建的蓝图的父类。

可蓝图化类最简单的声明形式如下所示：

	UCLASS(Blueprintable)
	class AMyBlueprintableClass : AActor
	{
		GENERATED_BODY()
	}
Copy full snippet

UCLASS(Blueprintable) class AMyBlueprintableClass : AActor { GENERATED_BODY() }

可读和可写属性

为了将C++类中定义的变量公开给从该类扩展而来的蓝图，必须使用变量定义之前的 UPROPERTY() 宏 中列出的下列关键字之一来定义该变量。 这些关键字使蓝图系统能够感知该变量，以便在 我的蓝图（My Blueprint） 面板中显示该变量， 并且可以设置或访问该变量的值。

	//Character's Health
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Character")
	float health;
Copy full snippet

//Character's Health UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Character") float health;

可执行和可覆盖函数

为了从蓝图调用本地函数，必须使用函数定义前面的 UFUNCTION() 宏 中列出的下列关键字之一来定义该函数。这些关键字使蓝图系统能够感知该函数， 以便在上下文菜单或控制板中显示该函数，并可将其添加到图中并执行 - 或者， 在发生事件的情况下，可以覆盖和执行这些函数。

BlueprintCallable函数最简单的声明形式如下所示：

	//Fire a Weapon
	UFUNCTION(BlueprintCallable, Category="Weapon")
	void Fire();
Copy full snippet

//Fire a Weapon UFUNCTION(BlueprintCallable, Category="Weapon") void Fire();

在创建函数签名时，请注意，通过引用传递某一参数将使该参数成为蓝图节点上的输出引脚。若要使参数通过引用传递并仍然显示为输入， 请使用“UPARAM()”宏。

	UFUNCTION(BlueprintCallable, Category = "Example Nodes")
	static void HandleTargets(UPARAM(ref) TArray<FVector>& InputLocations, TArray<FVector>& OutputLocations);
Copy full snippet

UFUNCTION(BlueprintCallable, Category = "Example Nodes") static void HandleTargets(UPARAM(ref) TArray<FVector>& InputLocations, TArray<FVector>& OutputLocations);

您还可以使用“UPARAM()”来更改引脚的显示名称。例如，KismetMathLibrary中的MakeRotator函数使用“UPARAM()”和“DisplayName”关键字来更改绕Z轴的旋转、绕X轴的旋转、绕Y轴的旋转参数在蓝图中的显示方式。

	/** 根据采用度数的旋转值制作一个旋转体{绕Z轴的旋转、绕X轴的旋转、绕Y轴的旋转} */
	UFUNCTION(BlueprintPure, Category="Math|Rotator", meta=(Keywords="construct build rotation rotate rotator makerotator", NativeMakeFunc))
	static FRotator MakeRotator(
	UPARAM(DisplayName="X (Roll)") float Roll,	
	UPARAM(DisplayName="Y (Pitch)") float Pitch,
	UPARAM(DisplayName="Z (Yaw)") float Yaw);
Copy full snippet

/** 根据采用度数的旋转值制作一个旋转体{绕Z轴的旋转、绕X轴的旋转、绕Y轴的旋转} */ UFUNCTION(BlueprintPure, Category="Math|Rotator", meta=(Keywords="construct build rotation rotate rotator makerotator", NativeMakeFunc)) static FRotator MakeRotator( UPARAM(DisplayName="X (Roll)") float Roll, UPARAM(DisplayName="Y (Pitch)") float Pitch, UPARAM(DisplayName="Z (Yaw)") float Yaw);