Skip to main content

游戏公告

0. 本篇结论​

本篇为 WEN-14 / B2-B 文档整理稿，状态为 draft。原文 producer_review_needed / canonical_candidate 保留，未取得该功能的产品批准凭证。规则编号、参考图与原候选内容不等于已上线行为。

来源为 project2-docs @ ec43be0e13c8624cfafd36c0fd803f3b89733fff 的 docs/planning/project2-game-feature-library-v1/features/game-notice.md；获取时间 2026-10-13（UTC），通过 Git 固定提交阅读。共用归属、来源清单、冲突证据与待裁定项统一见运营总览。本篇后续“必须”“验收”均属于待审规则/预留验收，未在本批执行游戏或平台验证。

1. 功能定位​

公告系统用于运营向玩家展示游戏内通知、活动说明、版本公告或临时维护提示。

2. 范围​

In Scope：公告创建、删除、列表、按平台拉取、游戏内展示、公告通知、跑马灯全服广播、后台手动公告。

Out of Scope：邮件、弹窗礼包、活动规则。

3. 玩家入口、解锁与提示​

公告可在登录、主界面或公告入口展示。是否强制弹出和展示频率需运营规则确认。

4. 核心玩家流程​

  1. 玩家进入游戏或打开公告入口。
  2. 客户端拉取游戏内公告列表。
  3. 展示标题、正文、参数化内容和有效期。
  4. 运营创建或删除公告后，客户端收到通知或下次拉取更新。

5. 核心规则​

5.1 公告基础规则​

  • GAME-NOTICE-R-001：公告支持创建、删除、列表查询。
  • GAME-NOTICE-R-002：公告可能区分平台。
  • GAME-NOTICE-R-003：游戏内公告与后台公告列表可能有不同接口。

5.2 跑马灯分类与触发​

  • GAME-NOTICE-R-004：跑马灯用于向所有在线玩家广播重要信息，支持玩家行为触发和运维后台手动触发。
  • GAME-NOTICE-R-005：跑马灯按触发方式、优先级、显示次数和有效期分类。触发方式包括玩家行为触发和后台手动触发；优先级包括紧急、普通、低；显示次数包括单次和循环；有效期包括即时和定时。
  • GAME-NOTICE-R-006：玩家行为触发候选包括抽到 SSR/UR 英雄、单笔充值达到指定金额、战力突破、等级突破、公会创建等。
  • GAME-NOTICE-R-007：后台手动触发支持系统公告、活动公告、定时发送、紧急置顶、选择平台和服务器。

5.3 队列、播放与冷却​

  • GAME-NOTICE-R-008：紧急公告置顶显示并可打断当前播放；同优先级公告按时间顺序排队。
  • GAME-NOTICE-R-009：最多缓存 50 条待播放公告。单条公告候选最多显示 3 次；同一玩家触发公告冷却候选为 5 分钟，同类型公告全局冷却候选为 30 秒。
  • GAME-NOTICE-R-010：跑马灯播放规则候选：文字从右向左滚动，滚动速度 100 像素/秒，每条公告显示 10 秒，公告间隔 2 秒。

5.4 后台编辑与多语言校验​

  • GAME-NOTICE-R-011：后台发送公告时，优先级和显示次数只能单选；未填具体结束时间时，按显示次数处理。
  • GAME-NOTICE-R-012：多语言公告只编辑一种语言时，需要提示未编辑其他语种是否继续。任意必填项未处理时，点击发送提示公告设置不完整。时间格式使用北京时间的年/月/日/时/分/秒。

5.5 操作矩阵​

N/A。当前不在策划案正文中复述核心玩家流程；进入 PLAN 时，仅对状态变化、消耗/产出、奖励发放、跨系统反馈或失败反馈补齐操作矩阵。

6. UI 状态与交互​

6.1 界面图与交互说明​

以下图片为待评审参考图，已按图片锚点和附近文字绑定到页面/状态；状态均为 仅参考，最终布局、尺寸、按钮位置和视觉风格以制作人/UI 评审确认为准。

图 01：### 跑马灯后台公告面板​

游戏公告 - ### 跑马灯后台公告面板

  • 图状态：仅参考
  • 关联页面 / 状态：### 跑马灯后台公告面板
  • 关联交互 / 状态说明：### 跑马灯后台公告面板；【功能管理】下增加【跑马灯通知】，点击打开跑马灯编辑窗口

图 02：【功能管理】下增加【跑马灯通知】，点击打开跑马灯编辑窗口​

游戏公告 - 【功能管理】下增加【跑马灯通知】，点击打开跑马灯编辑窗口

  • 图状态：仅参考
  • 关联页面 / 状态：【功能管理】下增加【跑马灯通知】，点击打开跑马灯编辑窗口
  • 关联交互 / 状态说明：选择平台和服务器，对特定服玩家发送公告；优先级、显示次数的选框都只能选一个；未填具体结束时间的，按勾选的显示次数处理；跑马灯发送时，如果只编辑了一种语言，提示【未编辑其他语种，是否继续？】，确定就只发送已编辑的语种。取消就关闭提示，返回编辑页面

图 03：- 跑马灯条：顶部固定位置，文字滚动显示​

游戏公告 - - 跑马灯条：顶部固定位置，文字滚动显示

  • 图状态：仅参考
  • 关联页面 / 状态：- 跑马灯条：顶部固定位置，文字滚动显示
  • 关联交互 / 状态说明：### 跑马灯主界面；* UI元素说明：；- 跑马灯条：顶部固定位置，文字滚动显示；- 公告图标：点击展开历史公告列表；- 紧急标识：红色边框/背景，置顶显示

6.2 页面结构与交互​

需要公告列表、公告详情、关闭、已读状态、空状态、网络失败提示、跑马灯条、公告图标、历史公告列表和紧急公告样式。跑马灯条固定在顶部，文字滚动显示；公告图标可展开历史公告；紧急公告使用红色边框或背景。

6.3 UI 页面状态表​

N/A。当前仅保留已绑定页面/状态的参考图和页面结构说明；具体可执行状态在 UI 评审或 UI brief 中确认。

7. 配置、数据与 Contract​

本节只记录策划案需要的逻辑数据与跨部门 contract，不预设物理配置表、协议文件、service 文件或 仓库落点。正式命名、字段名、接口名、协议对象名、文件名和仓库落点进入执行前由 Work Package 的 contract-registry.yaml、execution brief 和对应执行任务确认。

7.1 策划数据需求​

策划数据需求只描述逻辑数据域、逻辑字段或规则语义，不等同于配置表字段名、协议字段名或数据库字段名。正式字段命名进入 contract-registry.yaml、execution brief 和对应执行任务确认。

数据域逻辑字段 / 规则设计含义必填 / 边界产出责任
公告基础数据公告 ID、标题、正文、平台、展示时间、状态、参数定义公告标题、正文、参数、平台、时间和生效状态进入执行前补齐默认值、边界和可选性Planning / Ops
跑马灯规则触发方式、触发条件、优先级、次数、冷却、队列上限定义触发、优先级、显示次数、有效期和冷却进入执行前补齐默认值、边界和可选性Planning / Ops
多语言公告语言版本、必填检查、缺失语种提示、北京时间格式定义公告多语言编辑和缺失提示进入执行前补齐默认值、边界和可选性Planning / Ops

7.2 运行时数据与接口需求​

Contract设计含义使用方说明
公告列表与详情向客户端同步公告列表、创建和删除状态服务端 / 客户端 / Ops游戏内公告和后台公告可有不同入口
跑马灯播放队列管理在线广播、置顶、打断和循环播放服务端 / 客户端紧急公告可打断当前播放
后台发布操作支持运营手动发布和定时发送Backend / Ops需校验必填项和权限

7.3 跨部门 Contract 命名清单​

Contract 类型逻辑对象命名状态阻塞阶段说明
配置数据公告模板、跑马灯触发、优先级、冷却和多语言规则待 PLAN 确认PLAN 前不预设物理配置表名
协议 / API公告创建、删除、列表、游戏内公告、跑马灯通知待 PLAN 确认执行前由服务端 / 客户端 / 运营 brief 确认
错误码公告配置不完整、时间非法、权限不足、语种缺失确认待 PLAN 确认执行前需要后台与客户端提示
语言 Key公告正文、跑马灯模板、后台提示待 PLAN 确认执行前进入语言 brief

8. 系统边界​

方向负责内容备注
Planning逻辑数据、数值、文本需求、资源需求进入执行前由 PL 任务细化
服务端协议、校验、持久化、奖励发放、幂等与安全仅相关功能需要
客户端UI、交互、表现、本地状态、红点和跳转仅相关功能需要
美术图标、模型、特效、音频和导出资源仅相关功能需要
Ops / GM后台配置、运营投放、公告、补偿和数据看板仅相关功能需要

客户端与表现​

客户端侧只记录玩家可见界面、交互反馈、表现刷新和本地展示需求；具体目录、类名、命令和事件由 UI / 客户端 brief 确认。

美术与音频需求​

需要公告面板、公告入口、重要公告标识。

9. 数值、经济与奖励​

无直接经济产出；若公告附带奖励，应转为邮件或活动。跑马灯可曝光充值、活动和抽卡结果，但不直接发放奖励。

10. 异常、安全与运营边界​

10.1 异常与安全​

运营公告创建/删除属于生产运营操作，必须有权限控制和审核。跑马灯需处理公告内容过长、敏感词、网络延迟、重复公告和队列满：内容过长候选截断至 100 字并显示省略号；敏感词可用 * 替换；网络恢复后同步本地缓存；同内容 5 分钟内不重复显示；队列满时丢弃低优先级旧公告。

10.2 埋点与运营​

本功能的候选采集行为统一见埋点与数据分析的业务事件目录。本篇只拥有业务触发和状态含义；事件名、属性类型、归因与跨端去重归埋点文档。候选目录不代表已有正式事件或已接入平台。

11. Feature Relations 与回归范围​

Feature Relations​

关联账号登录、主界面、运营活动、邮件。

回归范围​

以 Feature Relations 影响功能、核心玩家流程、配置与系统边界为基础；进入执行前由 PLAN / QA brief 细化最小回归范围。

12. 验收标准​

12.1 关键验收结论​

公告创建、删除、拉取、展示、平台过滤和通知刷新正确。

补充验收：跑马灯玩家行为触发、后台手动触发、优先级打断、队列排序、显示次数、有效期、冷却、多语言提示、必填校验、敏感词替换、过长截断、历史公告和网络恢复同步均需验证。

12.2 规则验收清单​

规则正文集中在本篇第 5 节，原有 *-R-* 编号保留。原第 12.2 节逐条重复正文已合并到第 5 节；未来人工验收按这些编号记录结果，本批未验证也未勾选。共用规则按运营总览的归属引用，不另立副本。

12.3 执行层验收​

  • 如填写操作矩阵，成功路径、失败场景、玩家反馈和状态权威均已覆盖。
  • 如填写 UI 页面状态表，页面 / 弹窗状态均已覆盖，或明确标记为 N/A。
  • Section 7 中标记为 PLAN 前或执行前阻塞的 contract 已在 contract-registry.yaml、execution brief 或执行任务中确认。
  • 相关 Feature Relations 回归通过。

13. 待澄清问题 / Open Questions​

  • 是否需要公告已读持久化、强弹规则和优先级。
  • 跑马灯性能目标候选为推送延迟小于 100ms、支持 10000+ 在线玩家接收、历史记录保存 7 天、滚动 60 FPS；是否作为正式验收指标需要确认。

14. 变更记录​

日期版本修改人变更摘要
2026-10-13draft / WEN-14AutoDev Symphony保留原审核状态与固定来源；明确共用归属及待裁定问题；合并重复规则清单与空图入口，不变更玩法
2026-06-16v0.2Codex补充规则编号、操作矩阵、UI 状态表、逻辑字段和执行层验收锚点
2026-06-16v0.1Codex按新版功能策划案模板重排章节；保留既有规则内容并映射参考图