Addressables简单使用指南 Addressables Manual

异步加载

资源地址就是在Addressables Groups里看到的具体资源的地址，只要给定地址就能找到需要的资源

使用地址加载

// 参数为资源地址，包含后缀.prefab，handle.Result就是实例化的物体，而不是prefab
Addressables.InstantiateAsync("address of prefab");
// 参数为资源地址，包含资源后缀名
Addressables.LoadAssetAsync("address of asset");

使用直接资源引用AssetReference加载

AssetReference asset;
// 参数为资源地址，包含后缀.prefab
Addressables.InstantiateAsync(asset);
// 参数为资源地址，包含资源后缀名
Addressables.LoadAssetAsync(asset);

异步回调

匿名委托

Addressables.InstantiateAsync($"address of prefab").Completed += (handle) =>
{
    if (handle.Status == UnityEngine.ResourceManagement.AsyncOperations.AsyncOperationStatus.Succeeded)
    {
        var obj = handle.Result;
    }
}

回调函数

Addressables.InstantiateAsync($"address of prefab").Completed += OnCompleted;
private void OnCompleted(AsyncOperationHandle<SceneInstance> handle)
{
    if (handle.Status == UnityEngine.ResourceManagement.AsyncOperations.AsyncOperationStatus.Succeeded)
    {
        var obj = handle.Result;
    }
}

async

public static async void PlaySoundEffect(AssetReference audioClipAsset)
{
    var handle = audioClipAsset.LoadAssetAsync<AudioClip>();
    await handle.Task;
    if (handle.Status == AsyncOperationStatus.Succeeded)
    {
        var audioClip = handle.Result;
    }
}

async Task

private async static Task<T> LoadAssetAsync<T>() where T : Object
{
    var path = "address of prefab";
    var handle = Addressables.LoadAssetAsync<T>(path);
    await handle.Task;
    if (handle.Status == UnityEngine.ResourceManagement.AsyncOperations.AsyncOperationStatus.Succeeded)
    {
        return handle.Result;
    }
    return null;
}

public static async Task<T> InstantiateAssetAsync<T>() where T : Object
{
    var obj = await LoadAssetAsync<T>();
}

协程

public IEnumerator Start() {
    AsyncOperationHandle<Texture2D> handle = Addressables.LoadAssetAsync<Texture2D>("mytexture");
    yield return handle;
    if (handle.Status == AsyncOperationStatus.Succeeded) {
        Texture2D texture = handle.Result;
        // The texture is ready for use.
        // ...
    // Release the asset after its use:
        Addressables.Release(handle);
    }
}

同步加载

Unity Github Addressables
if can not find, go to Unity github repository and find the repository named addresables-sample

本地打包流程

• 在AddressableAssetsData/AssetGroups下找到对应Group的配置，这里可以查看到Build Path的本地路径。
• 根据需要修改Advanced Options -> Bundle Mode
  • Pack Together：每个Group中，除了场景之外的资源，打成一个包，场景另外打一个包
  • Pack Separately：每个Group中的Entry分别打一个包，Entry即Group下的各个目录
  • Pack Together By Label：相同Label打一个包
• 手动打包：Addressables Group界面下，Build -> New Build -> Default Build Script
• 主菜单File -> Build Settings -> Build

AssetReference filter 过滤器

如果在Addressables Group界面里以文件夹为单位创建Entry，那么Inspector下的AssetReference打开的过滤器中会看到很多可选的

筛选指定类型的asset

[Serializable]
public class AssetReferenceSceneAsset : AssetReferenceT<SceneAsset>
{
    public AssetReferenceSceneAsset(string guid) : base(guid) { }
}

SceneAsset可换成其他资源类型，具体可通过在Project窗口右键Create，弹出的类型都是资源类型

筛选Component

ComponentReference.cs

using UnityEngine;
using UnityEngine.AddressableAssets;
using UnityEngine.ResourceManagement.AsyncOperations;
#if UNITY_EDITOR
using UnityEditor;
#endif

public class ComponentReference<TComponent> : AssetReference where TComponent : Component
{
    public ComponentReference(string guid) : base(guid)
    {
    }
    
    public new AsyncOperationHandle<TComponent> InstantiateAsync(Vector3 position, Quaternion rotation, Transform parent = null)
    {
        return Addressables.ResourceManager.CreateChainOperation<TComponent, GameObject>(base.InstantiateAsync(position, Quaternion.identity, parent), GameObjectReady);
    }
   
    public new AsyncOperationHandle<TComponent> InstantiateAsync(Transform parent = null, bool instantiateInWorldSpace = false)
    {
        return Addressables.ResourceManager.CreateChainOperation<TComponent, GameObject>(base.InstantiateAsync(parent, instantiateInWorldSpace), GameObjectReady);
    }
    public AsyncOperationHandle<TComponent> LoadAssetAsync()
    {
        return Addressables.ResourceManager.CreateChainOperation<TComponent, GameObject>(base.LoadAssetAsync<GameObject>(), GameObjectReady);
    }

    AsyncOperationHandle<TComponent> GameObjectReady(AsyncOperationHandle<GameObject> arg)
    {
        var comp = arg.Result.GetComponent<TComponent>();
        return Addressables.ResourceManager.CreateCompletedOperation<TComponent>(comp, string.Empty);
    }

    public override bool ValidateAsset(Object obj)
    {
        var go = obj as GameObject;
        return go != null && go.GetComponent<TComponent>() != null;
    }
    
    public override bool ValidateAsset(string path)
    {
#if UNITY_EDITOR
        //this load can be expensive...
        var go = AssetDatabase.LoadAssetAtPath<GameObject>(path);
        return go != null && go.GetComponent<TComponent>() != null;
#else
            return false;
#endif
    }

    public void ReleaseInstance(AsyncOperationHandle<TComponent> op)
    {
        // Release the instance
        var component = op.Result as Component;
        if (component != null)
        {
            Addressables.ReleaseInstance(component.gameObject);
        }

        // Release the handle
        Addressables.Release(op);
    }

}

[Serializable]
public class ComponentReferenceYourComponent : ComponentReference<YourComponent>
{
    public ComponentReferenceYourComponent(string guid)
        : base(guid) { }
}

YourComponent为你的继承自Component的脚本组件

找不到Sprite资源的BUG

Addressables.LoadAssetAsync("folder/sprite.png");

假设你的sprite在Addressables中的地址为folder/sprite.png
当使用版本大于1.3.8的Addressables时，在使用非Use Exsisting Build的模式时，无法找到资源。
但当你的sprite的地址为sprite.png，不带任何父目录时，则不会出现以上问题。

正确的使用方法

• 使用版本1.3.8（或者更低版本，目前1.3.8 < 版本 <= 1.7.4的均存在该BUG）

• Addressables.LoadAssetAsync("folder/sprite.png[sprite]");
  // 对于sprite atlas中只有一个sprite的情形，最后的[sprite]是可以省略的，以下代码也有效
  Addressables.LoadAssetAsync("folder/sprite.png");
  // 对于sprite atlas中有多个sprite的情形，最后的[sprite_0]不能省略，[sprite_0]为sprite atlas中的目标sprite名称
  Addressables.LoadAssetAsync("folder/sprite.png[sprite_0]");
  

参考

addressables sample unity official github