Skip to main content

游戏公告与跑马灯

覆盖游戏公告列表和全服跑马灯的玩家表现、触发/排序、运营配置。普通公告数据已见客户端模型;跑马灯完整播放与管理链路未获本次运行证据。两者不能仅因同属“公告”就视为同一已实现功能。源文档批准状态 unknown。

公告列表​

普通公告包含公告 ID、平台/服务器范围、标题和内容、优先级、创建时间及有效时间等信息。登录摘要可能只给 ID,正文需列表请求补全;新增/删除推送更新本地数据。运营创建、删除、查询与玩家列表请求属于不同权限/用途,不能把管理接口直接当作客户端入口。

frontend 7f0636c9 的 Features/GameNotice/Model/GameNoticeModel.cs 维护公告副本字典,支持全量替换、合并和删除,展示顺序为优先级降序→创建时间降序→ID降序。GetGameNoticeListCommand、SCGameNoticeGetListHandler、SCNoticeGameNoticeNewHandler、SCNoticeGameNoticeDeleteHandler 是请求/推送入口。当前普通公告“同级最新优先”与下节跑马灯“同级按时间排队”不是自动等价规则。

跑马灯触发与展示​

类型来源条件/示例级别内容参数
抽卡SSR/UR,高玩家名、英雄名
战力突破达配置里程碑,高;100万为示例玩家名、战力
等级突破达特定等级,中;100级为示例玩家名、等级
公会创建创建公会,中玩家名、公会名;当前公会未实现,不能据此声称可触发
充值单笔达到指定金额,低;VIP10只是文案例子玩家名、充值/VIP相关参数
系统/活动运营后台手动或定时;维护紧急、活动高各语言正文与活动/维护参数

方案分类有触发方式(玩家/后台)、优先级、播放次数(单次/循环)、有效时间(即时/定时)。优先级总表写紧急/普通/低,类型表又用高/中/低;整数映射尚未统一。

行为方案明确参数
队列最多50条待播;同优先级按时间排队;满队列淘汰低优先级旧消息
紧急消息置顶并打断当前播放;顶部紧急红色样式
重复通用规则每条最多3次;同内容5分钟去重
播放右→左,100像素/秒,每条10秒,间隔2秒
频率同一玩家触发冷却300秒;同类型全局冷却30秒
内容最长100字符,超长截断加省略号,敏感部分用星号处理
恢复断线重连同步公告;无消息时不残留上一条
历史顶部跑马灯旁历史入口,保留7天

速度、固定10秒和100字符在不同屏宽下是否能同时完整呈现,来源没有给自适应公式,不自行补定。

顶部跑马灯表现示意

单行顶部消息包含玩家名和事件内容,图仅作表现参考。

配置与运营交互​

config_marquee.csv 方案字段为 ID、TriggerType、TriggerCondition、Priority、ContentTemplate、MaxShowCount、Cooldown、Desc。模板插入玩家名、英雄名等参数并按语言展示;昵称属于参数,不能当多语言 key。另一张 config_marquee_trigger.csv 以 ID、TriggerKey、ParamType、ParamValue、Desc 定义触发条件:例如 TriggerKey=hero_ssr、ParamType=rarity、ParamValue=3;hero_ur对应rarity=4。

配置示例优先级/次数/冷却冲突说明
SSR,hero_ssr3 / 3 / 300秒品质示例为3
UR,hero_ur3 / 5 / 300秒品质示例为4;5次与通用最多3次冲突
手动紧急3 / 1 / 0与自动SSR/UR整数同为3,需明确紧急打断依据
手动普通2 / 3 / 0不据示例认定正式配置已发布

运营管理入口为【功能管理】→【跑马灯通知】,选择平台、服务器、优先级和次数(优先级/次数为单选),发送/结束时间格式为年/月/日/时/分/秒(北京时间);结束时间可不填,未填时按勾选显示次数处理。多语言内容未全部填写时确认“继续只发已填写语言”或取消;其他必填项缺失提示“公告设置不完整”。列表/编辑/删除状态应反映真实后台结果。

运营发送表单原型

原型给出平台/服、多语言正文、优先级、次数、立即/定时、结束时间、发送/取消。“永久/结束至”对应结束时间选择,未填具体结束时间时按次数处理;循环显示与通用最多3次仍需要统一。图中的简中/英文/越南语不自动代表最终公告支持语言集合。

方案还提出单次响应低于100ms、10000+在线、60FPS等目标;这是性能目标,不是实测数据或本次验收结论。

已核实差异与来源​

frontend Infrastructure/MultiLanguage/Config/Marquee.md 只给 marquee_no_announcement、marquee_announcement_title 的多语言提案(中/英/日/韩),并注明未使用;不足以证明跑马灯 UI、历史入口、后台调度与广播完整落地。本次没有确认全部自动触发、队列/打断/频控和多语言运营链路。

整合旧 features/game-notice.md;飞书 YzcgsyB8phptYtt2PUXc4kQEn37 全部分类、规则、配置、管理与性能目标(2026-10-13 阅读件);上述 frontend 公告模型和多语言文件。原后台侧栏图片只有入口位置,已转写为运营入口说明;不保留重复的表格截图。

现有定位入口为公告列表命令与增删推送 Handler;本次未定位完整跑马灯的独立现有测试、未运行测试、未新增或扩写测试。本地验证:根据项目策略禁止执行。