做Unity项目尤其是运营类或者带活动系统的游戏公告功能几乎是标配。小到“服务器维护通知”大到“版本更新公告”“限时活动说明”都得有个地方能弹出来给玩家看。我以前也图省事直接在场景里放一个TextMesh或者临时拼个UGUI面板结果一到上线就问题不断公告内容一改就要重新发包、弹窗层级被模型遮挡、文字一多就溢出滚动条乱跳、多语言版本又要再写一套逻辑。“公告for Unity”说白了就是要把这套逻辑沉淀成一个可复用、可扩展的独立模块。这篇文章就把我自己在项目里沉淀的公告系统设计方案和踩坑经验完整写出来从数据模型、UI搭建到动效细节、常见问题排查一次性讲透。不管是新手想抄作业还是老手想找参考都能直接用得上。1. 先想清楚再动手公告系统的定位与形态选择很多人在做公告系统时犯的第一个错误就是上来就拖UI控件先做面板背景、标题、滚动区域然后再想数据怎么填。我建议反过来先想清楚这个公告系统在游戏里到底扮演什么角色它才会有正确的形态。1.1 公告到底有哪几种常见形态我整理了一下Unity项目里的公告/通知类功能大致可以分成三类每一类的交互逻辑都不一样。第一类是全屏公告一般是游戏启动时弹出或者强更/维护时出现。这种公告信息密度高、内容偏长通常会有滚动区域、关闭按钮、跳转按钮比如“去充值”“去下载”。它对UI布局要求最高一般要放在独立的Canvas或者最高Sorting Layer上。第二类是右上角或者顶部的滚动公告类似跑马灯。这种公告文字短、轻量属于“广播型”信息不需要玩家操作自动滚动后消失。实现上不必走完整面板一个Text组件加Tween即可。第三类是图标红点公告就是在主界面右上角或者活动按钮上挂一个“公告”图标未读时带红点点击后弹出面板。这种形态通常需要配合公告的“已读/未读”状态做数据管理比前面两种多一个存储层。在项目里做之前我一般会先问策划或者运营一个问题这个公告内容是谁来填的什么时候填这个问题直接决定了你的公告数据层怎么设计。如果是运营每次发公告都找你改代码那模块做得再好也白搭。1.2 为什么我推荐用UI层实现而不是场景内物体还有一点容易踩坑有些人觉得公告系统就是“屏幕上出现一段字”于是直接挂在某个场景对象上用世界空间的Canvas来做。这在单个场景里跑没问题一旦切换场景比如从主城切到战斗公告面板就被销毁了。如果玩家在战斗结束后需要继续看公告你还得再处理跨场景保留问题。我的建议很简单公告系统一定要放在独立的UI层而且这个UI层属于全局管理层的一部分。具体点说就是单独建一个常驻的Canvas节点挂一个AnnouncementManager单例DontDestroyOnLoad新场景加载不影响它。这样无论是全屏公告、跑马灯还是弹出式toast都统一由这个管理器调度逻辑清晰也不受场景生命周期影响。层级上也要特别注意。游戏里常见的层级顺序是GameScene3D模型- WorldSpace Canvas - ScreenSpace Camera - 全局UI Canvas - 公告Canvas。公告Canvas的SortingOrder要比普通UI高因为它属于“强制打断”类的信息不能让玩家被其他UI或者特效挡住。用Screen Space Camera模式时可以把公告Canvas的Plane Distance设小一点这样它离摄像机更近显示时会被优先渲染配合较高的Sorting Order就基本不会出现被遮挡的问题。1.3 设计公告的核心数据模型关键步骤这部分可以说是整个模块的核心。我一开始做的时候图省事公告直接用string title加string content来存结果后面加需求什么有效期、优先级、是否自动弹窗、关联活动链接全都得加字段越改越乱。所以你现在让我重新做我会把公告数据模型定义成下面这个样子一开始就留好扩展位[System.Serializable] public class AnnouncementData { public string id; // 唯一id用于去重和已读标记 public string title; // 标题一般单行显示 public string content; // 正文支持富文本长度不限 public long startTime; // 生效时间戳秒 public long endTime; // 过期时间戳秒 public int priority; // 优先级数字越大越靠前 public bool autoPop; // 是否进入游戏后自动弹出 public string link; // 可选点击跳转所需的参数 public bool read; // 本地记录的已读状态 }这里面有几个字段最容易被遗漏但实际特别重要priority、autoPop、startTime和endTime。priority决定了多条公告同时存在时谁先显示比如强更公告优先级必须最高活动公告其次而系统通知最低。autoPop控制的是“进入游戏时要不要弹”这个字段很关键——如果你所有公告都自动弹玩家一上线被三四个弹窗砸脸非常劝退。正确做法是默认不自动弹只有在游戏版本维护后或者特别重大的公告才自动弹一次。startTime和endTime是给运营做定时公告用的。很多项目里的公告数据是通过网络配置下发的本地客户端只需要在时间内就展示过期就自动隐藏。没有这个字段你就得手动通知删除旧公告麻烦且容易出错。我把这套数据结构存JSON字段简洁明了然后在接入服务器配置时可以直接映射。字段命名最好跟服务器约定好免得每次联调都改代码。2. 数据与流程公告的加载、分发与状态管理定义好了数据模型接下来要考虑的就是这些数据从哪里来、怎么更新、怎么进到UI层去。这块如果理不清公告系统用起来会非常别扭。2.1 公告数据从哪来本地配置、远程配置还是服务器推送我在这三种方式上都踩过坑分别说一下适用场景。本地配置适合单机游戏或者开发自测。直接放一个announcement.json在Resources或StreamingAssets下游戏启动时读取。优点是简单缺点是内容更新必须发新包运营完全不接受。所以我一般只把它作为“开发期默认数据”兜底不在正式环境依赖它。远程配置是正式项目的主流。做法是利用现成的配置中心/资源服务器比如你们项目里已有的配置表下载流程把公告JSON作为其中一个配置项启动时拉取一遍版本号变了就更新。优点是不发版也能更新公告内容适合日常活动公告、维护通知。缺点是拉取是“一次性”的如果运营在玩家游戏过程中临时改了公告你这里的配置版本没变玩家看不到变化。服务器推送是运营需求最灵活的方案。常见做法是建立一条WebSocket或者走Server-Sent Events通道当服务器端公告数据发生变化时主动给客户端发一条指令比如OnAnnouncementUpdate客户端收到指令后再重新拉取公告数据。这种方案实现成本高一些但对运营来说是“实时公告”体验最好。结合我项目里的实际选择推荐的做法是拉取推送混合。启动时拉取一份最新公告列表同时建立推送通道监听公告变更收到变更通知后再拉一次完整列表更新本地缓存。这样就算推送没覆盖到启动拉取也能兜底。缓存非常重要不能每次弹公告都去请求网络否则弱网环境下面板打不开。2.2 公告消息的路由与协程调度公告数据到手之后不是一股脑全弹出来而是要走一个“调度器”。我封装了一个AnnouncementDispatcher它的职责是在公告数据集合中找到当前最高优先级且未过期的公告依次入队展示避免多个公告同时弹出来的混乱。核心逻辑大致是这样public class AnnouncementDispatcher { private QueueAnnouncementData displayQueue new QueueAnnouncementData(); public void Dispatch(ListAnnouncementData allData) { var validList allData .Where(data IsInTime(data) !data.read data.autoPop) .OrderByDescending(data data.priority) .ThenBy(data data.startTime) .ToList(); foreach (var data in validList) { displayQueue.Enqueue(data); } TryShowNext(); } private void TryShowNext() { if (displayQueue.Count 0 || isShowing) return; var data displayQueue.Dequeue(); isShowing true; UIManager.Instance.OpenPanel(AnnouncementPanel, data); // 等面板关闭后回调isShowing false继续TryShowNext } }有几个细节值得注意。isShowing这个标志位很关键它防止你连点按钮时连续弹出好几个公告面板。真实项目里连续弹出多个公告面板后果很折磨人玩家点掉一个立刻弹下一个文案都来不及看最后玩家暴躁地全关了。所以要加一个“当前显示中”的锁后到的公告排队等着。这个调度器看代码并不复杂逻辑重点就在“排队”和“锁状态”上。有些项目还会给公告面板加一个“冷却时间”比如同一个公告关闭后5秒内不允许再次弹出这种可以直接在read状态里做标记展示过一次就算已读不需要冷却。2.3 优先级、去重与过期处理公告列表在并发场景下会出现大量数据变更这里就考验状态管理了。优先级好理解但“去重”容易忽略一个问题两条公告的id相同但内容不同这其实是同一条ID占位被更新了你不能让玩家看到两个一样的ID而是应该替换旧内容重新计算已读状态。我加了一个简单的本地存储用PlayerPrefs记录已读公告id集合。每次调度公告前先比对这个集合已经读过的直接过滤掉。过期公告也不能只在配置更新时才清理我建议在调度前每次都跑一遍时间过滤因为玩家的客户端时间可能停留在上次打开公告之后这时过期公告依然显示就会很莫名其妙。关于“已读”里还有个坑如果公告内容变化了玩家之前读过老版本新版本要不要再显示我当时的方案是把公告内容的hash值也存下来如果hash变了说明内容有更新就有理由让玩家再看一遍也就是把已读状态重置。这样避免了玩家永远看不到更新内容的尴尬。3. 核心UI实现与动效细节数据结构理清楚后UI这块才能真正做得稳。公告面板看起来只是“背景标题Text滚动区域按钮”但实际做起来细节非常多我在这个部分下了很多功夫。3.1 公告面板整体结构搭建我的面板结构一般是这样组织的AnnouncementRoot ├── BG全屏半透明遮罩点击空白可以关闭 ├── Panel │ ├── TitleText │ ├── CloseButton │ ├── ScrollView │ │ ├── Viewport │ │ │ └── Content │ │ │ └── ContentText │ │ └── ScrollbarVertical │ └── LinkButton可选跳转按钮这里有几个结构层面的关键点。BG遮罩必须和Panel分开层级上BG在最底层Panel在上面。BG的点击检测要挂一个Button或者EventTrigger但不能把点击关闭事件也挂到Panel上否则玩家点面板内的滚动条/按钮也会触发关闭。ContentText不能直接放在Viewport下面必须挂在Content下面因为ScrollRect的滚动是基于Content的尺寸来计算的。Content最好用ContentSizeFitter组件并设置Vertical Fit为PreferredSize这样当文本增多时Content自动长高ScrollRect才能正确滚动。ScrollView里面的Viewport要加上RectMask2D组件避免Content超出边界时文字露到面板外面造成很low的穿帮。很多新手刚开始不知道加这个结果文字多了以后从半透明遮罩下面透出来视觉体验非常糟糕。标题部分如果只是普通Text可以不加LayoutGroup但如果你像我一样经常替换多语言建议标题外层套一层LayoutElement限制Preferred Width配合Horizontal Overflow设成Wrap不然长标题会把面板撑爆。3.2 公告文字的打字机效果与富文本处理公告面板上最容易做出质感又最容易出错的是文字展示效果。通常我们加一个逐字显示效果让文字像打字一样一个个蹦出来配合公告内容会比较生动不至于一眼全糊在屏幕上。我的打字机组件实现思路不复杂就是在协程里按帧改Text的text属性。但这里要特别注意一点Text组件每次修改content都会触发一次Canvas重建如果全篇公告1000字每秒打30个字每秒触发30次重建Mobile上会很烫。所以我建议打字速度不要太快20字/秒左右观感合适如果公告文本太长超过500字直接跳过打字机一步到位完整显示。这个判断逻辑就是一个长度阈值简单有效。富文本标签也要在打字机逻辑里特殊处理不然会出现奇怪的残留。比如color#FF0000警告/color如果你逐字截取字符串截到一半时就会出现colo这种残破标签Text组件直接不渲染后半个字符整个UI看起来像bug。我的写法是在截取时把未闭合的富文本标签全部匹配出来拼在截取片段后面临时闭合一下等订阅下一个字符时再闭合一次。这个算法网上有完整实现我贴一个简化版本private string GetTypingString(string fullText, int visibleCount) { string sub fullText.Substring(0, Mathf.Min(visibleCount, fullText.Length)); // 找出sub中所有未闭合的富文本标签补全闭合并置零颜色 int lastColorTagIndex sub.LastIndexOf(color); if (lastColorTagIndex 0 !sub.Contains(/color) || sub.IndexOf(/color, lastColorTagIndex) 0) { // 给未闭合标签补上闭合 sub /color; } return sub; }这个方案虽然简化但真实项目中还得多测几种情况尤其是同一个文本里有多个颜色标签或size标签时。我建议做一个公共的富文本工具函数专门负责截断和闭合标签不要在打字机里手写字符串逻辑否则Bug不好排查。3.3 进出场动画与倒计时自动关闭公告面板的进出场动画我这里多说几句。很多项目喜欢用简单的淡入淡出但公告这类信息想做出“引入注目”的效果光淡入不够。我推荐组合动画面板整体从屏幕中心略微偏下位置向上位移缩放0.95到1.0透明渐变三个参数同时做视觉上会有一种“弹出来”的冲击感同时配合BG遮罩从0到0.7透明度淡入。实现上我用DOTween简单panelCanvasGroup.alpha 0f; panelRect.localScale Vector3.one * 0.95f; panelRect.localPosition new Vector3(0f, -100f, 0f); Sequence seq DOTween.Sequence(); seq.Append(panelCanvasGroup.DOFade(1f, 0.25f)); seq.Join(panelRect.DOLocalMove(Vector3.zero, 0.3f).SetEase(Ease.OutBack)); seq.Join(panelRect.DOScale(Vector3.one, 0.3f).SetEase(Ease.OutBack)); seq.Join(bgCanvasGroup.DOFade(0.7f, 0.2f));进出场动画结束后如果你的公告设置了autoClose比如倒计时5秒自动关闭那就得在显示后起一个协程倒计时。倒计时要显示在按钮上我一般直接改按钮子物体的Text倒计时结束后触发关闭逻辑而不是直接Destroy可以让关闭动画播完再回收节点。如果你全屏公告场景不常需要自动关闭可以给Inspector暴露一个autoCloseSeconds默认-1表示不自动关。运营配置填了时间才自动关灵活些。3.4 用“反向遮罩”让公告区域更聚焦热词里提到的“Unity 反向遮罩组件”正好跟公告系统的强化显示相关。有时候游戏主界面UI元素太多玩家看公告时容易被其他按钮和数值分散注意力传统做法是叠一个全屏半透明遮罩但遮罩会把整个面板也一起变暗不够聚焦。反向遮罩Inverted Mask的意思就是遮罩默认挡住整个屏幕但在洞口的范围内是透明的让洞口里的内容保持高亮。用在公告系统上可以让玩家一眼就把注意力集中到公告面板区域背景UI整体压暗公告面板却是清晰的。实现上有几种方式最直接的是用Shader Graph写一个Stencil反向的Shader或者用UGUI的Mask组件配合自定义材质。如果你不想写Shader有一个取巧的办法遮罩层上用一个大Rect加一个同样位置、尺寸为目标区域的子Rect子Rect的Image颜色不用而是加一个MaterialPropertyBlock让它的渲染关掉背景色本质还是Shader换的。更省事的方案是直接用UIEffect或者Unity 2019.4的Mask组件配合RectMask2D做反向遮罩Core里其实自带了一个只是很多人没注意到。我项目的实现方式是公告面板的BG遮罩层挂一个自定义Shader材质Shader里写模板测试把屏幕中央以面板矩形为中心的区域给镂空出来。这个方案改起来最灵活不需要额外节点。如果你不想格式滞后我可以单独写一篇关于Unity反向遮罩的细节实现。4. 进阶玩法公告轮播、红点提示与多语言适配基础功能跑通后你会发现实际项目中运营要的不只是“一个弹窗”。多条公告怎么呈现、未读怎么提醒、海外版的文案怎么适配都是公告系统能不能真正落地的关键。4.1 多条公告轮播与手动翻页如果同时存在3条公告弹窗一个个排队弹固然是方案之一但有些项目希望公告面板能自己轮播比如一个面板下方有“1/3”页码指示玩家可以左滑右滑手动切换也可以自动每隔5秒切到下一条。轮播实现并不难。面板上挂一个ScrollRect把Content宽度设为n * 面板宽度每条公告占一页滑动结束时根据当前偏移量计算页码。关键点在于为了让玩家手动滑动后停止自动轮播需要在OnBeginDrag时停掉自动切换协程在OnEndDrag后再重启。如果不这样做会出现玩家正看到第二条自动轮播强制切到第三条非常影响体验。我最早做的时候用的是Horizontal Layout Group直接排子项后来发现公告内容长度不一致每页高度也不一样滑动时页面参差不齐很难看。后来改成每条公告数据提前生成一个独立的Content子节点每个子节点各自有ScrollView处理自己的滚动横向轮播只负责切换整页位置。这样每条公告的滚动高度是独立计算的互不干扰。4.2 红点提示与公告未读状态公告图标上加红点这是运营最爱提的需求。红点逻辑本身不难就是“有未读公告时显示全部已读后隐藏”但有几个容易疏漏的细节。第一红点状态要在公告数据刷新时更新不能让红点一直亮着。我是在ProcessAnnouncementData逻辑的最后调用UpdateAnnouncementBadge()遍历所有未过期公告如果存在未读状态的红点就SetActive(true)。第二玩家点击公告面板后红点必须立刻消失等间隔期间内滞后显示会显得很迟钝。第三如果公告面板是带滚动的玩家只看到第一条公告其他几条还没看你把红点全部清掉就不合理。所以我给每条公告单独记录read状态只有当玩家真正打开过该条公告的完整内容时才标记为已读。如果你家公告是不分页的长列表想实现“滚动到底自动全部已读”可以在OnScroll里检测Content顶部或底部的偏移量接近底时把所有子项标记为已读再更新一次红点。这个属于产品细节建议立项前跟策划对齐。4.3 多语言/文本适配与富文本安全公告系统做完中文版后接着就是多语言适配。最直接的方法是接入你们项目已有的本地化插件比如UGUI Localization或者I2 Localization公告数据里存的是key运行时根据当前语言取文案。这里要说一个很常见的问题不同语言文本长短差异巨大。中文短句可能20个字德语或俄语可能长出一倍。面板上的Text如果没有做溢出控制会导致内容重叠或者滚动条失效。我的做法比较笨但有效公告内容Text外层加LayoutElementContentSizeFitter同时限制最大行数超出部分用ScrollRect承载标题同理限制一行超出用省略号截断。为什么不直接限制面板尺寸因为不同语言下文本量差异太大强行限制会裁掉关键内容滚动更稳妥。富文本标签在本地化替换时也要小心多语言文本里如果带color这样的标签而翻译团队不小心漏配了结束标签UI直接崩。所以建议在多语言导出时写一个预处理工具对翻译文本做一遍标签配对校验缺失闭合标签的自动补全。这个工具很值得写因为线上发版后你没法让客户端自己去猜标签。5. 踩坑实录公告系统常见问题与排查技巧这部分是我最想分享的基本都是拿真实线上事故换来的教训。每一条都对应着一次玩家反馈或者测试报Bug照做能帮你少熬夜。5.1 中文乱码与字体不显示Unity默认的Dynamic Font对中文字符集支持不全尤其是用系统字体库时中文容易出现“口”字形方块。解决方案是给公告Text组件单独指定一个中文字体比如思源黑体/阿里巴巴普惠体并且把Font Style设置成Dynamic同时Include Font Data勾上。如果用旧版本Unity打包时没有把字体文件打进包体会导致本机测试正常、真机全空白。所以打Bundle前一定检查字体资源有没有被正确引用。还有一个细节Text网格空间不够时Unity会出现“缺字”现象尤其是发布到Android低端机上。尽量给Text设置一个合理的Font Size不要用默认的14不同分辨率适配时用CanvasScaler控制缩放而不是动态改Font Size。5.2 公告面板被模型或其他UI遮挡前面提到的SortingOrder是最容易忽略的。如果你用多个Canvas必须在Canvas组件里显式设置Sorting Order——数字越大越靠前。我遇到过一次公告面板的Canvas Sorting Order设成了0主界面的特效Canvas设成了10结果公告弹出来被一个武器特效挡住一半周报时候被策划当场抓出来。检查顺序一般是确认公告Canvas是否独立、确认它的SortingOrder高于所有游戏UI、再确认BG遮罩的Raycast Target是否挡住了底层按钮点击。另外如果场景里同时有Screen Space Overlay和Screen Space Camera模式的Canvas叠加顺序不是依据创建顺序而是依据SortingOrder和PlaneDistance排层级时务必统一配置。5.3 文本溢出、滚动条失灵与滚不动很多公告正文会粘贴带换行的长文本ContentSizeFitter配合ScrollRect时最容易出现“滚不动”问题。常见原因是Content的Pivot不在顶部默认为0.5,0.5导致滚动时文本从中间而不是顶部开始显示。修复就两步——把Content的Pivot设为(0.5, 1)锚点也设为顶部拉伸ScrollRect的VerticalNormalizedPosition初始化设为1即顶部。另外如果Content里还有一个VerticalLayoutGroup它和ContentSizeFitter会有一点竞争我的经验是公告面板Content不要用LayoutGroup直接用ContentSizeFitter做size驱动文字在子级Text上自行排布简单可靠。如果还是滚不动看下Viewport有没有挂RectMask2D如果没有ScrollRect计算视口尺寸会有误差导致滚到底时还有一段截断内容看不到。5.4 时间显示差8小时公告有效期和排序依赖时间戳最容易出的Bug就是本地时区问题。有些项目直接DateTime.Now往服务器传结果海外玩家和国内玩家看到的公告有效期完全不同甚至出现“公告已过期”但本地还没到期的诡异现象。统一做法是客户端一律使用Unix时间戳UTC秒数显示时再转本地时间。如果你的公告需要显示“x月x日开启”那就在数据层存startTime和endTime显示时用DateTimeOffset.FromUnixTimeSeconds转换。不要在客户端本地生成过期时间还直接用来排序——因为玩家可以改本地系统时间客户端本地时间不能作为判断条件只用于展示。5.5 性能Text重建与GC优化公告面板如果频繁弹出关闭Text反复SetText会造成UI重建卡顿。我观察过一个低端Android机上公告面板打开要卡300ms以上原因就是Text的RaycastTarget全开着每帧都在改字体材质。优化策略Text的RaycastTarget能关就关文字本身不需要接收点击。打字机效果下每帧改Text是必要的但可以用TextGenerator缓存或者用TextMeshPro替代UGUI TextTMP的重建开销更低排版也更好。公告列表数据如果从JSON反序列化得到尽量用JsonUtility或者litjson避免每次刷新都new大量临时对象。每次公告切换的GC峰值尽量控制在50B以下否则频繁切换会导致卡顿累积。如果你还在用Unity 2020以前的版本UGUI的重建优化空间不大建议直接换TMP。新项目用TMP是主流公告内容格式也更漂亮。5.6 插件冲突与异常排查最后说一个比较玄学的问题公告UI用的是DOTween做动画但有时候公告面板弹出的动画不触发或者卡在半透明状态。这类问题大部分不是代码逻辑问题而是Tween被别的模块打断或者CanvasGroup的alpha被内脏节点意外修改。排查方法很简单打开Profiler看UI模块如果某个节点有异常的Canvas Batch基本就是动画打断了Canvas重建。我的经验是公告面板的动画在入口处设一个幂等判断比如if (animating) return;同时每次打开公告前强制设置CanvasGroup.alpha1。这样即使上一帧动画没播完也能确保面板完整打开。如果你项目里同时引入多个Tween插件尽量统一用一个不然DOTween.KillAll()可能连带把无关动画一起杀光然后面板就永远处于隐藏状态。关于这个模块后续还能怎么扩展公告系统做完不是终点后面我通常会再往上叠一套“邮件系统”或者“活动推送”。核心的消息调度、已读状态管理、红点更新逻辑其实和公告模块高度重合。所以我在做公告系统时会把AnnouncementData抽象成IMessageData把读取、排序、已读这部分抽成独立类库后续做邮件系统时直接复用不用重新写一遍。公告系统这种模块看似简单但真正跑在线上会遇到各种你想不到的数据边界和UI细节。希望能给正在做或者打算做公告功能的你省下一点查资料和踩坑的时间。