
本文介绍一种绕过 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 的现代实践,也是官方推荐的高级用法之一。










