screenRIG
登录开始使用

排名卡片

联赛表显示主办方提供球队的积分、净胜球、状态和晋级线。

提供的联赛排名显示战绩、积分、近期状态、资格区和热门，涵盖轮换组和角落视图。Primetime 引入错落的行弹簧、青色常规状态强调和缓慢的领奖台及排名背景。降级和失利使用琥珀色，共享运动装备括号标记提供的冠军区领头者。过去更新、组变更和五秒角落交接有小提示。排名、列选择、热门固定和分页保持现有规则。超过十四行的表格分为平衡分页，轮流与组显示，少数队伍以较大尺寸填满屏幕，每个名称统一大小并按词换行，早期日期的源显示日期并标记时效。减少动画时显示稳定静态画面。

直播卡片

此卡由浏览器绘制，使用与播放器相同的代码，带示例数据。

类别：体育。标签：排行榜和排名，团队运动，学校和校园。

布局

此全屏卡在横屏或竖屏时填满整个屏幕，不作为角落、芯片或条带放置。

布局：全屏。表单：横向，纵向。

卡片布局、主题和发布。浏览卡片。

数据与隐私

信息源：screenrig.standings/v1。

信息源文档带有来源归属。播放器向卡片提供信息源。

属性

有关主题、背景、强调色和位置，请参见通用属性。

创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。

静态属性

名称类型默认数值和限制描述
titlestring""maxLength：40空白时使用联盟名称。
countinteger10最小值：1；最大值：24表格顶部显示的团队；低于分界线的收藏夹占最后一名。
groupstring""maxLength：40一个组名（会议、分区）。空白页浏览所有组。
favouritestring""maxLength：8球队简称；其所在行高亮显示，所属组保持在屏幕上。
showFormbooleantrue显示每个团队的最新成绩。
pageSecondsinteger12最小值：5；最大值：60分页时每组保持的秒数。
sportstring"other""hockey", "soccer", "basketball", "football", "baseball", "other"
hour12booleanfalse
timeZone字符串，空值null
backgroundColor字符串，空值null模式："^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"用纯色 CSS 顺序覆盖卡片背景和底板。#RRGGBBAA 提供透明度。背景无则优先。
textColor字符串，空值null模式："^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。

动态属性

名称类型默认数值和限制描述
league对象，空值nulladditionalProperties：false该排名表所对应的赛事；当 title 为空时，其名称作为标题。以数据源为准。
league.namestringmaxLength：60；必填
seasonstring""maxLength：20赛季，例如 2026–27；以数据源为准。
zonesarray[]minItems：0；maxItems：4彩色条图例的名称，每个种类一个；以数据源为准。
zones[].kindstring"champion"、"qualify"、"playoff"、"relegation"；必填
zones[].labelstringmaxLength：40
groupsarray[]minItems：0；maxItems：20排名表，与 screenrig.standings/v1 数据源的 groups 分组相同。存在数据源时以数据源为准；否则由数据存储提供相同的行。
groups[].namestringmaxLength：40联盟、分区或小组。名称与联赛名称相同时不显示。
groups[].rowsarrayminItems：0；maxItems：40；必填
groups[].rows[].rankinteger最小值：1；最大值：999在小组中的名次；没有名次的行保持原有顺序。
groups[].rows[].teamobjectadditionalProperties：false；必填
groups[].rows[].team.namestringmaxLength：60；必填
groups[].rows[].team.shortstringmaxLength：8球队简称，卡片的关注球队与之匹配。没有简称时，卡片会从名称中取三个字母。
groups[].rows[].playedinteger最小值：0；最大值：999已赛场次；省略时为各项结果之和。
groups[].rows[].woninteger最小值：0；最大值：999
groups[].rows[].wonOtinteger最小值：0；最大值：999加时或点球大战中的胜场，与 won 一起计入 W 列。
groups[].rows[].drawninteger最小值：0；最大值：999平局（美式橄榄球的 T 列）。
groups[].rows[].lostinteger最小值：0；最大值：999
groups[].rows[].otlinteger最小值：0；最大值：999加时或点球大战中的败场。
groups[].rows[].diffinteger最小值：-9999；最大值：9999净胜球或净胜分。
groups[].rows[].pointsnumber最小值：-999；最大值：9999积分；扣分可使球队降到 0 以下。
groups[].rows[].pctnumber最小值：0；最大值：1胜率，取值 0 到 1，显示为 .732。当没有任何一行有积分时，会显示它的列。
groups[].rows[].form字符串或数组anyOf：[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"enum":["W","D","L"]}}]最近的结果，按从旧到新的顺序，显示五个：形如 WWDLW 的字符串（其他字母会被忽略），或由 W、D 和 L 组成的列表。
groups[].rows[].zonestring"champion", "qualify", "playoff", "relegation"为该行的色条着色：champion、qualify、playoff 或 relegation。
updatedAtstring""maxLength：40排名表获取的时间，ISO 8601（仅限数据存储；数据源带有 fetchedAt）。

画布示例

将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。

{
  "theme": "neomustard"
}
screenrig card create --type standings --major 1 --file params.json

将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。

{
  "id": "standings",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}

写入实时数据

创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。

将文档保存为card-data.json。CLI直接读取文档，无需包装：

{
  "league": null,
  "season": "",
  "zones": [],
  "groups": [],
  "updatedAt": ""
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json

或直接调用 API。API 将相同文档包装在 document 字段中。智能体令牌已指定其项目，因此不发送项目头；若发送 ScreenRig-Project，必须与令牌项目匹配。通过环境提供 API 授权；详见 API 认证。

curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"document":{"league":null,"season":"","zones":[],"groups":[],"updatedAt":""}}'