Version: 2023.1

PrefabUtility.GetPrefabInstanceHandle

切换到手册
public static Object GetPrefabInstanceHandle (Object instanceComponentOrGameObject);

参数

instanceComponentOrGameObject 预制件实例的对象。

返回

Object 预制件实例句柄。

描述

Retrieves the PrefabInstance object for the outermost Prefab instance the provided object is part of.

如果提供的对象不是预制件实例的一部分,则该函数返回 null。

可以通过比较对象来检查两个不同的游戏对象或组件是不是同一个预制件实例的一部分。不能将该方法用于对比预制件实例与作为其一部分的嵌套预制件,因为该方法返回对象所属的最外层预制件实例的句柄。不过,可以将该方法用来对比添加的子预制件实例及其添加到的父预制件实例,因为添加的对象不是它添加到的预制件实例的一部分。

该方法适用于场景中的预制件实例以及预制件资源中的预制件实例。如果该方法为预制件资源内的对象返回有效的预制件实例句柄,则表示该对象是预制件实例(该预制件实例是资源内的嵌套预制件,或者是预制件变体的基础预制件实例)的一部分。