JavaFX如何禁止用户同时按下多个方向箭头按键

问题根因 #

你现有代码的核心问题出在!Arrays.asList(pressedKeys).contains(true)这行判断：

• pressedKeys是基本类型boolean的数组，Arrays.asList()接收基本类型数组时不会自动拆箱，而是会把整个数组当作单个元素存入列表，返回的是List<boolean[]>类型
• 此时调用contains(true)永远返回false，等于你的按键互斥判断完全没生效，所以可以同时按下多个方向键

可行实现方案 #

方案1：最小改动修复原有逻辑 #

把互斥判断改成手动遍历数组检查，避免自动拆箱的坑，代码如下：

boolean[] pressedKeys = new boolean[4];
// 先确保canvas获取到焦点，否则按键事件不会触发
canvas.setFocusTraversable(true);

canvas.setOnKeyPressed(event -> {
    // 手动检查是否已经有方向键被按下
    boolean hasPressedKey = false;
    for (boolean b : pressedKeys) {
        if (b) {
            hasPressedKey = true;
            break;
        }
    }
    if (!hasPressedKey) {
        if (event.getCode() == KeyCode.UP) {
            pressedKeys[0] = true;
            // 此处放置向上移动逻辑
        } else if (event.getCode() == KeyCode.RIGHT) {
            pressedKeys[1] = true;
            // 此处放置向右移动逻辑
        } else if (event.getCode() == KeyCode.DOWN) {
            pressedKeys[2] = true;
            // 此处放置向下移动逻辑
        } else if (event.getCode() == KeyCode.LEFT) {
            pressedKeys[3] = true;
            // 此处放置向左移动逻辑
        }
    }
    event.consume();
});

canvas.setOnKeyReleased(event -> {
    if (event.getCode() == KeyCode.UP) {
        pressedKeys[0] = false;
    } else if (event.getCode() == KeyCode.RIGHT) {
        pressedKeys[1] = false;
    } else if (event.getCode() == KeyCode.DOWN) {
        pressedKeys[2] = false;
    } else if (event.getCode() == KeyCode.LEFT) {
        pressedKeys[3] = false;
    }
    event.consume();
});

方案2：更简洁的实现 #

用单个变量存储当前激活的按键，逻辑更直观，维护成本更低：

private KeyCode activeDirectionKey = null;

canvas.setFocusTraversable(true);

canvas.setOnKeyPressed(event -> {
    KeyCode code = event.getCode();
    // 仅当没有激活的方向键、且按下的是方向键时才处理
    if (activeDirectionKey == null && (code == KeyCode.UP || code == KeyCode.RIGHT || code == KeyCode.DOWN || code == KeyCode.LEFT)) {
        activeDirectionKey = code;
        // 执行对应方向的移动逻辑
        switch (code) {
            case UP -> moveUp();
            case RIGHT -> moveRight();
            case DOWN -> moveDown();
            case LEFT -> moveLeft();
        }
    }
    event.consume();
});

canvas.setOnKeyReleased(event -> {
    if (event.getCode() == activeDirectionKey) {
        activeDirectionKey = null;
        // 此处放置停止移动的逻辑
    }
    event.consume();
});

额外注意事项 #

如果你的移动逻辑是在动画循环里每帧执行的，只需要在循环里判断激活按键的状态执行对应移动即可，不需要在按键事件里直接触发移动逻辑。

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