使用Datasmith元数据

所需节点位于 Datasmith > 场景（Scene） 和 Datasmith >元素（Element） 下。

节点	说明
获取所有元数据	获取Datasmith场景中所有对象记录的全部元数据对象数组。
获取键的所有对象和值	获取Datasmith场景中具有指定键的所有对象列表。还可获得此类对象中该键记录的所有值列表。
获取对象的元数据	获取指定到指定对象的所有元数据。
获取键的元数据值	获取指定到指定对象的指定键值。
获取值的元数据键和值	获取指定对象上，值与 String to Match 输入匹配的所有键。

对于上述返回Datasmith元数据元素对象的节点，可使用 Datasmith > 元素（Element）> 获取属性（Get Properties）、获取属性（Get Property） 和 获取属性数（Get Property Count），在元数据对象中获取键和值：

使用范例

本范例将展示使用指定到元数据键的值，识别项目中无需的几何体，并在创建其静态网格体资源前，将其从Datasmith场景中删除的方法：

Datasmith导入流程期间，可通过 unreal.DatasmithSceneElement 对象，获取场景对象的相关元数据。欲了解以下函数的详情，参见Python API参考。

使用范例

本范例将展示使用指定到元数据键的值，识别项目中无需的几何体，并在创建其静态网格体资源前，将其从Datasmith场景中删除的方法：

	
	
		key_name = "name"
		remove_keyword = "Clutch"
		meshes_to_skip = set([])
		# 获取所有具有"name"键的场景元素。
		objects_and_values = ds_scene_in_memory.get_all_objects_and_values_for_key(key_name, unreal.DatasmithMeshActorElement)
		objects = objects_and_values[0]
		values = objects_and_values[1]
		# 进行迭代，寻找值与关键字匹配的对象
		for index, value in enumerate(values):
			if remove_keyword in value:
				print("removing actor named:" + value)
				# 从场景中删除网格体Actor元素，并将网格体元素放入列表以便稍后删除
				mesh_actor = objects[index]
				mesh = mesh_actor.get_mesh_element()
				meshes_to_skip.add(mesh)
				ds_scene_in_memory.remove_mesh_actor(mesh_actor)
		# 删除所有无需导入的网格体。
		for mesh in meshes_to_skip:
			mesh_name = mesh.get_element_name()
			print("removing mesh named " + mesh_name)
			ds_scene_in_memory.remove_mesh(mesh)
	
	
Copy full snippet

以下节点会访问一个特定Actor的元数据。其对性能的影响较小，因此可随时（甚至项目中运行时）使用此类节点。若要可视化场景中一个或多个选定对象的导入元数据（例如，项目运行时UI中的注记或菜单内），可在运行时蓝图图表中使用以下节点。

此类节点位于 Datasmith用户数据（Datasmith User Data） 类别下。 

节点	说明
获取键的Datasmith用户数据值	使用指定到指定对象的指定键，获取元数据的值。
获取值的Datasmith用户数据键和值	获取指定对象上，包含String to Match 输入中指定值的所有键。已知要查找的 值，但不知键命名时，可使用此节点。
获取Datasmith用户数据	获取包含Actor记录的 所有 键值对的元数据对象，以便之后进行迭代。

相反，以下节点可访问当前关卡中所有静态网格体Actor（或共享给定类的静态网格体Actor）的元数据。由于关卡可能包含大量具有诸多属性的Actor，若在运行时游戏进程中使用此类函数时，会导致CPU资源开销较高，且性能较差。因此，仅可在纯编辑器蓝图类上创建的图表中使用此类节点。

此类节点位于 编辑器脚本（Editor Scripting）> Datasmith用户数据（Datasmith User Data） 类别下。

节点	说明
获取键的所有对象和值	获取当前关卡中，在Datasmith元数据内具有指定键的所有Actor列表。还可获得此类对象中该键记录的所有值列表。
获取所有Datasmith用户数据	获取当前关卡中所有Actor的全部元数据对象完整列表。

上述 Get Datasmith User Data 和 Get All Datasmith User Data 节点返回Datasmith用户数据对象参考。该对象拥有一个名为Metadata的可访问变量，其是组成对象Datasmith元数据的所有键值对的Map。要使用此类对象，从输出引脚连出引线，并选择 变量（Variables）> Get Metadata：

此操作将以Map形式提供键和值。然后可使用 工具（Utilities）> Map 类别中的工具节点使用数据。例如，此图表对所有键进行逐个迭代，并获取各键关联的值：

欲了解在蓝图中使用Map的更多详情，参见蓝图Map。

使用范例

本章节将展示简化范例，对在运行时可视化关卡中玩家选定对象的资源元数据的方法进行讲解。

使用包含两个文本域的UMG控件编写文本，各文本域与字符串变量绑定。在控件的蓝图图表中，自定义操作从传入自定义事件的Actor中提取Datasmith元数据的两个项目，并将此类项目保存到绑定变量。

以下关卡蓝图将展示范例，对开始运行时添加此类控件，及用户按下鼠标键时使用光标下的Actor进行填充的方法进行讲解。

欲了解在UMG中编译用户界面的更多详情，参见UMG UI设计器快速入门和相关章节。

完成Datasmith导入流程后，可使用 unreal.DatasmithContentLibrary 类访问所有Actor或选定Actor的元数据。欲了解以下函数，参见Python API参考。

使用范例

在虚幻编辑器内运行的Python脚本中，可在导入后使用Datasmith元数据，辨识关卡中要应用部分特殊流程的静态网格体Actor。

	
	
		import unreal
		new_actor_name = "Exterior Walls"
		metadata_key = "Type"
		metadata_value = "Wall:Exterior"
		meshes_to_join = set([])
		# 迭代当前关卡中的Actor
		all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
		for actor in all_actors:
			# 获取该Actor的上述键Datasmith元数据值（如有）
			actor_value = unreal.DatasmithContentLibrary.get_datasmith_user_data_value_for_key(actor, metadata_key)
			# 如键存在，且其值包含上述关键字，将Actor添加到列表
			if actor_value and metadata_value in actor_value:
				print("found a matching actor:" + actor_value)
				meshes_to_join.add(actor)
		# 将之前找到的所有Actor放入具有诸多组件的单个Actor
		options = unreal.EditorScriptingJoinStaticMeshActorsOptions(destroy_source_actors=True, new_actor_label=new_actor_name, rename_components_from_source=True)
		unreal.EditorLevelLibrary.join_static_mesh_actors(meshes_to_join, options)
		print "Merged all actors!"
	
	
Copy full snippet