Version: 2023.2

PrefabUtility.ApplyAddedComponent

切换到手册
public static void ApplyAddedComponent (Component component, string assetPath, InteractionMode action);

参数

action 此操作的交互模式。
assetPath 要应用到的预制件资源的路径。
component 要应用的预制件实例上添加的组件。

描述

将添加的组件应用于给定资源路径上的预制件资源。

此方法允许您将添加的组件应用于现有的预制件。它对应了编辑器中的功能(如此处的用户手册中所述)。要使用此方法,必须首先将组件添加到现有的预制件实例。

添加的组件是一种类型的实例重载。将添加的组件应用到预制件的行为意味着该组件成为预制件资源的一部分,并且不再是对预制件实例的重载。

将添加的组件应用于预制件资源时,必须提供资源路径作为参数。这是因为在某些情况下,可能将此更改应用于多个目标。例如,如果添加的组件已经添加到属于嵌套预制件的游戏对象中,可选择将更改应用到内部嵌套的预制件资源,还是应用到外部根预制件资源。因此,通过指定资源路径,可让 Unity 明确知晓此更改必须应用于哪个预制件资源。

用户手册中介绍了有关选择应用目标的更多信息。

Additional resources: PrefabUtility.ApplyAddedGameObject, PrefabUtility.ApplyObjectOverride, PrefabUtility.ApplyPropertyOverride, PrefabUtility.ApplyRemovedComponent, PrefabUtility.ApplyPrefabInstance, PrefabUtility.ApplyRemovedGameObject.