知名网站名称,wordpress原生封装app,商丘seo教程,做网站需不需要云数据库Unreal Engine 中 Actor 数据的 JSON 序列化
在游戏开发过程中#xff0c;经常需要将游戏世界中的实体#xff08;Actors#xff09;信息导出到其他格式以便于分析、存储或交互。在Unreal Engine中#xff0c;我们可以通过序列化这些实体的数据为JSON格式来实现这一目的。…Unreal Engine 中 Actor 数据的 JSON 序列化
在游戏开发过程中经常需要将游戏世界中的实体Actors信息导出到其他格式以便于分析、存储或交互。在Unreal Engine中我们可以通过序列化这些实体的数据为JSON格式来实现这一目的。以下是在Unreal Engine项目中实现Actor数据序列化为JSON对象的技术细节概述。
FActorData 结构体
FActorData结构体用于存储Actor的相关信息包括名称、ID、类型、标签、用户数据以及子Actor信息。此结构体还包含一个方法ToJsonObject用于将FActorData实例转换为JSON对象。
struct FActorData
{FString Name;FString ID;//...TSharedPtrFJsonObject ToJsonObject() const;// 其他成员和方法的定义...
};
ToJsonObject方法将FActorData的每个字段转换为JSON格式并处理子Actor数据的递归序列化。
CreateActorData 函数
CreateActorData函数用于提取给定Actor的数据并将其封装在FActorData结构体中。该函数检查Actor的标签以确定其类型并递归收集子Actor的数据。
FActorData CreateActorData(AActor* Actor);
在实现中如果Actor的标签包含Thing则将类型设置为Thing否则使用Actor的类名作为类型。此外该函数还会收集Actor的标签和用户数据这些数据由UUnrealUtils::GetUserData提供假设该函数返回TMapFString, FString类型的数据。
ParseWorldActorsToJson 函数
ParseWorldActorsToJson函数遍历Unreal Engine世界中的所有Actors使用CreateActorData函数为每个Actor创建FActorData实例并将这些实例序列化为JSON数组。
TArrayTSharedPtrFJsonValue ParseWorldActorsToJson(UWorld* World);
该函数假设传入的UWorld对象是有效的并且所有Actors都已经加载到世界中。它返回一个JSON值数组每个值都是一个表示Actor数据的JSON对象。
技术细节
在Unreal Engine中将Actor数据序列化为JSON涉及到几个关键步骤包括定义数据结构、提取Actor信息、转换为JSON格式以及处理复杂数据类型。以下是这些步骤的详细说明和相关代码示例。
1. 定义数据结构FActorData
FActorData结构体用于表示Actor的数据模型。它包含了Actor的名称、唯一标识符、类型、标签列表、用户自定义数据以及子Actor的列表。
struct FActorData
{FString Name;FString ID;FString Type;TArrayFString Tags;TMapFString, FString UserData;TArrayFActorData Children;// ... 其他成员和方法的定义 ...
};
2. 提取Actor信息CreateActorData
CreateActorData函数负责遍历Actor及其子Actor提取相关信息并填充到FActorData结构体实例中。这个过程包括检查Actor的标签来确定其类型并收集用户自定义数据。
FActorData CreateActorData(AActor* Actor)
{FActorData Data;if (Actor ! nullptr){Data.Name Actor-GetActorLabel();Data.ID Actor-GetName();// ... 标签检查和类型确定的逻辑 ...Data.UserData UUnrealUtils::GetUserData(Actor);// ... 收集子Actor数据的逻辑 ...}return Data;
}
3. 转换为JSON格式ToJsonObject
ToJsonObject方法负责将FActorData实例转换为JSON对象。它使用Unreal Engine的JSON API来创建和填充JSON对象。
TSharedPtrFJsonObject FActorData::ToJsonObject() const
{TSharedPtrFJsonObject JsonObject MakeShareable(new FJsonObject);// ... 设置基本字段 ...// 序列化UserData为JSON对象TSharedPtrFJsonObject JsonUserData MakeShareable(new FJsonObject);for (const auto Elem : UserData){JsonUserData-SetStringField(Elem.Key, Elem.Value);}JsonObject-SetObjectField(TEXT(UserData), JsonUserData);// ... 序列化子Actor ...return JsonObject;
}
4. 处理复杂数据类型
在FActorData中UserData字段是一个TMapFString, FString类型它需要特殊处理来转换为JSON对象。同样子Actor列表也需要递归地转换为JSON数组。
// 序列化UserData为JSON对象
TSharedPtrFJsonObject JsonUserData MakeShareable(new FJsonObject);
for (const auto Elem : UserData)
{JsonUserData-SetStringField(Elem.Key, Elem.Value);
}
JsonObject-SetObjectField(TEXT(UserData), JsonUserData);// 序列化子Actor为JSON数组
TArrayTSharedPtrFJsonValue JsonChildren;
for (const FActorData ChildData : Children)
{JsonChildren.Add(MakeShareable(new FJsonValueObject(ChildData.ToJsonObject())));
}
JsonObject-SetArrayField(TEXT(Children), JsonChildren);
结论
通过以上步骤我们可以将Unreal Engine中的Actor数据序列化为JSON格式。这个过程不仅包括基本类型的转换还涉及到复杂数据类型的处理如映射和数组。最终我们能够生成一个完整的JSON对象它准确地反映了Actor的状态和属性可以用于数据存储、分析或与外部系统的交互
