An?AssetReference?is a type that can reference an Addressable asset.

譯：AssetReference是一種可以引用Addressable資源的類型。

Use the AssetReference class in a MonoBehaviour or ScriptableObject. When you add a serializable AssetReference field to one of these classes, you can assign a value to the field in an Inspector window. You can restrict the assets that can be assigned to a field by type and by label.

譯：在MonoBehaviour或ScriptableObject中使用AssetReference類。當您在這些類中添加可序列化的AssetReference字段時，您可以在檢查器窗口中為該字段分配一個值。您可以通過類型和標簽限制可以分配給字段的資源。

To assign a value, drag an asset to the field or click on the object picker icon to open a dialog that lets you choose an Addressable asset.

譯：為了分配一個值，拖拽一個資源到字段中或者點擊對象選擇器圖標打開一個對話框，讓您選擇一個Addressable資源。

If you drag a non-Addressable asset to an AssetReference field, the system automatically makes the asset Addressable and adds it to your default Addressables group. Sprite and SpriteAtlas assets can have subobjects. AssetReferences assigned these types of asset display an additional object picker that allows you to specify which subobject to reference.

譯：如果您將一個非Addressable資源拖放到AssetReference字段中，系統(tǒng)會自動將該資源設(shè)置為Addressable并將其添加到您的默認Addressable組中。Sprite和SpriteAtlas資源可以有子對象。分配這些類型的AssetReference會顯示一個額外的對象選擇器，允許您指定要引用哪個子對象。

See the?Basic AssetReference,?Component Reference, and?Sprite Land?projects in the?Addressables-Sample?repository for examples of using AssetReferences in a project.

譯：請參見Addressables-Sample存儲庫中的Basic AssetReference、Component Reference和Sprite Land項目，以了解在項目中使用AssetReferences的示例。

IMPORTANT

To be able to assign assets from a group to an AssetReference field, the?Include GUID in Catalog?option must be enabled in the group’s Advanced Settings. The?Include GUID in Catalog?option is enabled by default.

譯：為了能夠?qū)⒔M中的資源分配給AssetReference字段，必須在組的高級設(shè)置中啟用“在目錄中包含GUID”選項。默認情況下，“在目錄中包含GUID”選項已啟用。

AssetReference types

The Addressables API provides?AssetReference?subclasses for common types of assets. You can use the generic subclass,?AssetReferenceT<TObject>, to restrict an AssetReference field to other asset types.

譯：AssetReference類型：Addressables API提供了常見類型資源的AssetReference子類。您可以使用通用子類AssetReferenceT<TObject>將AssetReference字段限制為其他類型的資源。

The types of AssetReference include:

譯：AssetReference類型包括：

• AssetReference: can reference any asset type譯：AssetReference：可以引用任何類型的資源。

• AssetReferenceT<TObject>: can reference assets that are the same type as?TObject譯：AssetReferenceT：可以引用與TObject類型相同的資源。

• AssetReferenceTexture: can reference a?Texture?asset譯：AssetReferenceTexture：可以引用紋理資源

• AssetReferenceTexture2D: can reference a?Texture2D?asset譯：AssetReferenceTexture2D：可以引用紋理2D資源

• AssetReferenceTexture3D: can reference a?Texture3D?asset譯：AssetReferenceTexture3D：可以引用紋理3D資源

• AssetReferenceGameObject: can reference a?Prefab?asset譯：AssetReferenceGameObject：可以引用預(yù)制件資源

• AssetReferenceAtlasedSprite: can reference a?SpriteAtlas?asset譯：AssetReferenceAtlasedSprite：可以引用SpriteAtlas資源

• AssetReferenceSprite: can reference a single?Sprite?asset譯：AssetReferenceSprite：可以引用單個Sprite資源

NOTE

If you want to use a?CustomPropertyDrawer?with a generic AssetReferenceT (or are using a version of Unity earlier than 2020.1), you must make a concrete subclass to support custom AssetReference types.

譯：如果您想要使用自定義屬性繪制器與通用的AssetReferenceT（或使用早于2020.1版本的Unity），則必須創(chuàng)建一個具體的子類來支持自定義AssetReference類型

Adding AssetReference fields to a class

Add an?AssetReference, or one of its subclasses, to a MonoBehaviour or ScriptableObject by declaring it as a serializable field to the class:

譯：在 MonoBehaviour 或 ScriptableObject 中添加 AssetReference 或其子類，可以通過將其聲明為該類的可序列化字段來實現(xiàn)：

NOTE

Before Unity 2020.1, the Inspector window couldn't display generic fields by default. In earlier versions of Unity, you must make your own non-generic subclass of AssetReferenceT instead. See?Creating a concrete subclass.

譯：在 Unity 2020.1 之前，檢查器窗口默認無法顯示通用字段。在早期版本的 Unity 中，您必須創(chuàng)建自己的非通用 AssetReferenceT 子類。請參閱創(chuàng)建具體子類。

Loading and releasing AssetReferences

The?AssetReference?class provides its own methods to load, instantiate, and release a referenced asset. You can also use an AssetReference instance as a key to any?Addressables?class method that loads assets.

譯：AssetReference 類提供了自己的方法來加載、實例化和釋放引用的資源。您還可以使用 AssetReference 實例作為任何 Addressables 類方法加載資源的鍵。

The following example instantiates an AssetReference as a child of the current GameObject and releases it when the parent is destroyed:

譯：以下示例將 AssetReference 實例實例化為當前 GameObject 的子對象，并在父對象被銷毀時釋放它：

See?Loading an AssetReference?for more information and examples about loading assets using AssetReferences.

譯：有關(guān)使用 AssetReferences 加載資源的更多信息和示例，請參閱加載 AssetReference。

Restricting AssetReference assignment to assets with specific labels

Use the?AssetReferenceUILabelRestriction?attribute to restrict the assets you can assign to an?AssetReference?field to those with specific labels. You can use this attribute reference in addition to AssetReference subclasses to restrict assignment by both type and label.

譯：使用 AssetReferenceUILabelRestriction 屬性將可以分配給 AssetReference 字段的資源限制為具有特定標簽的資源。您可以將此屬性引用與 AssetReference 子類一起使用，以通過類型和標簽限制分配。

The following example prevents someone from assigning an Addressable asset to a reference that does not have either the label, "animals", or the label, "characters":

譯：以下示例防止將 Addressable 資源分配給沒有標簽“animals”或標簽“characters”的引用：

NOTE

• The attribute only prevents assigning assets without the specified label using an Inspector in the Unity Editor. Someone could still assign an asset without the label to the field using a script.譯：該屬性僅使用 Unity 編輯器中的檢查器防止分配未指定標簽的資產(chǎn)。某些人仍然可以使用腳本將沒有標簽的資產(chǎn)分配給該字段。

• You cannot drag non-Addressable assets to a field with the?AssetReferenceUILabelRestriction?attribute.譯：您無法將非 Addressable 資產(chǎn)拖動到具有 AssetReferenceUILabelRestriction 屬性的字段中。

Creating a concrete subclass

For those cases in which you cannot use the generic form of the?AssetReference?class directly (in versions of Unity prior to Unity 202.1 or when using the?CustomPropertyDrawer?attribute), you can create a concrete subclass.

譯：在無法直接使用 AssetReference 類的通用形式（在 Unity 版本低于 Unity 202.1 或使用 CustomPropertyDrawer 屬性時）的情況下，您可以創(chuàng)建具體子類。

To create a concrete subclass, inherit from the?AssetReferenceT?class and specify the asset type. You must also pass the GUID string to the base class constructor:

譯：要創(chuàng)建具體子類，請繼承 AssetReferenceT 類并指定資產(chǎn)類型。您還必須將 GUID 字符串傳遞給基類構(gòu)造函數(shù)：

You can use your custom AssetReference subclass in another script the same way as other AssetReference types:

譯：您可以像其他 AssetReference 類型一樣在另一個腳本中使用自定義 AssetReference 子類：