比赛 STATS 增强需求文档 Demo · Unified Action map 独立版

1

Unified Action map

官方 Stats · Action map 独立 Tab · 默认定位 Shot

LIVE INTERACTIVE PROTOTYPE时段、动作、球员和事件均可切换

Action map 作为官方 Stats 顶部独立 Tab，选中后直接展示完整 Action map；Shot 直接展示球员射门卡片。

展示位置

  • 位于比赛详情页 Stats 顶部入口栏；从左到右依次为 Action map、Players、Match、1st Half、2nd Half，Players 与 Match 相邻。
  • 一级 Tab 从左到右为 Shot、Pass、Defence。
  • Action map Tab 选中后，入口栏下方展示 Action map，默认定位 Shot。

展示内容

  • 同一 Action map 提供 Shot、Pass、Defence 三个一级 Tab。
  • Shot按参考图展示球员基础信息、评分、本场汇总、独立球门、半场射门地图、事件时间轴、六项详情和 Match statistics；默认选中 88′ 示例射门，点位与时间按钮联动更新详情。
  • Pass展示每次传球的起点到终点路线、传球者与接球者、发生时间、方向和结果；筛选项包括 All passes、Accurate、Inaccurate、Key passes、Crosses、Long balls，路线样式与图例保持一致。
  • Defence展示防守发生点、执行球员、时间和结果；Tackle、Interception、Block、Recovery、Clearance、Aerial duel、被过使用不同颜色的圆点表示，点位、筛选按钮与图例颜色保持一致，图例同时作为防守类型筛选器。
  • 球员选择器按当前动作和时段提供球员头像、姓名、位置与归属球队；列表按球员评分降序排列，评分相同时按姓名升序，每行显示球员评分，事件均在同一球场内更新。默认定位规则为：进入全场 Action map 时，Shot 默认展示球员射门卡片；Pass、Defence 默认选中当前时段该动作数量最多的球员（示例数据为 Rodri），数量相同时按评分降序、姓名升序；从球员卡或球员列表进入时，始终优先使用入口传入的球员。

取数与数据部门对接范围

普通数据 APP 已有，无需新增对接

  • 比赛与阵容：双方球队、赛事、比赛状态、时段、比分，以及球员姓名、球队、号码、位置和出场时间。
  • 现有本场汇总：球员评分、进球、助攻、射门、射正、成功/尝试传球、抢断，以及门将扑救和失球。

进阶事件数据 需要数据部门新增确认

  • 逐次传球：发生时段、分钟、秒和补时，球队、传球者、接球者、起点与终点坐标、成功或失败结果，以及普通传球、直塞、传中、长传、关键传球等类型。
  • 逐次带球：发生时段、开始与结束时间，球队、球员、起点、终点及可用的中间轨迹点、推进距离和结果；如能提供，还需标记带球后是否形成传球、射门、过人、造犯规或丢失球权。
  • 逐次防守：发生时段、分钟、秒和补时，球队、执行球员、对抗球员（如有）、发生点坐标、成功或失败结果，以及抢断、拦截、封堵、解围、争顶、施压、球权夺回等类型。
  • 事件关联：每个动作需要稳定唯一编号，并能够关联比赛时段、球队和球员，按真实发生顺序排列；传球与后续射门、带球与后续动作能够建立关联。
  • 坐标口径：确认起点与终点坐标范围、原点位置、攻防方向和换边规则，保证四类视图能绘制在同一球场。

交互

  • 默认选中 Action map、Shot；Shot、Pass、Defence 三个动作 Tab 可切换。
  • 点击 Players 进入同一场比赛的 Player statistics；点击 Match、1st Half、2nd Half 后，入口栏切换为对应时段选中态，Shot、Pass、Defence 的球员列表、分类结果和球场事件按当前时段同步刷新；再次点击 Action map 恢复全场数据。
  • Shot 中点击射门点位或时间按钮，同步更新选中态与 xG、xGOT、Shot type、Situation、Distance、Outcome。
  • Pass 的二级筛选切换传球类型或结果；Defence 的图例筛选切换防守动作类型；筛选后保留当前动作 Tab 和时段。
  • 点击球员选择器后打开可滚动菜单，顶部固定显示 All、带球队图标的主队与客队 Tab 和搜索框，主客队 Tab 始终显示；先按球队缩小范围，再输入球员姓名或位置即时搜索，清空搜索可恢复列表，无匹配时显示 No matching players；每个选项展示头像、球员姓名、位置和归属球队，按当前动作、时段及已选分类筛选后，以球员评分降序排列；评分相同时按姓名升序，缺少评分显示 — 并排在有评分球员之后。切换动作或时段时，若当前球员在新范围内无对应事件，则按上述默认规则重新定位；点击后刷新当前动作的可见事件，点击菜单外区域或 Escape 关闭菜单。

边界处理

  • Pass 或 Defence 在当前时段没有事件时保留球场空状态，并清空上一时段或上一筛选的点位。
  • 传球缺少起点、终点或防守事件缺少发生点时不绘制对应动作；缺少球员、类型、时间或结果时保留动作位置但以可用字段降级展示。
  • 筛选结果为空时显示当前筛选无事件，不回退到 All actions。
  • xPass 或 xA 缺失时隐藏对应字段，不以 0 替代，也不影响基础动作数据展示。
2

Player Action map card

球员比赛卡 · Action map 替代 Shooting map

LIVE INTERACTIVE PROTOTYPE球员、动作和事件均可切换

球员比赛卡将原 Shooting map 替换为 Action map；保留球员基础信息与比赛统计，并在卡片内完成动作类型、事件时间和详情联动。

展示位置

  • 位于球员比赛卡的基础信息和比赛统计之后，原 Shooting map 位置整体替换为 Action map。
  • 卡片内一级动作 Tab 为 Shot、Pass、Defence；默认选中 Shot。
  • 球场图下方固定显示向右箭头，明确当前球员的进攻方向；所有动作类型共用同一坐标口径。

展示内容

  • 球员头部保留头像、姓名、球队、位置、号码、评分、Minutes、Goals、Assists 和 Cards。
  • Shot 展示当前球员本场射门点位、射门路线、结果颜色和选中事件；Pass、Defence 直接复用模块 1 Unified Action map 的球场、传球路线、防守彩色点位、筛选项、图例及交互样式。球员热区作为独立模块展示在球员基础信息下方、Action map 上方，固定对应当前球员。
  • 球场下方按时间展示事件按钮；选中事件后更新 xG、xGOT、Shot type、Situation、Distance、Outcome。

交互

  • 点击动作 Tab 切换球场内容，保留当前球员和比赛时段。
  • 点击球场事件或时间按钮时，同步高亮点位、时间按钮和事件详情；事件详情缺少 xGOT 等字段时隐藏缺失字段。
  • 球员卡片从比赛卡或球员列表进入时，默认定位该球员的 Shot 视图和最近一脚有效事件。

Heatmap 热区逻辑

  • 取数：使用当前比赛、时段和所选球员的有效触球事件坐标；进球、传球与防守等同一事件关联的触球记录按唯一事件 ID 去重，缺少坐标的记录不参与绘制。
  • 计算：将坐标统一为从左向右进攻，换边后同步转换；球场划分为固定网格，按各网格触球次数计算密度，并对相邻网格平滑，形成连续热区。颜色由低至高为浅黄、黄、橙、红；深红表示触球最密集区域。
  • 强度口径：同一比赛内各球员与上下半场使用统一网格、平滑参数及颜色标尺，支持切换比较；热区表示触球密度，不代表射门质量、xG 或球员评分。
  • 交互：热区固定对应当前球员卡片的球员；切换比赛时段后重新计算热区；当前范围无有效触球时显示空球场与无数据提示。
  • 边界：缺少触球数据不以射门或传球点代替；不沿用上一位球员或上一时段的热区。原型中的热区为示例，实际展示按触球事件计算。

边界处理

  • 当前球员没有某类动作时显示空状态和动作类型名称，不沿用上一 Tab 的点位。
  • 缺少坐标的事件不绘制点位，但仍可在时间列表中展示可用的时间、类型和结果。
  • 球员替补、未出场或比赛中途换队时，基础信息和 Minutes 按比赛事件实际值展示。

取数与数据部门对接范围

  • 复用比赛 Action map 的逐次事件数据，增加球员维度过滤和球员卡片事件排序。
  • 需要事件唯一 ID、球员 ID、动作类型、时间、坐标、结果，以及 xG、xGOT、距离和情境字段；基础球员信息复用现有阵容接口。