适用于数字标牌屏幕的大奖榜卡片

直播卡片

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

类别：零售。标签：商店，价格和费率，数字和指标。

布局

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

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

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

数据与隐私

信息源：screenrig.jackpots/v1。

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

属性

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

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

静态属性

名称	类型	默认	数值和限制	描述
`title`	string	`"Jackpots"`	maxLength：`40`
`currency`	string	`"USD"`	maxLength：`3`	ISO 4217 代码；以信息源为准。
`takeoverAbove`	数字，空值	`null`	最小值：`1`；最大值：`1000000000000`	超过此大奖金额，卡片将变为最大游戏的海报，充满屏幕。空值则不会。
`sort`	string	`"jackpot"`	`"jackpot"`, `"draw"`	领先比赛是最大奖池或最早抽奖。
`staleMinutes`	integer	`720`	最小值：`1`；最大值：`20160`	超过此时间的源显示上次更新时间。
`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})?$"`	覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。

动态属性

名称	类型	默认	数值和限制	描述
`games`	array	`[]`	maxItems：`12`	游戏，与screenrig.jackpots/v1数据源的`games`文档相同。数据源存在时优先使用。
`games[].name`	string		minLength：`1`；maxLength：`40`；必填	游戏（Lotto Max，Powerball）。
`games[].jackpot`	number		最小值：`0`；最大值：`1000000000000`；必填	广告中的大奖金额，单位为完整货币单位（245500000 表示 $245.5 百万）。
`games[].cash`	数字，空值	`null`	最小值：`0`；最大值：`1000000000000`	游戏中存在时的现金选项。
`games[].nextDraw`	string	`""`	maxLength：`40`	下一次抽签，ISO 8601 时间点（或屏幕时区的本地时间）。
`games[].lastNumbers`	array	`[]`	maxItems：`8`	上次抽奖的号码。
`games[].bonus`	整数，空值	`null`	最小值：`0`；最大值：`999`	上次抽奖的奖金球或强力球。
`games[].cap`	数字，空值	`null`	最小值：`0`；最大值：`1000000000000`	游戏的最高奖金（黄金时段）。从其90%开始，主游戏处于监视状态：一个琥珀色计量器，呼吸括号和一个标签显示距离上限的距离。
`games[].prevJackpot`	数字，空值	`null`	最小值：`0`；最大值：`1000000000000`	奖池最新上涨前的金额（黄金时段）；数字从此金额滚动至raisedAt。
`games[].raisedAt`	string	`""`	maxLength：`40`	奖池最后一次上涨的时间点，ISO 8601（黄金时段）。滚动、计量器和+金额标签从此时间点开始播放。
`games[].hitAt`	string	`""`	maxLength：`40`	奖池中奖的时间点，ISO 8601（黄金时段）。大奖接管从此时间点开始播放，所有屏幕同时显示；之前牌面仍显示wonAmount。
`games[].wonAmount`	数字，空值	`null`	最小值：`0`；最大值：`1000000000000`	已中奖的奖池（黄金时段）：显示于hitAt之前及接管画面。游戏自身的奖池随后重置。
`footnote`	string	`""`	maxLength：`140`	公告板下方的一行，例如负责任播放信息。

画布示例

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

{
  "theme": "neomustard"
}

screenrig card create --type jackpot-board --major 1 --file params.json

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

{
  "id": "jackpot-board",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}

写入实时数据

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

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

{
  "games": [],
  "footnote": ""
}

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":{"games":[],"footnote":""}}'