使用Datasmith元数据

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

对于上述返回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） 类别下。 

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

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

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

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

如需有关蓝图Map节点的更多信息，请参阅蓝图API参考。

使用范例

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

使用包含两个文本域的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