PrefabUtility.ApplyRemovedGameObject

参数

描述

从源预制资源中移除 GameObject。

当 GameObject 从预制实例中移除后，该修改是 实例覆盖 的一种类型。将更改（移除 GameObject）应用于预制的方式表示从预制资源本身移除 GameObject 及其组件和 GameObject 子项，并且不再是预制实例上的覆盖项。

将移除的 GameObject 应用到预制资源时，必须将资源路径作为参数提供。这是因为有些情况下，有多个可应用于更改的可能目标。例如，如果 GameObject 是从 嵌套预制 实例的一部分的 GameObject 移除的，则可以选择将更改应用于内部嵌套预制资源或外部根预制资源。因此，通过指定资源路径，向 Unity 明确说明必须将更改应用于哪个预制资源。反映 此处用户手册 中描述的编辑器功能。

可在用户手册中了解更多关于 应用目标的选择 的信息。

其他资源：PrefabUtility.ApplyAddedComponent、PrefabUtility.ApplyAddedGameObject、PrefabUtility.ApplyObjectOverride、PrefabUtility.ApplyPrefabInstance、PrefabUtility.ApplyPropertyOverride、PrefabUtility.ApplyRemovedComponent。

using System.Collections.Generic;
using System.IO;
using UnityEditor;
using UnityEditor.SceneManagement;
using UnityEngine;

// Creates new menu items under 'Examples' in the main menu.
public class ApplyRemovedGameObjectExample
{
    [MenuItem("Examples/ApplyRemovedGameObject Example 1")]
    static void CreatePrefabAndApplyChanges()
    {
        //Ensure the existence of a Prefabs folder inside the Assets folder
        if (!Directory.Exists("Assets/Prefabs"))
            AssetDatabase.CreateFolder("Assets", "Prefabs");

        //Setup hierarchy with root and one child
        GameObject rootGameObject = new GameObject("Root");
        GameObject child = new GameObject("Child");
        child.transform.parent = rootGameObject.transform;

        //Create prefab based on the GameObject hierarchy we just created
        GameObject prefabAsset = PrefabUtility.SaveAsPrefabAssetAndConnect(rootGameObject, "Assets/Prefabs/" + rootGameObject.name + ".prefab", InteractionMode.AutomatedAction);

        //Get the corresponding object matching the Child GameObject that was destroyed
        GameObject correspondingChildGameObject = prefabAsset.transform.GetChild(0).gameObject;

        //Destroy child GameObject so we can apply the override to the Prefab
        Object.DestroyImmediate(child);

        //Use the variables from above to apply the removed GameObject override to the Prefab asset
        PrefabUtility.ApplyRemovedGameObject(rootGameObject, correspondingChildGameObject, InteractionMode.AutomatedAction);

        if (prefabAsset.transform.childCount == 0)
            Debug.Log("'Child' GameObject was removed and the override was applied to the Prefab successfully.");
        else
            Debug.Log("The override was not applied successfully");
    }

    [MenuItem("Examples/ApplyRemovedGameObject Example 2")]
    static void CreatePrefabAndApplyChangesWithGetRemovedGameObjects()
    {
        //Ensure the existence of a Prefabs folder inside the Assets folder
        if (!Directory.Exists("Assets/Prefabs"))
            AssetDatabase.CreateFolder("Assets", "Prefabs");

        //Setup hierarchy with root and one child
        GameObject rootGameObject = new GameObject("Root");
        GameObject child = new GameObject("Child");
        child.transform.parent = rootGameObject.transform;

        //Create prefab based on the GameObject hierarchy we just created
        GameObject prefabAsset = PrefabUtility.SaveAsPrefabAssetAndConnect(rootGameObject, "Assets/Prefabs/" + rootGameObject.name + ".prefab", InteractionMode.AutomatedAction);

        //Destroy child GameObject so we can apply the override to the Prefab
        Object.DestroyImmediate(child);

        //Get the override and the information to apply the changes to the Prefab asset
        List<RemovedGameObject> removedGameObjects = PrefabUtility.GetRemovedGameObjects(rootGameObject);
        GameObject assetGameObject = removedGameObjects[0].assetGameObject;
        GameObject parentOfRemovedGameObjectInInstance = removedGameObjects[0].parentOfRemovedGameObjectInInstance;

        //Use the variables from above to apply the removed GameObject override to the Prefab
        PrefabUtility.ApplyRemovedGameObject(parentOfRemovedGameObjectInInstance, assetGameObject, InteractionMode.AutomatedAction);

        if (prefabAsset.transform.childCount == 0)
            Debug.Log("'Child' GameObject was removed and the override was applied to the Prefab successfully.");
        else
            Debug.Log("The override was not applied successfully");
    }
}