LibGDX AssetManager 资源加载问题排查与解决-java教程-PHP中文网

LibGDX AssetManager 资源加载问题排查与解决

聖光之護

发布： 2025-11-01 17:51:14

原创

444人浏览过

libgdx assetmanager 资源加载问题排查与解决

本文旨在帮助开发者解决 LibGDX 项目中使用 AssetManager 加载资源时遇到的“Asset not loaded”错误。通过分析常见原因，提供代码示例和最佳实践，确保资源能够正确加载，从而避免程序运行时出现异常。

在 LibGDX 游戏开发中，AssetManager 是一个至关重要的类，它负责管理和加载游戏所需的各种资源，例如纹理、音频、字体等。然而，初学者在使用 AssetManager 时，经常会遇到 "Asset not loaded" 异常。本文将深入探讨这个问题，分析其常见原因，并提供相应的解决方案，帮助开发者更好地理解和使用 AssetManager。

常见原因分析

"Asset not loaded" 异常通常意味着你在尝试获取一个尚未完成加载的资源。以下是几个常见的原因：

异步加载机制： AssetManager 的 load() 方法只是将资源添加到加载队列，并非立即加载。资源实际的加载过程是异步的，需要在 update() 方法被调用时才会进行。
资源未完成加载： 在调用 get() 方法获取资源之前，必须确保资源已经加载完成。可以通过 manager.update() 的返回值或 manager.isLoaded() 方法来判断资源是否加载完毕。
路径错误： 资源路径不正确是另一个常见原因。请确保资源文件存在于指定路径下，并且路径字符串拼写正确。
重复创建 AssetManager 实例： 在多个类中创建 AssetManager 实例可能导致资源管理混乱。建议在游戏的入口类中创建唯一的 AssetManager 实例，并将其传递给其他需要使用资源的类。

解决方案与示例代码

下面将针对上述原因，提供具体的解决方案和示例代码：

1. 确保资源加载完成

在调用 manager.get() 方法之前，务必确保资源已经加载完成。可以通过以下两种方式实现：

使用 manager.update()：

AssetManager manager = new AssetManager();
manager.load("myTexture.png", Texture.class);

// 循环调用 update() 直到所有资源加载完成
while (!manager.update()) {
    float progress = manager.getProgress();
    System.out.println("Loading... " + (int)(progress * 100) + "%");
}

// 现在可以安全地获取资源
Texture texture = manager.get("myTexture.png", Texture.class);

登录后复制

使用 manager.isLoaded()：

AssetManager manager = new AssetManager();
manager.load("myTexture.png", Texture.class);
manager.update(); // 至少调用一次 update() 开始加载

if (manager.isLoaded("myTexture.png")) {
    Texture texture = manager.get("myTexture.png", Texture.class);
} else {
    System.out.println("Texture is not yet loaded!");
}

登录后复制

2. 检查资源路径

确保资源文件存在于正确的路径下。LibGDX 默认从 assets 文件夹中加载资源。如果资源位于子文件夹中，需要在路径中包含子文件夹名称。

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

// 正确的路径
manager.load("images/myTexture.png", Texture.class);

// 错误的路径 (如果 myTexture.png 位于 images 文件夹中)
manager.load("myTexture.png", Texture.class);

登录后复制

3. 单例 AssetManager 实例

为了避免资源管理混乱，建议在游戏的入口类（通常是继承自 Game 的类）中创建唯一的 AssetManager 实例，并将其传递给其他需要使用资源的类。

public class MyGame extends Game {
    private AssetManager manager;

    @Override
    public void create() {
        manager = new AssetManager();
        setScreen(new MyScreen(this, manager));
    }

    public AssetManager getAssetManager() {
        return manager;
    }

    @Override
    public void dispose() {
        manager.dispose();
    }
}

public class MyScreen implements Screen {
    private MyGame game;
    private AssetManager manager;

    public MyScreen(MyGame game, AssetManager manager) {
        this.game = game;
        this.manager = manager;
    }

    @Override
    public void show() {
        manager.load("myTexture.png", Texture.class);
    }
}

登录后复制

4. 错误示例分析与修正

在原始问题中，存在以下问题：

在 SplashScreen 的构造函数中，先创建了一个新的 AssetManager 实例，覆盖了从 MainClass 传递进来的实例。
在加载资源后，立即尝试通过 manager.get() 获取资源，而没有等待资源加载完成。
在 Tela_Principal 中，又创建了一个 SplashScreen 实例，导致资源重复加载。

修正后的代码应该如下所示：

public class SplashScreen implements Screen {

    private Game game;
    private AssetManager manager;
    private float time = 0;
    private SpriteBatch batch;
    private Texture tex;
    public Texture goku;

    public SplashScreen(Game game, AssetManager manager){
        this.game = game;
        this.manager = manager;

        batch = new SpriteBatch();
        tex = new Texture("logo.png");

        for (int i=1;i<=5;i++){
            manager.load("bater_1/goku"+i+".png",Texture.class);
        }
    }

    @Override
    public void render(float delta) {
        time+=delta;

        if (manager.update() && time >=2){
            goku = manager.get("bater_1/goku2.png",Texture.class); // 确保资源加载完成后再获取
            game.setScreen(new Tela_Principal(game,manager));
        }

        Gdx.gl.glClearColor(1,1,1,1);
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
        batch.begin();
        batch.draw(tex, (float) (screenx*0.26), (float) (screeny*0.1), (float) (screenx*0.5), (float) (screeny*0.8));
        batch.end();
    }

    // ... 其他方法
}

public class Tela_Principal implements Screen {

    private Game game;
    private AssetManager manager;
    private SpriteBatch batch;
    private Texture goku; // 直接持有 Texture 引用

    public Tela_Principal(Game game, AssetManager manager){
        this.game = game;
        this.manager = manager;

        batch = new SpriteBatch();
        goku = manager.get("bater_1/goku1.png", Texture.class); // 直接获取 Texture 资源
    }

    @Override
    public void render(float delta) {
        Gdx.gl.glClearColor(0,1,0,0);
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);

        batch.begin();
        batch.draw(goku, (float) (screenx *0.1), (float) (screeny*0.1));
        batch.end();
    }

    // ... 其他方法
}

public class MainClass extends Game {

    public AssetManager manager;

    @Override
    public void create () {
        manager = new AssetManager();
        setScreen(new SplashScreen (this, manager));
    }

    @Override
    public void dispose() {
        manager.dispose();
    }
}

登录后复制

关键修改：