0

0

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

心靈之曲

心靈之曲

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

|

397人浏览过

|

来源于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 的现代实践,也是官方推荐的高级用法之一。

SciMaster
SciMaster

全球首个通用型科研AI智能体

下载

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

355

2023.11.13

java boolean类型
java boolean类型

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

35

2025.11.30

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

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

1322

2023.10.19

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

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

276

2025.10.17

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

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

2200

2025.12.29

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

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

34

2026.01.19

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

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

613

2023.08.10

Golang处理数据库错误教程合集
Golang处理数据库错误教程合集

本专题整合了Golang数据库错误处理方法、技巧、管理策略相关内容,阅读专题下面的文章了解更多详细内容。

35

2026.02.06

java多线程方法汇总
java多线程方法汇总

本专题整合了java多线程面试题、实现函数、执行并发相关内容,阅读专题下面的文章了解更多详细内容。

15

2026.02.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java 教程
Java 教程

共578课时 | 59.6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号