项目常用功能实现:跑马灯、飞金币、飘字、倒计时、新手引导与打击感
本文中的功能都建立在 UI 框架和 UGUI 的基础上,相关原理见 UI 框架设计 和 UGUI 原理与核心机制。示例代码中的异步等待使用 UniTask(见 Unity 异步编程)。
一、跑马灯
需求
- 全服公告、玩家抽到稀有道具的广播,从右向左滚动经过屏幕顶部的一条区域。
- 公告排队依次播放,播放完全部后隐藏。
- 支持优先级:运营的紧急公告可以插队,甚至打断当前正在播放的。
- 支持重复次数:同一条公告滚动 N 遍。
- 无论文字长短,滚动速度保持一致。
- 文字只在滚动区域内显示,超出部分被裁掉,最好两端有渐隐效果。
实现思路
跑马灯容器(独立 Canvas)└── Viewport(挂 RectMask2D,定义可视区域) └── Text(TextMeshPro,轴心和锚点在左侧)每条公告的滚动过程:
- 设置文字,计算文字宽度;
- 文字从 Viewport 的右边缘外开始;
- 每帧向左移动
速度 × 时间; - 文字完全移出左边缘后,这一遍结束。
所以每一遍的时长 = (视口宽度 + 文字宽度) / 速度,长文字自然滚得久,速度始终一致。
关键代码
public class Marquee : MonoBehaviour{ [SerializeField] RectTransform viewport; // 挂 RectMask2D [SerializeField] TMP_Text text; // 轴心 (0, 0.5),锚点在 Viewport 左侧 [SerializeField] float speed = 120f; // 像素 / 秒
class Notice { public string Content; public int Priority; public int Repeat; }
readonly List<Notice> _queue = new(); CancellationTokenSource _cts;
public void Enqueue(string content, int priority = 0, int repeat = 1, bool interrupt = false) { _queue.Add(new Notice { Content = content, Priority = priority, Repeat = repeat }); _queue.Sort((a, b) => b.Priority.CompareTo(a.Priority)); // 优先级高的在前
if (interrupt) _cts?.Cancel(); // 紧急公告:打断当前播放 if (_cts == null || _cts.IsCancellationRequested) StartPlay(); }
void StartPlay() { _cts = CancellationTokenSource.CreateLinkedTokenSource(this.GetCancellationTokenOnDestroy()); PlayLoop(_cts.Token).Forget(); }
async UniTaskVoid PlayLoop(CancellationToken token) { gameObject.SetActive(true); while (_queue.Count > 0) { var notice = _queue[0]; _queue.RemoveAt(0);
text.SetText(notice.Content); text.ForceMeshUpdate(); // 立即排版,才能拿到正确的宽度 float textWidth = text.preferredWidth; float viewWidth = viewport.rect.width;
for (int i = 0; i < notice.Repeat; i++) { float x = viewWidth; // 从右边缘外开始 while (x > -textWidth) // 完全移出左边缘为止 { x -= speed * Time.unscaledDeltaTime; // 用真实时间,游戏暂停时也能滚动 text.rectTransform.anchoredPosition = new Vector2(x, 0); await UniTask.Yield(token); // 被打断时这里抛出取消异常,退出循环 } } } gameObject.SetActive(false); _cts = null; }}(示例中被打断的那条公告直接丢弃了;如果需要,可以在打断前把它重新放回队列。)
要点:
- 独立 Canvas:跑马灯每帧都在移动,会让所在的 Canvas 每帧重新合批。把它放在单独的 Canvas 中,避免影响其他界面(见 动静分离)。
- 用真实时间:
Time.unscaledDeltaTime不受timeScale影响,游戏暂停时公告照样滚动。 - 场景控制:战斗中、播放剧情时可能不希望出现跑马灯,可以提供暂停接口,或者暂时只排队不播放。
- 长度控制:玩家名字、道具名过长时,在服务器或客户端截断,避免一条公告滚动太久。
不用 Mask,怎么裁剪
文字需要在 Viewport 之外不可见。很多人第一反应是用 Mask,但 Mask 基于模板缓冲,会增加绘制次数、打断合批(见 Mask 与 RectMask2D)。可选的替代方案:
| 方式 | 原理 | 优点 | 缺点 |
|---|---|---|---|
| RectMask2D(推荐) | 子元素的 Shader 根据一个矩形区域(_ClipRect)丢弃区域外的像素;完全在区域外的元素直接不画 | 不使用模板缓冲,不增加绘制次数;Unity 2020 起支持 softness,两端可以直接做出渐隐 | 只能是矩形 |
| 自定义 Shader 裁剪 | 把裁剪区域(世界坐标或屏幕坐标)传给文字的材质,在片元着色器中根据位置计算透明度 | 最灵活,可以做任意形状和渐隐曲线 | 需要自定义材质;参数不同的材质不能合批 |
| 遮挡 | 不裁剪,而是在滚动区域两侧盖上不透明的背景图 | 最简单 | 两侧必须是不透明的背景;多了一层过度绘制;不适合透明背景 |
| 只显示部分字符 | 不移动文字,而是像打字机一样改变显示的字符范围 | 不需要裁剪 | 只能逐字跳动,做不到平滑滚动 |
| RenderTexture | 先把文字渲染到一张贴图上,再显示贴图的一部分 | 可以做复杂效果 | 开销大,不推荐 |
实际项目中,RectMask2D 加 softness 就能满足绝大多数跑马灯的需求。
自定义 Shader 做渐隐的思路(简化):
// _FadeRect:滚动区域在屏幕上的左右边界(像素),由脚本设置;_FadeWidth:渐隐宽度float x = IN.positionHCS.x; // 当前像素的屏幕 x 坐标float left = saturate((x - _FadeRect.x) / _FadeWidth);float right = saturate((_FadeRect.y - x) / _FadeWidth);color.a *= left * right; // 两端逐渐透明,区域外完全透明二、飞金币与数字滚动
需求
领取奖励时,金币图标从奖励位置飞向界面顶部的金币栏,到达后金币栏的数字从旧值滚动到新值,并伴随一个缩放的弹跳。
实现
1. 坐标转换:起点是奖励按钮的位置,终点是金币栏图标的位置。如果两者不在同一个父节点下,先都转换到飞行层的局部坐标(见 坐标转换)。
2. 曲线飞行:直线飞行太生硬,常用二次贝塞尔曲线,中间加一个偏移的控制点,并给每个金币一点随机(曲线的原理见 曲线与缓动):
// 二次贝塞尔:P(t) = (1-t)² P0 + 2(1-t)t P1 + t² P2static Vector2 Bezier(Vector2 p0, Vector2 p1, Vector2 p2, float t){ float u = 1 - t; return u * u * p0 + 2 * u * t * p1 + t * t * p2;}
async UniTask FlyOne(RectTransform coin, Vector2 from, Vector2 to, float delay, CancellationToken token){ await UniTask.Delay(TimeSpan.FromSeconds(delay), cancellationToken: token); Vector2 control = (from + to) / 2 + new Vector2(Random.Range(-200f, 200f), Random.Range(100f, 300f)); for (float t = 0; t < 1; t += Time.unscaledDeltaTime / 0.6f) { float eased = t * t; // 先慢后快,像被吸过去 coin.anchoredPosition = Bezier(from, control, to, eased); await UniTask.Yield(token); } coin.anchoredPosition = to;}- 一次飞出多个金币(比如 8 到 10 个),每个延迟 0.05 秒依次出发。
- 金币图标用对象池,飞完回收。
- 第一个金币到达时,金币栏图标做一个”弹一下”的缩放;全部到达后数字开始滚动。
3. 数字滚动:
async UniTask RollNumber(TMP_Text label, long from, long to, float duration, CancellationToken token){ for (float t = 0; t < 1; t += Time.unscaledDeltaTime / duration) { long value = (long)Mathf.Lerp(from, to, t); label.SetText("{0}", value); // 无 GC 的格式化 await UniTask.Yield(token); } label.SetText("{0}", to);}数据和表现分离:领取时数据立即更新为新值,飞金币和数字滚动只是表现。这样即使玩家在动画过程中关闭界面,或者动画被打断,数据也是正确的;下次打开界面直接显示最终值。
三、伤害飘字
实现要点
- 对象池:战斗中飘字数量很多,必须复用。
- 位置:怪物的世界坐标转换到 UI 坐标(见 世界 → UI);或者直接使用 3D 的
TextMeshPro组件放在世界空间中。 - 动画:向上飘动并逐渐消失,再加一点随机的水平偏移,避免多个数字重叠。暴击用更大的字号、不同的颜色,加一个先放大再缩小的弹出效果。
- 文字:使用 TMP 的
SetText("{0}", damage)避免分配字符串;美术风格化的数字可以做成 TMP 的 Sprite Asset,或者用位图字体(见 字体渲染)。 - 合批:所有飘字使用同一个字体和材质,放在同一个独立 Canvas 中。飘字每帧都在移动,独立 Canvas 可以避免拖累其他 UI 重新合批。
- 数量控制:同一帧内的大量伤害可以合并显示,或者限制同屏飘字的上限,超出时回收最早的。
四、倒计时
不要相信本地时间
活动剩余时间、体力恢复、建造完成时间,都不能用设备时间(DateTime.Now)计算,因为玩家可以修改手机时间作弊。正确的做法是用服务器时间:
public static class ServerTime{ static long _serverMsAtSync; // 同步时服务器的时间戳(毫秒) static double _localAtSync; // 同步时的本地运行时间
// 登录、心跳、每次收到服务器响应时校准 public static void Sync(long serverMs) { _serverMsAtSync = serverMs; _localAtSync = Time.realtimeSinceStartupAsDouble; }
public static long NowMs => _serverMsAtSync + (long)((Time.realtimeSinceStartupAsDouble - _localAtSync) * 1000);}Time.realtimeSinceStartup 是游戏启动后经过的真实时间,玩家改手机时间也不会影响它。
不同平台上,应用在后台被挂起期间这个值是否继续增加可能有差异。所以回到前台时,最好重新向服务器同步一次时间。
显示
long remainMs = endTimeMs - ServerTime.NowMs;int remainSec = (int)(remainMs / 1000);if (remainSec != _lastSec) // 秒数变化了才刷新文字{ _lastSec = remainSec; label.text = $"{remainSec / 3600:00}:{remainSec % 3600 / 60:00}:{remainSec % 60:00}";}- 只在秒数变化时更新文字,避免每帧重新生成文字网格。每秒一次的字符串分配完全可以接受。
- 大量倒计时(比如列表中每一项都有)不要各自写
Update,由一个统一的计时管理器每秒通知一次。 - 倒计时结束时,以服务器为准:客户端到点后请求服务器确认状态,而不是直接认为已经完成。
五、新手引导
遮罩挖洞
新手引导要把整个屏幕压暗,只露出需要点击的按钮,并且只有这个按钮能点。
方法一:四块遮罩拼接(最简单)
在目标按钮的上、下、左、右各放一块半透明的黑色图片,围出一个”洞”。不需要任何 Shader,四块遮罩本身会挡住点击,洞里的按钮自然可以被点到。
方法二:Shader 挖洞(效果更好)
一张全屏的半透明遮罩,用 Shader 根据目标区域把洞内的像素变透明。可以做圆形的洞、柔和的边缘、洞逐渐收缩聚焦的动画:
// _HoleCenter、_HoleRadius:洞的位置和半径(屏幕像素),由脚本根据目标按钮计算float dist = distance(IN.positionHCS.xy, _HoleCenter.xy);float alpha = smoothstep(_HoleRadius, _HoleRadius + _EdgeSoftness, dist); // 洞内透明,边缘柔和过渡return half4(0, 0, 0, _MaskAlpha * alpha);点击穿透
用 Shader 挖洞时,洞只是看起来透明,遮罩仍然会挡住点击。需要让洞内的点击穿过遮罩,到达下面的按钮。实现 ICanvasRaycastFilter 接口,告诉事件系统哪些位置不响应射线检测:
public class GuideMask : MonoBehaviour, ICanvasRaycastFilter{ public RectTransform target; // 当前引导的目标按钮
// 返回 false 表示这个位置"点不到"遮罩,事件继续向下传给目标按钮 public bool IsRaycastLocationValid(Vector2 screenPos, Camera cam) { return !RectTransformUtility.RectangleContainsScreenPoint(target, screenPos, cam); }}射线检测的原理见 事件系统。
引导系统的设计要点
- 配置驱动:每一步引导的目标、提示文字、手指动画、完成条件写在配置表中,而不是硬编码在业务代码里。
- 目标定位:引导需要找到界面上的按钮。不要依赖层级路径(界面一改就失效),而是给需要引导的控件挂一个标记组件,注册一个唯一的 ID。
- 等待目标出现:目标界面可能还在加载,或者在列表中需要先滚动到可见位置。
- 断点续引导:每完成一个关键步骤就保存进度(最好同步到服务器),玩家中途退出后能从正确的位置继续。
- 防卡死:目标长时间找不到(界面被关闭、网络异常)时,要有跳过或者重新开始的机制,绝不能让玩家卡在一个无法点击的遮罩下。
- 和其他系统协调:引导进行中,暂停弹窗队列、屏蔽返回键、隐藏跑马灯(见 弹窗队列)。
六、延迟扣血的双层血条
受到伤害时,血条立即减少,同时后面有一层颜色不同的”残影”停留一会,再慢慢追上来,让玩家清楚地看到这次掉了多少血。
前层(红色):立即变为当前血量后层(白色):停顿 0.3 秒后,平滑地减少到当前血量[SerializeField] Image front; // Filled 类型[SerializeField] Image back; // Filled 类型,放在 front 下面CancellationTokenSource _cts;
public void SetHp(float ratio){ front.fillAmount = ratio; _cts?.Cancel(); _cts = new CancellationTokenSource(); CatchUp(ratio, _cts.Token).Forget();}
async UniTaskVoid CatchUp(float target, CancellationToken token){ await UniTask.Delay(300, cancellationToken: token); while (back.fillAmount > target) { back.fillAmount = Mathf.MoveTowards(back.fillAmount, target, Time.deltaTime * 0.8f); await UniTask.Yield(token); }}- 连续受击时,每次都重置等待,残影会在连击结束后才开始追赶。
- 回血时反过来:后层先到位(用绿色表示即将恢复的部分),前层再慢慢增长。
- 血条使用 Image 的 Filled 类型(见 Image 的四种类型),修改
fillAmount即可。
七、打击感:屏幕震动与顿帧
屏幕震动
public class CameraShake : MonoBehaviour // 挂在相机的父节点上{ float _trauma; // 震动强度,0 到 1
public void AddTrauma(float amount) => _trauma = Mathf.Clamp01(_trauma + amount);
void LateUpdate() { if (_trauma <= 0) { transform.localPosition = Vector3.zero; return; }
float shake = _trauma * _trauma; // 平方:小的震动更轻,大的震动更明显 float t = Time.time * 25f; transform.localPosition = new Vector3( (Mathf.PerlinNoise(t, 0) - 0.5f) * 2 * shake * 0.5f, (Mathf.PerlinNoise(0, t) - 0.5f) * 2 * shake * 0.5f, 0); _trauma = Mathf.Max(0, _trauma - Time.deltaTime * 1.5f); // 随时间衰减 }}- 挂在相机的父节点上,而不是相机本身。这样不会和相机跟随角色的逻辑互相覆盖。
- 用柏林噪声而不是纯随机数,震动更连贯,不会剧烈抖动。
- 用”创伤值”累加的方式,多次受击的震动可以叠加,并自然衰减。
- 使用 Cinemachine 的项目,可以直接使用它的 Impulse 功能。
- 提供关闭震动的设置选项,部分玩家对震动敏感。
顿帧(Hit Stop)
命中的瞬间让画面停顿几十毫秒,打击会显得很有力量:
async UniTaskVoid HitStop(float seconds){ Time.timeScale = 0.05f; await UniTask.Delay(TimeSpan.FromSeconds(seconds), ignoreTimeScale: true); // 用真实时间等待 Time.timeScale = 1f;}- 停顿时间很短,一般在 0.05 到 0.15 秒之间,重击更长。
- 等待必须使用真实时间,否则 timeScale 降低后等待本身也被放慢了。
- 全局修改 timeScale 会影响所有东西。更精细的做法是只暂停攻击者和受击者的动画(把它们的 Animator 速度设为 0),其他内容照常运行。
- 多个顿帧同时触发时,要有统一的管理,避免一个结束时把另一个提前恢复了。
常见追问
跑马灯怎么实现? 公告排队(支持优先级和打断),每条公告的文字从视口右边缘外开始,每帧按固定速度左移,完全移出左边缘后播放下一条。放在独立 Canvas 中,用真实时间驱动。
不用 Mask 怎么实现跑马灯的裁剪? 用 RectMask2D:不使用模板缓冲,不增加绘制次数,还支持 softness 做两端渐隐。也可以用自定义 Shader 按位置计算透明度,或者在两侧用不透明背景遮挡。
飞金币的轨迹怎么做? 二次贝塞尔曲线,在起点和终点之间加一个随机偏移的控制点;多个金币依次延迟出发,配合缓动曲线,用对象池复用。
为什么领取奖励时要数据和表现分离? 数据立即更新,动画只是表现。动画被打断或界面被关闭时,数据依然正确。
倒计时为什么不能用本地时间?怎么做?
玩家可以修改设备时间作弊。用服务器时间戳加上本地经过的真实时间(realtimeSinceStartup)计算当前时间,并定期与服务器校准。
新手引导的遮罩挖洞和点击穿透怎么实现?
挖洞可以用四块遮罩拼出洞,或者用 Shader 让洞内透明;点击穿透用 ICanvasRaycastFilter,让洞内的位置不响应射线检测,点击就会落到下面的按钮上。
新手引导要注意什么? 配置驱动、用标记组件定位目标、等待目标出现、保存进度支持断点续引导、目标找不到时可以跳过,并与弹窗、返回键等系统协调。
屏幕震动为什么挂在相机的父节点上? 避免和相机跟随等逻辑互相覆盖位置;震动只修改父节点的局部偏移。
顿帧怎么实现?要注意什么? 短暂降低 timeScale,用真实时间等待后恢复。等待不能受 timeScale 影响;多个顿帧要统一管理;更精细的做法是只暂停相关角色的动画。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!