Struct providing an API for stable, project-global object identifiers.
Provides a project-global object ID for lookup.
The ID is persistent and unique for a given Unity Object.
The format of the string representation of the ID is "GlobalObjectId_V1-{i}-{a}-{l}-{p}" where:
{i} is the identifier type represented by an integer (0 = Null, 1 = Imported Asset, 2 = Scene Object, 3 = Source Asset).
{a} is the asset GUID.
{l} is the local file ID of the object.
{p} is the prefab instance ID of the object.
The default null ID is "GlobalObjectId_V1-0-00000000000000000000000000000000-0-0".
Caveats:
- The ID changes when the object is moved to a new scene because the scene ID is part of the GlobalObjectID.
assetGUID | The GUID for the asset to which this object belongs. |
identifierType | The identifier type represented as an integer. |
targetObjectId | The local file ID of the object. |
targetPrefabId | The prefab instance id of the object. |
Equals | Check equality between two GlobalObjectIds. |
ToString | Get the string representation of the GlobalObjectId. |
GetGlobalObjectIdSlow | Converts an Object reference to a GlobalObjectId. |
GetGlobalObjectIdsSlow | Creates an array of GlobalObjectIds based on an array of Objects. |
GlobalObjectIdentifiersToObjectsSlow | Creates an array of Objects based on an array of GlobalObjectIds. |
GlobalObjectIdentifierToObjectSlow | Converts a GlobalObjectId to an Object reference. |
TryParse | Parses the string representation of a GlobalObjectId into a GlobalObjectId struct. |