项目常用功能实现:跑马灯、飞金币、飘字、倒计时、新手引导与打击感

4167 字
21 分钟
项目常用功能实现:跑马灯、飞金币、飘字、倒计时、新手引导与打击感

本文中的功能都建立在 UI 框架和 UGUI 的基础上,相关原理见 UI 框架设计 和 UGUI 原理与核心机制。示例代码中的异步等待使用 UniTask(见 Unity 异步编程)。

一、跑马灯#

需求#

  • 全服公告、玩家抽到稀有道具的广播,从右向左滚动经过屏幕顶部的一条区域。
  • 公告排队依次播放,播放完全部后隐藏。
  • 支持优先级:运营的紧急公告可以插队,甚至打断当前正在播放的。
  • 支持重复次数:同一条公告滚动 N 遍。
  • 无论文字长短,滚动速度保持一致。
  • 文字只在滚动区域内显示,超出部分被裁掉,最好两端有渐隐效果。

实现思路#

跑马灯容器(独立 Canvas)
└── Viewport(挂 RectMask2D,定义可视区域)
└── Text(TextMeshPro,轴心和锚点在左侧)

每条公告的滚动过程:

  1. 设置文字,计算文字宽度;
  2. 文字从 Viewport 的右边缘外开始;
  3. 每帧向左移动 速度 × 时间;
  4. 文字完全移出左边缘后,这一遍结束。

所以每一遍的时长 = (视口宽度 + 文字宽度) / 速度,长文字自然滚得久,速度始终一致。

关键代码#

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² P2
static 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 影响;多个顿帧要统一管理;更精细的做法是只暂停相关角色的动画。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

项目常用功能实现:跑马灯、飞金币、飘字、倒计时、新手引导与打击感
https://xslab.cloud/posts/design/common-features/
作者
LuxFire
发布于
2026-10-12
许可协议
CC BY-NC-SA 4.0
相关文章 智能推荐
1
UI 框架设计:以休闲游戏为例
项目设计/架构 参考 GameFramework、QFramework、FairyGUI 等主流方案,设计一套适合休闲游戏的 UGUI 框架:层级管理、窗口生命周期、窗口栈与返回键、弹窗队列、缓存与资源释放、遮罩与动画、界面切换与闪烁、屏幕适配、组件绑定、红点系统,并给出核心代码骨架。
2
UGUI 原理与核心机制:Canvas、RectTransform、布局、事件与网格
Unity底层/UI UGUI 由哪些部分组成、一个 Image 是怎么画到屏幕上的;Canvas 的三种渲染模式与排序;RectTransform 的锚点、轴心、anchoredPosition 与 sizeDelta;布局系统的计算顺序;事件系统如何找到点击目标、事件如何冒泡;Graphic 与 VertexHelper 的网格生成;Image 类型、图集与 TextMeshPro;屏幕、UI、世界坐标的转换;以及 Button、Toggle、Slider、ScrollRect、InputField、Dropdown 等常用控件。
3
Unity 光照与阴影:实时与烘焙、光照贴图、光照探针、反射探针与阴影贴图
Unity底层/渲染 光源的类型与实时、烘焙、混合三种模式;直接光与间接光、全局光照;光照贴图的原理与开销;动态物体如何通过光照探针获得烘焙光照;反射探针;阴影贴图的原理、阴影痤疮与悬浮、级联阴影;以及移动端光照与阴影的优化方案。
4
循环列表的实现:固定高度、变长项、网格布局与跳转定位
Unity底层/UI 为什么长列表需要循环复用;循环列表的核心原理:根据滚动位置计算可见范围,回收和复用节点;固定高度列表的完整实现;变长项如何用前缀和加二分查找定位;网格布局;跳转到指定项、局部刷新与增删;以及常见的坑。
5
Unity 资源目录与序列化:特殊文件夹、运行时路径、序列化规则、Prefab 与 ScriptableObject
Unity底层/基础 Resources、StreamingAssets、Editor、Plugins 等特殊文件夹的作用;dataPath、streamingAssetsPath、persistentDataPath 的读写权限;meta 文件与 GUID;哪些字段会被序列化、哪些不会,Dictionary 怎么序列化,SerializeReference;Prefab 的嵌套与变体;ScriptableObject 的用途与陷阱。
随机文章 随机推荐
Profile Image of the Author
LuxFire
Hello, I'm LuxFire.
公告
欢迎来到我的博客!这是一则示例公告。
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
60
分类
6
标签
164
总字数
171,869
运行时长
0 天
最后活动
0 天前

文章目录