网站视频解析,做食品怎样选网站,网站有做货,58临沂网站建设UFunction 是虚幻引擎#xff08;UE#xff09;反射系统可识别的C函数。UObject 或蓝图函数库可将成员函数声明为UFunction#xff0c;方法是将 UFUNCTION 宏放在头文件中函数声明上方的行中。宏将支持 函数说明符 更改虚幻引擎解译和使用函数的方式。
UFUNCTION([specifie…UFunction 是虚幻引擎UE反射系统可识别的C函数。UObject 或蓝图函数库可将成员函数声明为UFunction方法是将 UFUNCTION 宏放在头文件中函数声明上方的行中。宏将支持 函数说明符 更改虚幻引擎解译和使用函数的方式。
UFUNCTION([specifier1setting1, specifier2, ...], [meta(key1value1, key2, ...)])
ReturnType FunctionName([Parameter1, Parameter2, ..., ParameterN1DefaultValueN1, ParameterN2DefaultValueN2]) [const];
可利用函数说明符将UFunction对蓝图可视化脚本图表公开以便开发者从蓝图资源调用或扩展UFunction而无需更改C代码。在类的默认属性中UFunction可绑定到委托从而能够执行一些操作例如将操作与用户输入相关联。它们还可以充当网络回调这意味着当某个变量受网络更新影响时用户可以将其用于接收通知并运行自定义代码。用户甚至可创建自己的控制台命令通常也称 debug、configuration 或 cheat code 命令并能在开发版本中从游戏控制台调用这些命令或将拥有自定义功能的按钮添加到关卡编辑器中的游戏对象。
函数说明符
声明函数时可以为声明添加 函数说明符以控制函数相对于引擎和编辑器的各个方面的行为方式。 函数说明符 效果 BlueprintAuthorityOnly 如果在具有网络权限的机器上运行服务器、专用服务器或单人游戏此函数将仅从蓝图代码执行。 BlueprintCallable 此函数可在蓝图或关卡蓝图图表中执行。 BlueprintCosmetic 此函数为修饰性的无法在专用服务器上运行。 BlueprintImplementableEvent 此函数可在蓝图或关卡蓝图图表中实现。 BlueprintNativeEvent 此函数旨在被蓝图覆盖掉但是也具有默认原生实现。用于声明名称与主函数相同的附加函数但是末尾添加了Implementation是写入代码的位置。如果未找到任何蓝图覆盖该自动生成的代码将调用 Implementation 方法。 BlueprintPure 此函数不对拥有它的对象产生任何影响可在蓝图或关卡蓝图图表中执行。 CallInEditor 可通过细节Details面板中的按钮在编辑器中的选定实例上调用此函数。 Category TopCategory|SubCategory|Etc 在蓝图编辑工具中显示时指定函数的类别。使用 | 运算符定义嵌套类别。 Client 此函数仅在拥有在其上调用此函数的对象的客户端上执行。用于声明名称与主函数相同的附加函数但是末尾添加了Implementation。必要时此自动生成的代码将调用 Implementation 方法。 CustomThunk UnrealHeaderTool 代码生成器将不为此函数生成thunk用户需要自己通过 DECLARE_FUNCTION 或 DEFINE_FUNCTION 宏来提供thunk。 Exec 此函数可从游戏内控制台执行。仅在特定类中声明时Exec命令才有效。 NetMulticast 此函数将在服务器上本地执行也将复制到所有客户端上无论该Actor的 NetOwner 为何。 Reliable 此函数将通过网络复制并且一定会到达即使出现带宽或网络错误。仅在与Client或Server配合使用时才有效。 SealedEvent 无法在子类中覆盖此函数。SealedEvent关键词只能用于事件。对于非事件函数请将它们声明为static或final以密封它们。 ServiceRequest 此函数为RPC远程过程调用服务请求。这意味着 NetMulticast 和 Reliable。 ServiceResponse 此函数为RPC服务响应。这意味着 NetMulticast 和 Reliable。 Server 此函数仅在服务器上执行。用于声明名称与主函数相同的附加函数但是末尾添加了 _Implementation是写入代码的位置。必要时此自动生成的代码将调用 _Implementation 方法。 Unreliable 此函数将通过网络复制但是可能会因带宽限制或网络错误而失败。仅在与Client或Server配合使用时才有效。 WithValidation 用于声明名称与主函数相同的附加函数但是末尾需要添加_Validate。此函数使用相同的参数但是会返回bool以指示是否应继续调用主函数。
元数据说明符
声明类、接口、结构体、列举、列举值、函数或属性时可添加 元数据说明符 来控制其与引擎和编辑器各方面的相处方式。每一种类型的数据结构或成员都有自己的元数据说明符列表。 函数元标签 效果 AdvancedDisplayParameter1, Parameter2, .. 以逗号分隔的参数列表将显示为高级引脚需要UI扩展。 AdvancedDisplayN 用一个数字替代 N 第N之后的所有参数将显示为高级引脚需要UI扩展。举例而言AdvancedDisplay2 将把前两个之外的所有参数标记为高级。 ArrayParmParameter1, Parameter2, .. 说明 BlueprintCallable 函数应使用一个Call Array Function节点且列出的参数应被视为通配符数组属性。 ArrayTypeDependentParamsParameter 使用 ArrayParm 时此说明符将指定一个参数其将确定 ArrayParm 列表中所有参数的类型。 AutoCreateRefTermParameter1, Parameter2, .. 如列出参数由引用传递的引脚未连接其将拥有一个自动创建的默认项。这是蓝图的一个便利功能经常在数组引脚上使用。 BlueprintAutocast 仅能由来自蓝图函数库的静态 BlueprintPure 函数使用。Cast节点将根据返回类型和函数首个参数的类型来自动添加。 BlueprintInternalUseOnly 此函数是一个内部实现细节用于实现另一个函数或节点。其从未直接在蓝图图表中公开。 BlueprintProtected 此函数只能在蓝图中的拥有对象上调用。其无法在另一个实例上调用。 CallableWithoutWorldContext 用于拥有一个 WorldContext 引脚的 BlueprintCallable 函数说明函数可被调用即使其类不实现 GetWorld 函数也同样如此。 CommutativeAssociativeBinaryOperator 说明 BlueprintCallable 函数应使用Commutative Associative Binary节点。此节点缺少引脚命名但拥有一个创建额外输入引脚的 添加引脚Add Pin 按钮。 CompactNodeTitleName 说明 BlueprintCallable 函数应在压缩显示模式中显示并提供在该模式中显示的命名。 CustomStructureParamParameter1, Parameter2, ..) 列出的参数都会被视为通配符。此说明符需要 UFUNCTION-level specifier、CustomThunk而它们又需要用户提供自定义的 exec 函数。在此函数中可对参数类型进行检查可基于这些参数类型执行合适的函数调用。永不应调用基础 UFUNCTION出现错误时应进行断言或记录。 要声明自定义 exec 函数使用语法 DECLARE_FUNCTION(execMyFunctionName)MyFunctionName 为原函数命名。 DefaultToSelf 用于 BlueprintCallable 函数说明对象属性的命名默认值应为节点的自我情境。 DeprecatedFunction 蓝图对此函数进行引用时将引起编译警告告知用户函数已废弃。可使用 DeprecationMessage 元数据说明符添加到废弃警告消息如提供说明如何替代已废弃的函数。 DeprecationMessageMessage Text 如果函数已废弃尝试编译使用此函数的蓝图时其将被添加到标准废弃警告。 DevelopmentOnly 被标记为 DevelopmentOnly 的函数只会在Development模式中运行。这适用于调试输出之类的功能但其不应存在于发布产品中。 DisplayNameBlueprint Node Name 此节点在蓝图中的命名将被此处提供的值所取代而非代码生成的命名。 ExpandEnumAsExecsParameter 用于 BlueprintCallable 函数说明应为参数使用的 列举 中的每个条目创建一个输入执行引脚。命名参数必须是引擎通过 UENUM 标签识别的一个列举类型。 HidePinParameter 用于 BlueprintCallable 函数说明参数引脚应从用户视图中隐藏。注意使用此方式每个函数只能隐藏一个参数引脚。 HideSelfPin 隐藏用于指出函数调用所处对象的self引脚。self引脚在与调用蓝图的类兼容的 BlueprintPure 函数上为自动隐藏状态。这通常与 DefaultToSelf 说明符共用。 InternalUseParamParameter 与 HidePin 相似这将在用户视图中隐藏命名参数的引脚只能用于一个函数的一个参数。 KeyWordsSet Of Keywords 指定在搜索此函数时可使用的一套关键词例如合适放置节点在蓝图图表中调用函数。 Latent 说明一个延迟操作。延迟操作拥有类型为 FLatentActionInfo 的一个参数此参数由 LatentInfo 说明符命名。 LatentInfoParameter 用于延迟 BlueprintCallable 函数说明哪个参数是LatentInfo参数。 MaterialParameterCollectionFunction 用于 BlueprintCallable 函数说明应使用材质覆盖节点。 NativeBreakFunc 用于 BlueprintCallable 函数说明函数应以标准Break Struct节点的方式进行显示。 NotBlueprintThreadSafe 只在蓝图函数库中有效。此函数将被视为拥有类的整体 BlueprintThreadSafe 元数据的一个例外。 ShortToolTipShort tooltip 完整提示文本过长时使用的简短提示文本例如父类选取器对话。 ToolTipHand-written tooltip 覆盖从代码注释自动生成的提示文本。 UnsafeDuringActorConstruction 在Actor构造时调用此函数并非安全操作。 WorldContextParameter 由 BlueprintCallable 函数使用说明哪个参数决定运算正在发生的World。
接口
创建和实现接口的引用 接口类有助于确保一组可能不相关的类实现一组通用函数。在某些游戏功能可能被大量复杂而不同的类共享的情况下这非常有用。例如某个游戏可能有这样一个系统依靠该系统输入一个触发器体积可以激活陷阱、警告敌人或向玩家奖励点数。这可以通过针对陷阱、敌人和点数奖励器执行ReactToTrigger函数来实现。然而陷阱可能派生自AActor敌人可能派生自专门的APawn或ACharacter子类点数奖励可能派生自UDataAsset。所有这些类都需要共享功能但它们没有除UObject之外的共同上级。在这种情况下推荐使用接口。
接口声明 声明接口类与声明普通的虚幻类相似但仍有两个主要区别。首先接口类使用UINTERFACE宏而不是UCLASS宏且直接从UInterface而不是UObject继承
UINTERFACE([specifier, specifier, ...], [meta(keyvalue, keyvalue, ...)])
class UClassName : public UInterface
{GENERATED_BODY()
其次UINTERFACE类不是实际的接口它是一个空白类它的存在只是为了向虚幻引擎反射系统确保可见性。将由其他类继承的实际接口必须具有相同的类名但是开头字母U必须改为I。
#pragma once#include ReactToTriggerInterface.generated.hUINTERFACE(MinimalAPI, Blueprintable)
class UReactToTriggerInterface : public UInterface
{GENERATED_BODY()
};class IReactToTriggerInterface
{ GENERATED_BODY()public:/** 在此处添加接口函数声明 */
};
前缀为UU-prefixed的类不需要构造函数或任何其他函数而前缀为II-prefixed的类将包含所有接口函数且此类实际上将被您的其他类继承。
接口说明符 接口说明符 含义 BlueprintType 将该类公开为可用于蓝图中的变量的类型。 DependsOn(ClassName1, ClassName2, ...) 所有列出的类都将在该类之前编译。ClassName必须在同一个或上一个包中指定一个类。多个依赖性类可以使用以逗号分隔的单个DependsOn行来指定也可以使用单个DependsOn行为每个类指定。当一个类使用在另一个类中声明的结构体或枚举时这一点非常重要因为编译器只知道它已经编译的类中的内容。 MinimalAPI 仅导致该类的类型信息被导出以供其他模块使用。您可以向该类转换但不能调用该类的函数内联方法除外。对于不需要其所有函数在其他模块中均可供访问的类通过不导出这些类的所有内容这可以缩短编译时间。
在C中实现接口
若要在一个新的类中使用您的接口只需从前缀为II-prefixed的接口类继承除了您正在使用的任何基于UObject的类即可。
在C中实现接口
若要在一个新的类中使用您的接口只需从前缀为II-prefixed的接口类继承除了您正在使用的任何基于UObject的类即可。
#include CoreMinimal.h
#include GameFramework/Actor.h
#include ReactToTriggerInterface.h
#include Trap.generated.hUCLASS(Blueprintable, CategoryMyGame)
class ATrap : public AActor, public IReactToTriggerInterface
{GENERATED_BODY()public:/** Add interface function overrides here. */
}
声明接口函数
有几种方法可以在接口中声明函数由环境决定能够实现或调用哪种方法。所有方法都必须在前缀为II-prefixed的类中为接口声明而且必须为 public以便对外部的类可见。
仅C的接口函数
可以在接口的头文件中声明一个不带 UFUNCTION 说明的虚拟C函数。这些函数必须为虚拟的以便在实现接口的类中覆盖它们。
可以在接口的头文件中声明一个不带 UFUNCTION 说明的虚拟C函数。这些函数必须为虚拟的以便在实现接口的类中覆盖它们。
ReactToTrigger.h
public:
virtual bool ReactToTrigger();
然后可以在头文件本身或接口的 .cpp 文件中提供一个默认的实现。
ReactToTrigger.cpp
bool IReactToTriggerInterface::ReactToTrigger()
{return false;
}
当在一个Actor类中实现接口后可以创建并实现一个针对该类的覆盖。
Trap.h
public:
virtual bool ReactToTrigger() override;
Trap.cpp
bool ATrap::ReactToTrigger()
{return false;
}
但是这些C接口函数对蓝图不可见。 蓝图可调用接口函数
要创建蓝图可调用的接口函数必须在带 BlueprintCallable 说明符的函数声明中提供一个 UFUNCTION 宏。还必须使用 BlueprintImplementableEvent 或 BlueprintNativeEvent 说明而且函数不能为虚拟的。
ReactToTrigger.h
public:
/**只能在蓝图中实现的React To Trigger版本。*/
UFUNCTION(BlueprintCallable, BlueprintImplementableEvent, CategoryTrigger Reaction)
bool ReactToTrigger();
ReactToTrigger.h
public:
/**可以在C或蓝图中实现的React To Trigger版本。*/
UFUNCTION(BlueprintCallable, BlueprintNativeEvent, CategoryTrigger Reaction)
bool ReactToTrigger();
BlueprintCallable
引用实现接口的对象的C或蓝图可以调用使用 BlueprintCallable 说明符的函数。
BlueprintImplementableEvent
使用 BlueprintImplementableEvent 的函数不能在C中被腹杆但可以任何实现或继承接口的蓝图类中被覆盖。
BlueprintNativeEvent
在C中可通过覆盖一个同名函数来实现使用 BlueprintNativeEvent 的函数但要在末尾添加上后缀 _Implementation。
Trap.h
public:
bool ReactToTrigger_Implementation() override;
Trap.cpp
bool ATrap::ReactToTrigger_Implementation() const
{return false;
}
该说明符还允许在蓝图中覆盖实现。
确定类是否实现了接口
为了与实现接口的C和蓝图类兼容可以使用以下任意函数
bool bIsImplemented OriginalObject-GetClass()-ImplementsInterface(UReactToTriggerInterface::StaticClass()); // 如果OriginalObject实现了UReactToTriggerInterface则bisimplemated将为true。bIsImplemented OriginalObject-ImplementsUReactToTriggerInterface(); // 如果OriginalObject实现了UReactToTriggerbIsImplemented将为true。IReactToTriggerInterface* ReactingObject CastIReactToTriggerInterface(OriginalObject); // 如果OriginalObject实现了UReactToTriggerInterface则ReactingObject将为非空。
如果StaticClass函数在前缀为II-prefixed的类中没有实现尝试在前缀为UU-prefixed的类上使用转换Cast将失败代码将无法编译。
转换到其他虚幻类型
虚幻引擎的转换系统支持从一个接口转换到另一个接口或者在适当的情况下从一个接口转换到一个虚幻类型。
IReactToTriggerInterface* ReactingObject CastIReactToTriggerInterface(OriginalObject); // 如果接口被实现则ReactingObject将为非空。ISomeOtherInterface* DifferentInterface CastISomeOtherInterface(ReactingObject); // 如果ReactingObject为非空而且还实现了ISomeOtherInterface则DifferentInterface将为非空。AActor* Actor CastAActor(ReactingObject); // 如果ReactingObject为非空且OriginalObject为AActor或AActor派生的类则Acto
元数据说明符
声明UClasses、UFunctions、UProperties、UEnums和UInterfaces时使用的元数据关键词说明其与虚幻引擎和关卡编辑器诸多方面的互动方式。
要添加元数据说明符到列举值可将 UMETA 标签添加到值本身。如果存在用于分隔的逗号则要添加到逗号之前如下所示
UENUM()
enum class EMyEnum : uint8
{// Default Value TooltipDefaultValue 0 UMETA(MetaTag1Value1, MetaTag2, ..),// ValueWithoutMetaSpecifiers TooltipValueWithoutMetaSpecifiers,// ValueWithMetaSpecifiers TooltipValueWithMetaSpecifiers UMETA((MetaTag1Value1, MetaTag2, ..),// FinalValue TooltipFinalValue (MetaTag1Value1, MetaTag2, ..)
};
类元数据说明符 BlueprintSpawnableComponent 如其存在组件类可由蓝图生成。 BlueprintThreadSafe 只在蓝图函数库上有效。此说明符将把此类中的函数在动画蓝图中的非游戏线程上标记为可调用。 ChildCannotTick 用于Actor和组件类。如果本地类无法tick那么基于此Actor或组件的蓝图生成类则无法tick即使 bCanBlueprintsTickByDefault 为true也同样如此。 ChildCanTick 用于Actor和组件类。如果本地类无法tick那么可以覆盖基于此Actor或组件的蓝图生成类的 bCanEverTick 标签即使 bCanBlueprintsTickByDefault 为false也同样如此。 DeprecatedNode 用于行为树节点说明类已废弃编译时将显示一条警告。 DeprecationMessageMessage Text 如果类已废弃尝试编译使用此类的蓝图时其将被添加到标准废弃警告。 DisplayNameBlueprint Node Name 此节点在蓝图中的命名将被此处提供的值所取代而非代码生成的命名。 DontUseGenericSpawnObject 不使用蓝图中的Generic Create Object节点来生成类的一个对象。此说明符只有在用于既非Actor又非ActorComponent的BluprintType类时才有意义。 ExposedAsyncProxy 在 Async Task 节点中公开此类的一个代理对象。 IgnoreCategoryKeywordsInSubclasses 用于让一个类的首个子类忽略所有继承的 ShowCategories 和 HideCategories 说明符。 IsBlueprintBasetrue/false 说明此类是否为创建蓝图的一个可接受基类与 UCLASS 说明符、Blueprintable 或 NotBlueprintable 相似。 KismetHideOverridesEvent1, Event2, .. 不允许被覆盖的蓝图事件的列表。 ProhibitedInterfacesInterface1, Interface2, .. 列出与类不兼容的接口。 RestrictedToClassesClass1, Class2, .. 由蓝图函数库类使用用于限制列表中命名类的用法。 ShortToolTipShort tooltip 完整提示文本过长时使用的简短提示文本例如父类选取器对话。 ShowWorldContextPin 说明放置在此类拥有的图表中的蓝图节点必须显式其World情景引脚即使其通常状态下为隐藏也同样如此因为此类的对象无法被用作World情景。 UsesHierarchy 说明类使用层级数据。用于实例化细节面板中的层级编辑功能。 ToolTipHand-written tooltip 覆盖从代码注释自动生成的提示文本。
对象
UCLASS 宏
UCLASS 宏为 UObject 提供了一个 UCLASS 引用用于描述它在虚幻引擎中的类型。每个 UCLASS 都保留一个称作 类默认对象Class Default Object 的对象简称CDO。CDO 本质上是一个默认模板对象由类构建函数生成之后就不再修改。 你可以为指定对象获取其 UCLASS 和 CDO虽然它们通常都是只读类型。 使用 GetClass() 函数即可随时访问对象实例的 UCLASS。
属性和函数类型
UObjects 可拥有成员变量称作属性或任意类型的函数。然而为便于虚幻引擎识别并操控这些变量或函数它们必须以特殊的宏进行标记并符合一定类型的标准。如需了解这些标准的细节请查阅属性和UFunction参考页面。
UObject 创建
UObjects 不支持构造器参数。所有的C UObject都会在引擎启动的时候初始化然后引擎会调用其默认构造器。如果没有默认的构造器那么 UObject 将不会编译。
UObject 构造器应该轻量化仅用于设置默认的数值和子对象构造时不应该调用其它功能和函数。对于 Actor和Actor组件初始化功能应该输入 BeginPlay() 方法。
UObject 应该仅在运行时使用 NewObject 构建或者将 CreateDefaultSubobject 用于构造器。 方法 描述 NewObjectclass 使用所有可用创建选项的可选参数创建一个新实例。提供极高的灵活性包括带自动生成命名的简单使用案例。 CreateDefaultSubobjectclass 创建一个组件或者子对象可以提供创建子类和返回父类的方法。
UObjects 提供的功能
此系统的使用不为强制要求甚至有时不适合使用但却存在以下益处 垃圾回收 引用更新
当PendingKill默认禁用时开发者不需要担心引用更新这一行可以在该UE版本中移除。 反射 序列化 默认属性变化自动更新 自动属性初始化 自动编辑器整合 运行时类型信息可用 网络复制
虚幻头文件工具
为利用 UObject 派生类型所提供的功能需要在头文件上为这些类型执行一个预处理步骤以核对需要的信息。该预处理步骤由 UnrealHeaderTool简称 UHT执行。UObject 派生的类型需要遵守特定的结构。
头文件格式
UObject 在源.cpp文件中的实现与其他 C 类相似其在头.h文件中的定义必须遵守特定的基础结构以便在虚幻引擎 4 中正常使用。使用编辑器的 New C Class 命令是设置格式正确头文件的最简单方法。UObject 派生类的基础头文件可能看起来与此相似假定 UObject 派生物被称为 UMyObject其创建时所在的项目被称为 MyProject
#pragma once#include Object.h
#include MyObject.generated.h
UCLASS()
class MYPROJECT_API UMyObject : public UObject
{GENERATED_BODY()};
虚幻引擎特定的部分如下
#include MyObject.generated.h UCLASS 宏使虚幻引擎能识别 UMyObject。此宏支持大量参数类说明符参数决定类功能的开或关
此行预计为此文件中最后一个 #include 指令。如此头文件需要了解其他类可将它们在文件中的任意位置提前声明或包括在 MyObject.generated.h 上。
UCLASS()
UCLASS 宏使虚幻引擎能识别 UMyObject。此宏支持大量参数类说明符参数决定类功能的开或关。
class MYPROJECT_API UMyObject : public UObject
如 MyProject 希望将 UMyObject 类公开到其他模块则需要指定 MYPROJECT_API。这对游戏项目将包括的模块或插件十分实用。这些模块和插件将故意使类公开在多个项目间提供可携的自含式功能。
GENERATED_BODY()
更新对象
Ticking 代表虚幻引擎中对象的更新方式。所有Actors均可在每帧被 tick便于您执行必要的更新计算或操作。
Actor 和 Actor组件在注册时会自动调用它们的 Tick 函数然而UObjects 不具有嵌入的更新能力。在必须的时候可以使用 inherits 类说明符从 FTickableGameObject 继承即可添加此能力。 这样即可实现 Tick() 函数引擎每帧都将调用此函数。
销毁对象
对象不被引用后垃圾回收系统将自动进行对象销毁。这意味着没有任何 UPROPERTY 指针、引擎容器、TStrongObjectPtr 或类实例会拥有任何对它的强引用。
UObject实例创建
NewObject
NewObject() 是最简单的UObject工厂方法。它接受一个可选的外部对象和类并用自动生成的名称创建一个新实例。
template class T
T* NewObject
(UObject* Outer(UObject*)GetTransientPackage(),UClass* ClassT::StaticClass()
) 参数 说明 Outer 可选。一个要设置为待创建对象的外部UObject。 Class 可选。一个用于指定待创建对象类的UClass。 Return Value 指向指定类的生成实例指针。
NewNamedObject
通过允许为新实例指定一个名称以及对象标记和一个要指定为参数的模板对象NewNamedObject() 在 NewObject() 上展开。
template class TClass
TClass* NewNamedObject
(UObject* Outer, FName Name, EObjectFlags Flags RF_NoFlags, UObject const* TemplateNULL
) 参数 说明 Outer 一个要设置为待创建对象的外部的UObject。 Name 一个要设置为新对象的 名称Name 的 FName。 Flags 可选。描述新对象的 FObjectFlags枚举值。 Template 可选。创建新对象时用作模板的 UObject。 Return Value 指向指定类的生成实例指针。
ConstructObject
为了获得完全的灵活性可以使用ConstructObject()函数创建UObjects的新实例。此函数调用StaticConstructObject()它分配对象执行ClassConstructor并执行任何初始化如加载配置属性加载本地化属性和实例化组件。
template class T
T* ConstructObject
(UClass* Class, UObject* Outer (UObject*)GetTransientPackage(), FName NameNAME_None, EObjectFlags SetFlagsRF_NoFlags, UObject const* TemplateNULL, bool bCopyTransientsFromClassDefaultsfalse, struct FObjectInstancingGraph* InstanceGraphNULL
) 参数 说明 Class 一个用于指定待创建对象的类的UClass。 Outer 可选。一个要设置为待创建对象的外部UObject。 Name 可选。一个要设置为新对象的名称Name的FName。 SetFlags 可选。描述新对象的EObjectFlags枚举值。 Template 可选。创建新对象时用作模板的UObject。 bCopyTransientsFromClassDefaults 可选。一个布尔值它决定是否从类默认对象而不是传入的原型指针复制瞬态属性。如果true使用类默认对象的瞬态。 FObjectInstancingGraph 可选。FObjectInstancingGraph结构体包含实例化对象和组件到其模板的映射。用于实例化新对象所拥有的组件。 Return Value 指向指定类的生成实例指针。 属性
属性声明
属性使用标准的C变量语法声明前面用UPROPERTY宏来定义属性元数据和变量说明符。
UPROPERTY([specifier, specifier, ...], [meta(keyvalue, keyvalue, ...)])
Type VariableName;
核心数据类型
整数
整数数据类型转换是int或uint后跟位大小。 变量类型 说明 uint8 8位无符号 uint16 16位无符号 uint32 32位无符号 uint64 64位无符号 int8 8位有符号 int16 16位有符号 int32 32位有符号 int64 64位有符号 作为位掩码
整数属性现在可以位掩码形式公开给编辑器。要将整数属性标记为位掩码只需在meta分段中添加bitmask即可如下所示
/*~ BasicBits appears as a list of generic flags in the editor, instead of an integer field. */
UPROPERTY(EditAnywhere, Meta (Bitmask))
int32 BasicBits;
