游戏引擎 / 系统课时

让血条和分数跟随状态更新

让血条和分数跟随状态更新

血条是生命值的投影,分数文字是计分状态的投影,界面不应独自保存另一套规则。本节用同一个状态拥有者更新数值与 UI,并处理比例范围、空引用和非法伤害输入。

学习目标

  • 将生命值换算成 ProgressBar 比例
  • 在状态变化后统一刷新显示
  • 区分演示状态与完整战斗系统

约定状态与显示契约

创建 Canvas 下的 ProgressBar 和 Label,给 ProgressBar 指定用于填充的 Bar Sprite,初始显示完整血量。progress 的有效表达是 0 到 1 的比例,不是 0 到 100 的生命点数。本节最大生命为 100,分数从 0 开始。

真实项目可由角色或游戏模型拥有状态,UI 只订阅变化。本节为了独立运行,把状态和刷新放在一个组件中,但仍通过方法修改,不允许其他脚本直接改 Label 后假定得分已保存。

先修改数值,再统一刷新

将 HudProbe.ts 挂到空节点 HudController,绑定 healthBar 与 scoreLabel。示例启动时模拟一次受伤与一次计分,展示明确结果,不依赖前文的按钮或碰撞脚本。

ts
import { _decorator, Component, ProgressBar, Label } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('HudProbe')
export class HudProbe extends Component {
    @property(ProgressBar) healthBar: ProgressBar | null = null;
    @property(Label) scoreLabel: Label | null = null;
    private hp = 100;
    private score = 0;
    start(): void {
        if (!this.healthBar || !this.scoreLabel) { this.enabled = false; return; }
        this.damage(25);
        this.addScore(10); // 模拟业务状态变化,随后才刷新显示
        console.log('hud:' + this.hp + ':' + this.score);
    }
    damage(amount: number): void {
        if (!Number.isFinite(amount) || amount <= 0) return;
        this.hp = Math.max(0, this.hp - amount);
        this.render();
    }
    addScore(points: number): void {
        if (!Number.isInteger(points) || points <= 0) return;
        this.score += points;
        this.render();
    }
    private render(): void {
        if (this.healthBar) this.healthBar.progress = this.hp / 100;
        if (this.scoreLabel) this.scoreLabel.string = 'Score: ' + this.score;
    }
}

预期结果:血条显示约四分之三,文字为 Score: 10,日志为 hud:75:10。继续调用 damage(200) 会降至 0,不会变成负比例;damage(-5) 不会把非法负伤害变成治疗。治疗应提供独立方法并限制最大生命。

从模型追查显示问题

若日志数值正确而血条不变,检查 Bar Sprite 是否绑定、填充方向和节点尺寸是否正确,以及是否还有动画覆盖 progress。若文字变化但下次读分数仍为零,检查是否只改了 Label、没有修改真正的状态对象。

最大生命可配置时要处理零或非法上限,再计算比例;不要用除零结果填充界面。角色复活、读档和换场景后,应根据当前模型完整刷新一次,而不是等待下一次受伤事件才更新旧画面。

动画血条可以在实际生命变化后渐变到新比例,但伤害判定必须立即使用真实生命。界面过渡尚未结束不能成为“角色还没死”的依据。后续接入事件时,把生命与分数快照作为显示输入,让界面销毁与重建都可恢复同一状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

让血条和分数跟随状态更新

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通