适用于数字标牌屏幕的心率墙卡

显示健身课程中的实时努力。每位成员以心率区颜色的方块显示，显示最大百分比和卡路里。还显示课程排行榜和区间分布。

直播卡片

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

类别：健康。标签：排行榜与排名，数字与指标，认可，活动与场地。

布局

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

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

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

数据与隐私

信息源：screenrig.heartrate/v1。

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

仅显示名字或昵称：绝不显示姓氏、年龄、最大心率百分比或任何健康历史，且卡片不存储任何成员信息。

属性

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

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

静态属性

名称	类型	默认	数值和限制	描述
`title`	string	`"Class effort"`	maxLength：`40`
`defaultMaxHr`	integer	`190`	最小值：`100`；最大值：`230`	无 maxHr 或年龄的成员最大心率。
`rankBy`	string	`"points"`	`"points"`, `"calories"`, `"effort"`	排行榜排名依据：努力点数、卡路里或最大百分比。若成员列表无前项，则依次使用后项。
`leaders`	integer	`5`	最小值：`3`；最大值：`10`	排行榜上的行数（空间较小时更少）。
`perPage`	integer	`24`	最小值：`4`；最大值：`48`	页面上的瓷砖数；较大的类别占用更多页面。
`pageSeconds`	integer	`10`	最小值：`5`；最大值：`60`	每页瓷砖在屏幕上的停留时间。
`showBpm`	boolean	`true`		在每个瓷砖上显示每分钟心跳数。
`staleSeconds`	integer	`45`	最小值：`5`；最大值：`3600`	超过此时间的读数会使图块变暗，并显示“3分钟前更新”。
`hour12`	boolean	`false`
`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})?$"`	覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。

动态属性

名称	类型	默认	数值和限制	描述
`className`	string	`""`	maxLength：`60`	班级，例如 6:00 AM Burn，当数据源无此信息时显示。
`startedAt`	string	`""`	maxLength：`32`	课程开始时间，ISO 8601：标题从该时间开始计时。
`endsAt`	string	`""`	maxLength：`32`	课程结束时间，ISO 8601：标题倒计时至该时间。
`members`	array	`[]`	minItems：`0`；maxItems：`120`	课程中的成员。存在数据源（screenrig.heartrate/v1）时优先使用；否则由数据存储提供相同行。
`members[].id`	string		maxLength：`40`	不透明的成员或带 ID；永不显示。
`members[].name`	string		maxLength：`60`；必填	仅显示第一个词。
`members[].nickname`	string		maxLength：`20`	存在时替代名称显示。
`members[].hr`	number		最小值：`0`；最大值：`260`	心率，单位为每分钟跳动次数；0或缺失表示无信号。
`members[].maxHr`	number		最小值：`80`；最大值：`240`	成员的最大心率。
`members[].age`	number		最小值：`5`；最大值：`110`	用于无maxHr时的220减年龄；从不显示。
`members[].calories`	number		最小值：`0`；最大值：`5000`
`members[].points`	number		最小值：`0`；最大值：`5000`	努力点数（Myzone MEPs 及类似）。
`updated`	string	`""`	maxLength：`32`	心率读取时间，ISO 8601（仅数据存储；数据源携带 fetchedAt）。

画布示例

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

{
  "theme": "neomustard"
}

screenrig card create --type heart-rate-wall --major 1 --file params.json

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

{
  "id": "heart-rate-wall",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}

写入实时数据

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

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

{
  "className": "",
  "startedAt": "",
  "endsAt": "",
  "members": [],
  "updated": ""
}

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":{"className":"","startedAt":"","endsAt":"","members":[],"updated":""}}'