当前位置：首页 > 文章列表 > 文章 > java教程 > LibGDX 实现可暂停进度条方法详解

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

2026-03-06 20:09:42 0浏览收藏

✅ 核心思路

禁用动画：创建 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 内置动画。