LibGDX_7.3: 资源管理器（AssetManager）

痛定思痛。 2021-09-22 04:40 349阅读 0赞

本文链接: [http://blog.csdn.net/xietansheng/article/details/50188131][http_blog.csdn.net_xietansheng_article_details_50188131]

[LibGDX 基础教程（总目录）][LibGDX]

本篇部分参考自官方wiki： [https://github.com/libgdx/libgdx/wiki/Managing-your-assets][https_github.com_libgdx_libgdx_wiki_Managing-your-assets]

## **1. 资源管理器（AssetManager）概述** ##

资源管理器（AssetManager）主要负责统一加载和管理 纹理（Texture）、纹理图集（TextureAtlas）、位图字体（BitmapFont）、音乐（Music）、音效（Sound） 等 assets 文件夹中的资源。

## **2. 为什么要使用 AssetManager** ##

如果你的游戏非常简单，加载资源不需要很多时间，那么你可以选择不使用 AssetManager，在其他任何情况下都建议使用它。使用 AssetManager 的好处如下所示：

*  所有资源的加载采用异步加载方式，不阻塞渲染线程，因此在加载资源时可以显示一个正在加载数据的场景（在场景中可使用进度条实时显示加载进度）。
 *  AssetManager 对资源使用引用计数。如果 资源A 和 资源B 同时依赖于 资源C，那么 资源C 只有在 资源A 和 资源B 都被释放时才释放。这也就意味着如果同一个资源被加载多次，实际上在内存中只会存在一份实例被共享使用。
 *  在同一个地方存储所有的资源。
 *  可以透明地实现像缓存一样的事物。

## **3. 创建一个 AssetManager** ##

创建 AssetManager 实例非常简单，直接 new 创建即可：

AssetManager manager = new AssetManager();

这里创建了一个标准的资源管理器，并同时存储所有类型的资源加载器。

**注意：** AssetManager 和 其他所有的资源（例如 Texture 等）的实例 **不能被静态变量引用** ，除非你能够很好的管理它们。比如下面的代码将可能会引起问题：

public static AssetManager assets = new AssetManager();

这在 Android 平台将会导致问题，因为静态变量的生命周期和 LibGDX 应用的生命周期不能保证一定相同。因此你的一个 LibGDX 应用实例提供的 AssetManager 实例有可能会被下一个 LibGDX 应用实例使用，而加载过的资源却不再有效。这通常会导致黑块/缺失的纹理或错误的资源。

在 Android 平台中，甚至会导致同一时间在你的 Activity 中有多个 LibGDX 应用实例被激活，所以即使你妥善处理了生命周期方法也不要认为你是安全的！（See [this StackOverflow question][] for details.）

## **4. 加载 assets 资源** ##

加载资源时，资源管理器需要知道如何去加载一个明确类型的资源，这个功能通过 AssetLoader（资源加载器）来实现。AssetLoader 是一个抽象类，它有两个实现，分别是 SynchronousAssetLoader（同步资源加载器） 和 AsynchronousAssetLoader（异步资源加载器），前者在渲染线程直接加载，后者在另外的一个线程中加载。

具体资源类型的加载器定义在 com.badlogic.gdx.assets.loaders 包中，下面列出 AssetManager 默认支持加载的部分资源：

*  Texture
 *  BitmapFont
 *  TextureAtlas
 *  Music
 *  Sound
 *  Pixmap
 *  ParticleEffect
 *  Skin
 *  I18NBundle
 *  **…**

加载一个指定类型的资源非常简单：

manager.load("data/mytexture.png", Texture.class);
    manager.load("data/myfont.fnt", BitmapFont.class);
    manager.load("data/mymusic.ogg", Music.class);

调用 load 方法会将资源的加载加入到一个待加载的队列中，然后按照 load 的顺序依次加载。

把所有需要加载的资源都添加到队列后，可以调用下面的方法实时获取加载进度：

// 返回加载进度的百分比
    float percent = manager.getProgress();

## **5. 获取已加载的资源** ##

根据文件名称和指定的类型获取加载后的资源实例：

Texture tex = manager.get("data/mytexture.png", Texture.class);
    BitmapFont font = manager.get("data/myfont.fnt", BitmapFont.class);

资源实例必须要加载完毕之后才能获取，可以使用下面方法判读是否加载完毕：

boolean texIsLoaded = manager.isLoaded("data/mytexture.png");
    boolean fontIsLoaded = manager.isLoaded("data/myfont.fnt");

也可以在资源全部 load 到队列后，调用下面的等待加载完毕的方法，方法执行完再获取资源：

// 调用这个方法将阻塞线程, 直到待加载队列中的所有资源都加载完毕
    manager.finishLoading();

## **6. 释放资源** ##

通过 AssetManager 加载的资源，不再需要使用到某个资源，要对资源进行释放时，通常不调用资源对象本身的 dispose() 方法进行释放，而是统一由 AssetManager 中的方法进行释放。

释放单个资源：

manager.unload("data/myfont.fnt");

释放所有资源（包括已加载完毕的和已在待加载队列中的）：

manager.clear();

释放所有资源（包括已加载完毕的和已在待加载队列中的），并销毁资源管理器（不再需要用到资源管理器时也必须手动销毁）：

manager.dispose();

## **7. 恢复加载场景** ##

在 Android 平台，应用可以被暂停（paused）和恢复（resumed），在这种情况下，管理的像纹理这样的 OpenGL 资源会重新加载，恢复时可能需要一些时间。如果你想在恢复时显示一个正在加载的场景，当创建好一个 AssetManager 后可以做下面这样的设置：

Texture.setAssetManager(manager);

然后在 ApplicationListener.resume() 生命周期方法中切换到正在加载的场景，并且再一次调用 AssetManager.update() 方法直到一切恢复正常。

如果你没有做 Texture.setAssetManager(manager) 的操作，通常纹理的管理机制会发挥作用自动处理，所以你不需要担心任何事情。

## **8. 代码示例: AssetManager 在代码中的使用** ##

为了方便演示不再引入资源，这里只演示前面章节中常用的两张图片（**badlogic.jpg** 和 **logo.png**，直接放到 assets 文件夹下）的加载。

package com.libgdx.test;
    
    import com.badlogic.gdx.ApplicationAdapter;
    import com.badlogic.gdx.Gdx;
    import com.badlogic.gdx.assets.AssetManager;
    import com.badlogic.gdx.graphics.GL20;
    import com.badlogic.gdx.graphics.Texture;
    import com.badlogic.gdx.graphics.g2d.SpriteBatch;
    
    /** * 游戏主程序的启动入口类 */
    public class MainGame extends ApplicationAdapter { 
    
        // 资源在 assets 文件夹中的相对路径
        private static final String BADLOGIC = "badlogic.jpg";
        private static final String LOGO = "logo.png";
    
        private SpriteBatch batch;
    	
    	private AssetManager manager;
    
        private Texture badlogicTexture;
        private Texture logoTexture;
    
    	@Override
    	public void create() { 
            batch = new SpriteBatch();
    
    		// 创建资源管理器
    		manager = new AssetManager();
    
            // 加载资源
            manager.load(BADLOGIC, Texture.class);
            manager.load(LOGO, Texture.class);
    
            // 阻塞线程, 等待资源加载完毕
            manager.finishLoading();
    
            // 加载完毕后获取资源实例
            badlogicTexture = manager.get(BADLOGIC, Texture.class);
            logoTexture = manager.get(LOGO, Texture.class);
    	}
    
    	@Override
    	public void render() { 
    		// 白色清屏
    		Gdx.gl.glClearColor(1, 1, 1, 1);
    		Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
    
            batch.begin();
    
            batch.draw(badlogicTexture, 0, 0);
            batch.draw(logoTexture, 10, 300);
    
            batch.end();
    	}
    
    	@Override
    	public void dispose() { 
    		// 当应用退出时释放资源
    		if (manager != null) { 
                /* * 释放所有资源, 并销毁 AssetManager。 * * 注意: 本例中的 Texture 通过 AssetManager 进行管理, * 因此这里不需要再调用 Texture 的 dispose() 方法。 */
    			manager.dispose();
    		}
    	}
    
    }

--------------------

![18975746.asp][]

[http_blog.csdn.net_xietansheng_article_details_50188131]: http://blog.csdn.net/xietansheng/article/details/50188131
[LibGDX]: http://blog.csdn.net/xietansheng/article/details/50185655
[https_github.com_libgdx_libgdx_wiki_Managing-your-assets]: https://github.com/libgdx/libgdx/wiki/Managing-your-assets
[this StackOverflow question]: http://stackoverflow.com/q/4341600/14637
[18975746.asp]: http://img.users.51.la/18975746.asp