PLAYER EXPERIENCE · IMPLEMENTATION SPEC

球员每日表现 · 产品需求文档 | 范围:Daily Player Feed、比赛证据与 Action map

文档口径 本文只描述页面实际存在的元素与状态。未列出的标题、图标、辅助文案和控件均不进入页面;数据缺失或条件不满足时,按“边界处理”中的明确状态执行。

1

Top Performers

优秀球员入口、比赛筛选与当前球员池

Daily Player Feed 批注参考图
可直接操作:切换首页入口、比赛日日期、优秀球员和当前球员。查看完场评分前三示例 ↗ · 查看单场比赛示例 ↗

展示位置

  • 入口位于首页顶部横向 Tab,Match day 固定在 TODAY 左侧,并与 TODAY 同级。
  • 进入后页面标题为 Top Performers,下方依次为日期栏、比赛列表、优秀球员条和当前球员主卡。

展示内容

  • 日期栏默认展示最近 7 个有比赛的历史比赛日和最近 3 个有比赛日期。
  • 日期项显示相对标签(Yesterday / Today / Tomorrow 或星期)和“日 + 月份”;当前日期使用红色下划线与红色日期。
  • 日期栏下方显示横向比赛列表;有多场比赛时,最左侧显示 All。
  • All 用于取消单场筛选,恢复当日全部优秀球员;当日只有一场比赛时隐藏 All,默认选中该场比赛。
  • 选中比赛后,比赛列表自动横向滚动,将该比赛定位到可视区域约左侧 38% 的位置,同时保持右侧后续比赛可见;比赛列表与优秀球员条通过共享红色背景和选中态体现筛选联动。
  • 比赛项显示双方队徽和比分;FT 状态显示 FT,进行中显示比赛分钟(如 72′),未赛显示 VS 和开赛时间(如 20:00)。
  • 比赛项排序固定为:最近已结束 → 进行中(接近结束优先)→ 未开始(接近开赛优先)。
  • 排序示例:18:55 已结束 → 81′ 进行中 → 20:00 未开始;已结束按结束时间倒序,进行中按比赛分钟倒序,未开始按开赛时间正序。
  • 优秀球员条优先展示系统评分不低于 7.5的球员,并限定在当前比赛筛选范围内;若某场比赛已结束且无人达到 7.5 分,则展示该场双方球员中系统评分最高的 3 位。包含头像、队徽、短名、位置和系统评分;当前球员用红色描边选中。

取数

  • 读取赛程、比赛状态、联赛、开赛时间、比赛日期、主客队、比分和球员表现页可用性。
  • 日期比赛集 = 优先级前二的比赛和优先级前三球队参与的当日比赛,按比赛去重。
  • 读取本场双方全部已出场球员的有效系统评分,用于筛选与排序。

计算

  • 从当前日期向前回溯,只保留有比赛且有可用球员表现的日期;最多取 7 个,早于当前日的按时间升序展示。
  • 向未来扫描,只保留有赛程的日期,取最近 3 个并按时间升序展示。
  • 首次进入时,从当天开始向前查找,默认定位到最近一个已有已结束比赛且有球员表现数据的日期;未来赛程日期不参与默认回退。
  • All 显示当日全部优秀球员,单场选项显示归属该场比赛且当前已有数据的球员。
  • 逐场筛选系统评分 ≥ 7.5 的球员;已结束且无人达标的比赛取本场评分前三。All 合并各场候选后按系统评分降序最多展示 8 名;单场正常最多 5 名,兜底最多 3 名。

交互

  • 点击 Match day 进入每日表现页。
  • 点击日期刷新优秀球员、主卡、比赛证据、Match stats、Action map 和 Team of the day,并回到页首。
  • 点击比赛列表中的 All 或已结束比赛后立即刷新优秀球员条和当前球员。
  • 进行中比赛逐场判断球员数据可用性:已有数据的进行中比赛可直接筛选球员;暂无数据的进行中比赛与未赛比赛在点击时于屏幕中央显示短提示(No eligible players to display / Match not started),并保持当前球员和比赛上下文不变。

边界处理

  • 历史比赛日不足 7 个时继续向更早日期查找,查到数据源尽头即停止。
  • 切换日期后,多场默认选中 All,单场默认选中该场比赛。
  • 只有一场比赛时隐藏 All,默认选中该场比赛
    单场比赛:隐藏 All,默认选中该场比赛,展示本场球员条与当前球员主卡。
  • 评分恰好 7.5 视为达标;进行中比赛不启用前三兜底。已结束比赛有效评分不足 3 人时按实际人数展示,同分按球员姓名排序。
  • 若历史日期和未来日期均无法获取数据,Match day 入口不显示。
2

Player Spotlight

当前球员身份、比赛数据与评分层级

Player Spotlight 批注参考图
可直接点击优秀球员;切换后主卡和下方模块同步更新。

展示位置

  • 位于优秀球员条之后、Period Highlights 之前。
  • 主卡展示当前球员的姓名、球队、位置、本场统计,以及用户评分和系统评分。

展示内容

  • 显示球员头像、全名、所属球队、队徽、位置、出场分钟、进球、助攻和 xG。
  • 出场分钟前展示计时器图标,助攻前展示足球鞋图标;0 次助攻同样展示图标和数值 0。
  • 并列展示 User rating 与 System rating,各保留一位小数;用户评分附有效评分数量,系统评分标注 Match model。

取数

  • 球员主数据:姓名、头像、球队、队徽和位置。
  • 本场统计:出场分钟、进球、助攻和 xG。
  • 评分数据:本场用户评分均值、有效评分数量和系统模型评分。
  • User rating 使用本场用户评分均值;System rating 使用同一比赛、同一球员的系统评分;两者不可互相回填。

计算

  • 评分范围 0–10,显示一位小数;xG 显示两位小数;分钟使用整数并追加 ′。
  • 0 进球和 0 助攻是有效值,显示对应图标和数值 0。

交互

  • 点击优秀球员条切换当前球员;主卡、评论、指标、Action map 与 Team of the day 同步刷新。

边界处理

  • 出场分钟、进球、助攻和 xG 获取不到时,显示 -;有效数值 0 正常显示为 0。
  • 分钟、进球、助攻和 xG 缺失时显示短横线
    分钟、进球、助攻和 xG 缺失时,各字段显示 -。
  • 球员头像或球队队徽获取不到时,分别显示默认头像 icon 或默认队徽 icon。
  • 没有用户评分或有效评分人数为 0 时,隐藏整个 User rating 区块(标题、分数和人数);System rating 正常展示。
  • 比赛进行中,主卡的比分、比赛分钟及球员本场数据随数据源实时更新,无需手动刷新;比赛结束后更新为最终数据。
  • 无用户评分时隐藏整个用户评分区块,保留系统评分
    无用户评分:隐藏整个 User rating 区块,System rating 正常展示。
3

Period Highlights

与本场比赛及当前球员关联的 GIF 回放

Period Highlights 批注参考图
可横向滑动浏览与本场比赛及当前球员关联的全部 GIF 回放。

展示位置

  • 位于 Player Spotlight 之后、User Ratings & Reviews 之前。

展示内容

  • 展示与本场比赛及当前球员同时关联的全部 GIF 回放卡。
  • 每张回放卡展示 GIF、动作类型和事件时间,例如 43′。

取数

  • 读取当前球员和比赛的事件 ID、动作类型、事件时间、媒体 URL、封面和可用状态。

计算

  • 事件时间统一使用比赛分钟与补时格式,例如 43′、45+3′、90+4′。
  • 回放卡按事件时间倒序排列,最新事件在前。

交互

  • 支持左右横向滑动浏览全部回放卡。

边界处理

  • 本场比赛及当前球员没有匹配的 GIF 时,Period Highlights 模块不显示。
4

User Ratings & Reviews

当前球员的用户评分与高赞评论

User Ratings & Reviews 批注参考图
展示当前球员的用户评分和最多 3 条高赞评论。

展示位置

  • 位于 Period Highlights 之后、Match stats 之前。

展示内容

  • 展示用户综合评分,以及点赞数最高的最多 3 条评论。
  • 每条评论包含作者头像、用户名、星级、点赞数和评论正文。
  • 底部展示 View all reviews。

取数

  • 读取当前球员在本场比赛中的有效用户评分均值、评分数量,以及审核通过的评论数据。

计算

  • 评论按点赞数降序排列;不足 3 条时展示全部,超过 3 条时取前 3 条。同赞数按发布时间降序。

交互

  • 点击 View all reviews 进入本场比赛该球员的评分详情页。

边界处理

  • 评论列表和数量只统计审核通过且仍有效的评论。
  • 有效评论少于 3 条时按实际数量展示。
  • 当前球员在本场比赛中没有有效评论时,User Ratings & Reviews 模块不显示。
5

Match Stats

当日前十表现的默认视图、分类指标与排名下钻

Match stats 批注参考图 传球字段原值与缺失数据防守与犯规字段指标排名弹层:队徽与位置字母位于头像两侧,整行进入球员资料页
图示与本模块 Demo 使用完整演示数据;可切换三个分类查看全部指标并点击排名。

展示位置

  • 位于 User Ratings & Reviews 之后、Action map 之前。
  • 标题区显示 Match stats 主标题,作为“本场数据”的英文文案。

展示内容

  • 默认展示 Standout data;另一项为 All dimensions。
  • Standout data 从当日有效指标中,取排名 #1–#10 且数值大于 0 的指标,按名次、再按下列分类顺序最多显示 4 项。没有符合项时隐藏此 Tab,默认展示 All dimensions。
  • Attack(进攻):Shots、Shots on target、Expected goals (xG)、Shots inside box、Shots outside box、Big chances missed、Dribbles、Successful dribbles、Dispossessed、Was fouled。
  • Playmaking(组织):Passes、Passing accuracy、Key passes、Big chances created、Long balls、Accurate long balls、Crosses、Accurate crosses。
  • Defence(防守):Tackles、Clearances、Interceptions、Duels、Duels won、Aerials won、Aerials lost、Fouls。

取数

  • 按比赛日期、比赛 ID、球员 ID 读取本场统计;Big chances created、Big chances missed 读取数据源对应字段,未提供时不展示。
  • Shots (on Target) 拆成 Shots 与 Shots on target;Dribbles (succ.) 拆成 Dribbles 与 Successful dribbles;Shots outside box 使用总射门减禁区内射门;其余指标对应数据源同名字段。
  • Passing Accuracy 的示例原值为 4,当前保留原值、不追加 %;接口单位确认前不换算、不参与排名或亮点。
  • Demo 使用完整演示数据展示全部指标,包括 Big chances created 和 Big chances missed;演示值不代表真实比赛数据。实际取数缺失时按边界规则隐藏。

计算

  • Shots outside box = Shots − Shots inside box;两项均为有效非负整数且总射门不小于禁区内射门时才计算,否则隐藏。xG 保留两位小数,计数项显示整数。
  • 各指标独立按数值降序排名。
  • Big chances missed、Aerials lost、Dispossessed、Fouls 仅展示原值,不参与排名和 Standout data。Passing accuracy 待单位确认后另行确定排名规则。

交互

  • 切换 Standout data / All dimensions 时保持当前球员和日期;切到 All dimensions 后使用当前分类最后一次选择。
  • 点击指标行或排名标签打开 Bottom sheet,展示名次、球员头像与姓名、比赛双方、比分及指标值;头像左侧显示所属球队队徽,右侧以 ST、CM、LW 等字母显示位置。
  • 点击排名中的整行球员区域,进入该球员的资料页;关闭弹层后恢复原日期、分类、指标和滚动位置。

边界处理

  • 获取不到的字段整项隐藏(含名称、数值和排名);有效的 0 正常显示为 0,不作为 Standout data。当前分类无有效字段时不展示指标列表。
  • 不参与排名的指标不显示排名标签,点击不打开排名弹层。
  • 不同位置统一使用 Attack、Playmaking、Defence 三个分类。
6

Action Map

Shot、Pass、Defence、Save 四种动作证据

Action Map 批注参考图
可直接切换 Shot / Pass / Defence / Save;Shot 时间按钮会更新详情。

展示位置

  • 位于 Match stats 之后、Team of the day 之前。
  • 该模块直接沿用球员比赛卡内 Action map 的展示图示、Tab、统计和交互,不另做一套视觉。

展示内容

  • 保留 Shot、Pass、Defence、Save 四种动作视图;每类视图中的图示、统计口径、筛选入口和时间详情均与比赛卡内的 Action map 一致。

取数

  • 读取当前球员、比赛和时段的动作事件,并复用比赛卡 Action map 的字段与数据源。

计算

  • 统计和筛选计算直接复用比赛卡 Action map,不在此模块重复定义另一套口径。

交互

  • 切换 Tab、类型筛选、点位和时间详情时,保持与比赛卡 Action map 相同的交互结果。
  • 切换模块时保留当前球员、日期和比赛上下文。

边界处理

  • 无动作数据时沿用比赛卡 Action map 的空状态处理。
7

Team of the Day

当日合格球员的 4–3–3 阵容

Team of the Day 批注参考图
头部选中的球员在阵容内高亮;点击任意球员进入球员资料页。

展示位置

  • 位于 Action map 之后,是每日表现页的最后一个内容模块。
  • 使用单张 4–3–3 球场呈现 11 个位置;头部当前选中的球员以金色描边和姓名高亮标记。

展示内容

  • 每个入选位置显示球员头像、所属队徽、位置、评分和短名;队徽位于头像左下角,位置位于头像右下角。

取数

  • 读取当前日期全部已结束比赛中的合格球员、位置、评分、球队、头像和队徽。
  • 候选必须出场至少 60 分钟且有有效比赛评分。

计算

  • 按固定 4–3–3 位置展示:LW、ST、RW、CM、CM、CM、LB、CB、CB、RB、GK;三名中场从 CM/DM 候选球员中选择。
  • 每个槽位取符合角色的最高评分球员,候选评分必须不低于 7.0;同分按出场分钟降序。
  • Team of the Day 在合格球员可组成完整 4–3–3 且人数达到 11 人时显示。

交互

  • 点击场上球员进入球员资料页。
  • 头部当前选中的球员在阵容中保持高亮:头像使用金色描边,姓名使用高亮底色。
  • 球员按钮提供完整可读名称,键盘可聚焦;触控区域不小于 44px。

边界处理

  • 可组成完整 4–3–3 的合格球员不足 11 人时,Team of the Day 模块不显示。
8

Upcoming Matches

未开始与进行中的比赛样式

Tomorrow 未开始比赛与关注球员
默认展示 Tomorrow;点击 Today 查看今日有比赛、暂无符合条件球员的边界示例。

展示位置

  • 用户选择未来比赛日后,作为页面的主要内容显示在日期栏下方。
  • 今日有比赛,且还没有符合条件的球员可供展示时,展示赛程卡片,并更新比赛状态与比分。

展示内容

  • 未开始比赛显示联赛徽标、联赛名称、当地开赛时间、双方真实队徽、球队名称和 VS;按开赛时间升序排列。
  • 比赛进行中,且没有符合条件的球员可供展示时,右上角显示红色圆点与比赛分钟(如 72′),双方球队中间显示实时比分(如 2–0);下方保留 Players to watch。
  • 每场比赛卡片内部、比赛双方下方显示独立的 Players to watch。
  • 球员卡片采用紧凑横滑布局,显示头像和居中姓名;队徽位于头像左下角,位置字母位于头像右下角。

取数

  • 读取赛程、联赛及联赛徽标、球队及队徽、开赛时间、时区、比赛状态、比赛分钟、实时比分和比赛 ID;Players to watch 另取球员评分及能力值。

计算

  • 只展示有赛程的日期;未来从当前日期向后取最早的 3 个有效比赛日。
  • 比赛按当地开赛时间升序排序;跨时区比赛按联赛所在地时间显示,并明确日期归属。
  • 每场比赛的 Players to watch 从双方球队可用球员中选取:有评分时使用评分,没有评分时使用能力值,按对应数值降序取前 5 名。

交互

  • 点击日期切换赛程;当前日期保持在日期栏可见区域。
  • 点击 Players to watch 中的球员卡片,进入球员资料页。

边界处理

  • Today 边界示例:今日有比赛,且还没有符合条件的球员可供展示;图中包含一场进行中比赛和一场未开始比赛。
  • Today 暂无符合条件球员:进行中与未开始比赛
    Today:暂无符合条件球员时,展示一场进行中和一场未开始比赛,保留 Players to watch。
  • 延期、取消和中止比赛展示对应状态标签。