LibGDX TextureRegion类类型转换异常排查求助

核心问题原因 #

1. AnimationSet类泛型定义错误：你定义的public class AnimationSet<TextureRegion>中，<TextureRegion>是泛型参数占位符，而非实际的com.badlogic.gdx.graphics.g2d.TextureRegion类，导致类型系统混乱，后续类型转换出错。
2. Animation构造函数参数误用：LibGDX的Animation构造方法中，当需要指定播放模式时，不能直接将PlayMode作为可变参数传入。你当前的写法会把TextureRegion和PlayMode都当成动画帧数组的元素，使得Animation的泛型类型变为Object，调用getKeyFrame时返回的可能是PlayMode对象，进而触发类型转换异常。

具体修复步骤 #

1. 修复AnimationSet类的泛型定义 #

去掉泛型占位符，直接绑定TextureRegion类型：

package util;

import com.badlogic.gdx.graphics.g2d.Animation;
import com.badlogic.gdx.graphics.g2d.TextureRegion;
import model.DIRECTION;

import java.util.HashMap;
import java.util.Hashtable;
import java.util.Map;

public class AnimationSet {

    private Map<DIRECTION, Animation<TextureRegion>> walking;
    private Map<DIRECTION, TextureRegion> standing;

    public AnimationSet(Animation<TextureRegion> walkNorth,
                        Animation<TextureRegion> walkSouth,
                        Animation<TextureRegion> walkEast,
                        Animation<TextureRegion> walkWest,
                        TextureRegion standNorth,
                        TextureRegion standSouth,
                        TextureRegion standEast,
                        TextureRegion standWest ) {
        walking = new HashMap<>();
        walking.put(DIRECTION.NORTH, walkNorth);
        walking.put(DIRECTION.SOUTH, walkSouth);
        walking.put(DIRECTION.EAST, walkEast);
        walking.put(DIRECTION.WEST, walkWest);
        standing = new Hashtable<>();
        standing.put(DIRECTION.NORTH, standNorth);
        standing.put(DIRECTION.SOUTH, standSouth);
        standing.put(DIRECTION.EAST, standEast);
        standing.put(DIRECTION.WEST, standWest);
    }

    public Animation<TextureRegion> getWalking(DIRECTION dir){
        return walking.get(dir);
    }

    public TextureRegion getStanding(DIRECTION dir){
        return standing.get(dir);
    }
}

2. 修复GameScreen中Animation实例的创建 #

步行动画应为多帧动画，需从TextureAtlas中获取一组帧（使用findRegions而非findRegion），并正确调用Animation构造方法指定播放模式：

public GameScreen(MyGdxGame app) {
    super(app);
    south = new Texture("assets/stand.png");
    room1 = new Texture("assets/tile2.png");
    room2 = new Texture("assets/tile2.png");
    batch = new SpriteBatch();
    TextureAtlas atlas = app.getAssetManager().get("assets/packed/textures.atlas", TextureAtlas.class);

    // 获取多帧动画的帧集合
    Array<TextureRegion> walkNorthFrames = atlas.findRegions("dawn_walk_north");
    Array<TextureRegion> walkSouthFrames = atlas.findRegions("dawn_walk_south");
    Array<TextureRegion> walkEastFrames = atlas.findRegions("dawn_walk_east");
    Array<TextureRegion> walkWestFrames = atlas.findRegions("dawn_walk_west");

    // 正确创建Animation实例
    AnimationSet animations = new AnimationSet(
            new Animation<>(0.3f/2f, walkNorthFrames, Animation.PlayMode.LOOP_PINGPONG),
            new Animation<>(0.3f/2f, walkSouthFrames, Animation.PlayMode.LOOP_PINGPONG),
            new Animation<>(0.3f/2f, walkEastFrames, Animation.PlayMode.LOOP_PINGPONG),
            new Animation<>(0.3f/2f, walkWestFrames, Animation.PlayMode.LOOP_PINGPONG),
            atlas.findRegion("dawn_stand_north"),
            atlas.findRegion("dawn_stand_south"),
            atlas.findRegion("dawn_stand_east"),
            atlas.findRegion("dawn_stand_west")
    );

    map = new TileMap(10,10);
    actor = new Actor(map,0,0,animations);
    controller = new PlayerController(actor);
    camera = new Camera();
}

3. 确认Actor类中的变量类型 #

确保Actor类中animations变量定义为：

private AnimationSet animations;

额外说明 #

• 如果你的步行动画确实是单帧（不推荐，步行动画至少2帧才有效果），可以用数组包裹单个TextureRegion：

  new Animation<>(0.3f/2f, new TextureRegion[]{atlas.findRegion("dawn_walk_north")}, Animation.PlayMode.LOOP_PINGPONG)
  

• 检查TextureAtlas中是否存在dawn_walk_north等多帧区域，确保findRegions能返回正确的帧数组。

内容的提问来源于stack exchange，提问作者CielGre