讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在 LibGDX 中实现可暂停的进度条(无动画手动控制版)

梦杰同学_1406

梦杰同学_1406

发布时间:2026-02-08 12:30:35

|

457人浏览过

|

来源于php中文网

原创

如何在 LibGDX 中实现可暂停的进度条(无动画手动控制版)

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

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
java中boolean的用法
java中boolean的用法

在Java中,boolean是一种基本数据类型,它只有两个可能的值:true和false。boolean类型经常用于条件测试,比如进行比较或者检查某个条件是否满足。想了解更多java中boolean的相关内容,可以阅读本专题下面的文章。

2130

2023.11.13

java boolean类型
java boolean类型

本专题整合了java中boolean类型相关教程,阅读专题下面的文章了解更多详细内容。

163

2025.11.30

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3168

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

5009

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3809

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

466

2026.01.19

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

4338

2023.08.10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

20

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn