LibGDX 实现可暂停进度条方法详解

本文深入解析了如何在 LibGDX 中实现真正可暂停、可恢复的进度条——绕过其默认不可控的平滑动画机制，转而采用手动值更新结合 ApplicationListener 生命周期回调（pause/resume）的精准控制方案，既保证了 UI 响应性与线程安全，又赋予开发者对进度速率、完成事件和交互逻辑的完全掌控，特别适合游戏内需用户主动干预的任务系统、加载流程等真实场景。

本文介绍一种绕过 LibGDX `ProgressBar` 内置动画机制、通过手动更新值 + 应用生命周期回调实现精准暂停/恢复的方案，适用于游戏内任务、加载流程等需用户交互控制的场景。

在 LibGDX 中，ProgressBar 默认启用平滑动画（如 setAnimateDuration(25)），但其动画由 Stage.act() 驱动且不可直接暂停——调用 pause() 并不会冻结进度条的视觉变化。若需真正响应“暂停按钮”逻辑（例如玩家点击暂停时进度条立即停止、恢复时继续），推荐放弃内置动画，改用手动值更新 + 应用级生命周期控制的方式。该方案更可控、无副作用，且与 LibGDX 的 ApplicationListener 生命周期天然契合。

✅ 核心思路

• 禁用动画：创建 ProgressBar 时传入 false 作为 animate 参数，并不调用 setAnimateDuration()；
• 手动驱动进度：在 render() 中根据 deltaTime 累加 setValue()，模拟匀速填充；
• 利用 pause() / resume() 回调：仅通过布尔标志 active 控制是否执行进度更新，实现毫秒级暂停/恢复；
• 保持 UI 响应性：仍正常调用 stage.act() 和 stage.draw()，确保按钮、文本等其他 Actor 正常工作。

? 完整实现示例

public class ProgressBarTest implements ApplicationListener {
    private boolean active = true;
    private SpriteBatch batch;
    private Stage stage;
    private ProgressBar bar;

    @Override
    public void create() {
        batch = new SpriteBatch();
        // 使用 FitViewport 适配不同分辨率（推荐）
        stage = new Stage(new FitViewport(800, 600));

        // 构建自定义 ProgressBarStyle（简化版，保留原逻辑）
        ProgressBar.ProgressBarStyle style = new ProgressBar.ProgressBarStyle();
        style.background = makeDrawable(Color.CYAN, 100, 50);
        style.knob = makeDrawable(Color.RED, 10, 50);      // 小滑块（窄条）
        style.knobBefore = makeDrawable(Color.RED, 100, 50); // 已填充部分背景

        // 关键：禁用动画，maxValue 设为 25 → 每秒填满（因 deltaTime 单位为秒）
        bar = new ProgressBar(0f, 25f, 0.01f, false, style);
        bar.setBounds(100, 400, 600, 30); // 调整坐标适配常见视口（原代码 y=1600 过高）

        // 添加到 Stage（使用 Table 布局更规范）
        Table table = new Table();
        table.add(bar).pad(20);
        table.setFillParent(true);
        stage.addActor(table);
    }

    // 辅助方法：快速生成 TextureRegionDrawable
    private TextureRegionDrawable makeDrawable(Color color, int width, int height) {
        Pixmap pixmap = new Pixmap(width, height, Pixmap.Format.RGBA8888);
        pixmap.setColor(color);
        pixmap.fill();
        TextureRegionDrawable drawable = new TextureRegionDrawable(new TextureRegion(new Texture(pixmap)));
        pixmap.dispose();
        return drawable;
    }

    @Override
    public void render() {
        // ✅ 仅当 active == true 且未填满时更新进度
        if (active && bar.getValue() < bar.getMaxValue()) {
            float delta = Gdx.graphics.getDeltaTime();
            bar.setValue(Math.min(bar.getValue() + delta, bar.getMaxValue()));

            if (bar.getValue() >= bar.getMaxValue()) {
                Gdx.app.log("ProgressBar", "Completed!");
                // 可在此触发完成事件，如显示弹窗、切换场景等
            }
        }

        // ✅ 仍需调用 act() —— 否则按钮点击等事件失效！
        stage.act(Gdx.graphics.getDeltaTime());

        // 渲染
        Gdx.gl.glClearColor(0.1f, 0.1f, 0.1f, 1);
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
        batch.begin();
        stage.draw();
        batch.end();
    }

    @Override
    public void pause() {
        active = false;
        Gdx.app.log("Lifecycle", "Progress paused.");
    }

    @Override
    public void resume() {
        active = true;
        Gdx.app.log("Lifecycle", "Progress resumed.");
    }

    @Override
    public void dispose() {
        batch.dispose();
        stage.dispose();
        // 注意：此处未显式释放纹理，实际项目中建议统一管理 Texture 资源
    }

    // 其他生命周期方法（resize/dispose）按需补充...
    @Override public void resize(int width, int height) {}
    @Override public void dispose() {}
}

⚠️ 关键注意事项

• 不要省略 stage.act(deltaTime)：即使暂停进度，也必须调用 stage.act()（推荐传入 getDeltaTime()），否则所有 InputListener、Action 等将停止响应；
• setValue() 是线程安全的：LibGDX 的 UI 更新必须在渲染线程执行，上述写法完全合规；
• 精度与性能：Gdx.graphics.getDeltaTime() 提供高精度时间增量，避免帧率波动导致进度不均；
• 扩展性提示：
  • 若需支持“暂停按钮”而非全局暂停，可将 active 改为 private boolean isPaused，并在按钮 ClickListener 中切换；
  • 如需倒计时效果，可将 bar.setValue(... + delta) 改为 bar.setValue(... - delta)，并调整 min/max 值；
  • 复杂动画需求（如缓动、多段进度）建议使用 Actions 或 Timeline，而非依赖 ProgressBar 内置动画。

✅ 总结

LibGDX 的 ProgressBar 动画设计面向简单展示，缺乏运行时控制接口。通过主动接管进度逻辑，你不仅能实现可靠的暂停/恢复，还能获得对速率、触发条件、完成行为的完全掌控。此模式符合数据驱动 UI 的现代实践，也是官方推荐的高级用法之一。

本篇关于《LibGDX 实现可暂停进度条方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！