Java青蛙过河游戏角色移动动画异常问题求助

问题背景 #

我正在为学校项目开发一款Java Frogger游戏，目前在添加角色移动动画时遇到以下异常：

• 单次按键时，青蛙移动帧显示延迟；长按按键仅显示静态站立帧。
• 调试后快速按键仍只显示站立帧，movingIndex未按预期保持为1。
• 新增buttonPressed、buttonReleased优化输入响应后，角色操作更灵敏，但快速按键时动画依旧不可见。

可复现代码（MRE） #

import java.awt.event.KeyEvent;
import java.awt.event.KeyListener;
import java.awt.image.BufferedImage;
import java.util.ArrayList;

public class Frog implements KeyListener {
    private ArrayList<BufferedImage> standingFrames;
    private ArrayList<BufferedImage> movingFrames;
    private int currentFrame = 0;
    private int movingIndex = 0;
    private boolean buttonPressed = false;
    private boolean buttonReleased = true;
    private int x, y;
    private final int MOVE_SPEED = 5;

    public Frog() {
        standingFrames = new ArrayList<>();
        movingFrames = new ArrayList<>();
        // 模拟帧加载（实际项目中从图片读取）
        standingFrames.add(new BufferedImage(50, 50, BufferedImage.TYPE_INT_ARGB));
        movingFrames.add(new BufferedImage(50, 50, BufferedImage.TYPE_INT_ARGB));
        movingFrames.add(new BufferedImage(50, 50, BufferedImage.TYPE_INT_ARGB));
    }

    @Override
    public void keyPressed(KeyEvent e) {
        buttonPressed = true;
        buttonReleased = false;
        switch (e.getKeyCode()) {
            case KeyEvent.VK_UP:
                y -= MOVE_SPEED;
                movingIndex = 1;
                break;
            // 其他方向按键逻辑类似
        }
    }

    @Override
    public void keyReleased(KeyEvent e) {
        buttonPressed = false;
        buttonReleased = true;
        movingIndex = 0;
    }

    @Override
    public void keyTyped(KeyEvent e) {}

    public void update() {
        if (buttonPressed) {
            currentFrame = (currentFrame + 1) % movingFrames.size();
        } else {
            currentFrame = (currentFrame + 1) % standingFrames.size();
        }
    }

    public BufferedImage getCurrentFrame() {
        return movingIndex == 1 ? movingFrames.get(currentFrame) : standingFrames.get(currentFrame);
    }
}

问题截图 #

（附：快速按键/长按按键时仅显示青蛙站立帧的截图）

问题分析与修复方案 #

核心问题 #

1. 按键事件与动画帧不同步：KeyListener的长按触发间隔导致动画帧更新不连续，且keyReleased会立即重置movingIndex，快速按键时移动帧还未渲染就被切回站立帧。
2. 帧更新逻辑无时间控制：update()方法调用频率不稳定，导致帧切换过快或过慢，出现延迟或静态帧。

具体修复步骤 #

1. 调整movingIndex重置逻辑

不在keyReleased中直接重置movingIndex，而是添加延迟，确保移动帧至少完整渲染一次：

private long lastMoveTime;
private final long ANIMATION_DELAY = 100; // 每100ms切换一帧

@Override
public void keyReleased(KeyEvent e) {
    buttonPressed = false;
    buttonReleased = true;
    lastMoveTime = System.currentTimeMillis();
}

public void update() {
    long currentTime = System.currentTimeMillis();
    if (buttonPressed) {
        movingIndex = 1;
        // 控制帧切换频率，避免过快
        if (currentTime - lastMoveTime >= ANIMATION_DELAY) {
            currentFrame = (currentFrame + 1) % movingFrames.size();
            lastMoveTime = currentTime;
        }
    } else {
        // 按键松开后延迟2个动画周期再切回站立帧
        if (currentTime - lastMoveTime >= ANIMATION_DELAY * 2) {
            movingIndex = 0;
            currentFrame = (currentFrame + 1) % standingFrames.size();
        }
    }
}

2. 替换KeyListener为KeyBindings

KeyBindings能更精准处理持续按键输入，避免KeyListener的长按触发间隔问题：

// 在游戏窗口初始化代码中添加按键绑定
InputMap inputMap = getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap actionMap = getActionMap();

// 向上按键的按下/释放绑定
inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_UP, 0, false), "upPressed");
inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_UP, 0, true), "upReleased");

actionMap.put("upPressed", new AbstractAction() {
    @Override
    public void actionPerformed(ActionEvent e) {
        buttonPressed = true;
        buttonReleased = false;
        y -= MOVE_SPEED;
        lastMoveTime = System.currentTimeMillis();
    }
});

actionMap.put("upReleased", new AbstractAction() {
    @Override
    public void actionPerformed(ActionEvent e) {
        buttonPressed = false;
        buttonReleased = true;
        lastMoveTime = System.currentTimeMillis();
    }
});

3. 实现固定帧率的游戏循环

保证update()和repaint()调用频率稳定，避免动画卡顿：

private final int FPS = 60;
private final long FRAME_DURATION = 1000 / FPS;

public void startGameLoop() {
    long lastFrameTime = System.currentTimeMillis();
    while (true) {
        long currentTime = System.currentTimeMillis();
        if (currentTime - lastFrameTime >= FRAME_DURATION) {
            update();
            repaint();
            lastFrameTime = currentTime;
        }
        // 避免CPU占用过高
        try {
            Thread.sleep(1);
        } catch (InterruptedException ex) {
            ex.printStackTrace();
        }
    }
}

修复后效果 #

• 单次按键时移动帧正常切换，无明显延迟；
• 长按按键时动画帧持续循环；
• 快速按键时移动帧会完整渲染后再切换回站立帧。

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