本文旨在帮助开发者解决 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 文件夹中加载资源。如果资源位于子文件夹中，需要在路径中包含子文件夹名称。
// 正确的路径
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();
}
}关键修改：
- SplashScreen 不再创建新的 AssetManager 实例，而是使用从 MainClass 传递进来的实例。
- 在 SplashScreen 的 render 方法中，确保 manager.update() 返回 true 后，再获取 goku 纹理。
- Tela_Principal 直接从 AssetManager 获取纹理，不再创建新的 SplashScreen 实例。
- 在MainClass的dispose方法中释放AssetManager资源。
总结与注意事项
- 理解 AssetManager 的异步加载机制是解决 "Asset not loaded" 异常的关键。
- 始终确保在调用 manager.get() 之前，资源已经加载完成。
- 使用正确的资源路径，并注意大小写。
- 避免在多个类中创建 AssetManager 实例，建议使用单例模式。
- 及时释放 AssetManager 资源，避免内存泄漏。
通过理解 AssetManager 的工作原理，并遵循上述建议，可以有效地避免 "Asset not loaded" 异常，从而提升 LibGDX 游戏的稳定性和性能。
