血袋显示八种血型的库存水平，并标识最需要的血型。
直播卡片
类别：健康。标签：医疗保健，图表和仪表，数字和指标。
布局
此全屏卡在横屏或竖屏时填满整个屏幕，不作为角落、芯片或条带放置。
布局：全屏。表单：横向，纵向。
数据与隐私
此卡使用其配置的属性和实时卡数据。
仅显示按血型分类的库存水平；绝不显示捐赠者姓名、预约或患者信息。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "Blood supply" | maxLength：40 | |
targetDays | number | 6 | 最小值：0.5；最大值：30 | 仅提供天数时，视为完全达标的库存天数。 |
criticalBelow | number | 25 | 最小值：1；最大值：100 | 低于此目标百分比时，类型为关键。 |
lowBelow | number | 50 | 最小值：1；最大值：100 | 低于此目标百分比时，类型为低。 |
staleMinutes | integer | 1440 | 最小值：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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
updatedAt | string | "" | maxLength：40 | 级别最后更新时间，ISO 8601 时间点。为空表示无年龄限制。 |
types | array | [] | minItems：0；maxItems：8 | 血型及其水平。缺少类型显示无数据。 |
types[].type | string | minLength：1；maxLength：16；必填 | 血型为A、B、AB或O，带+或-（如O-，AB阳性，A阴性）。 | |
types[].status | string | "" | "critical", "low", "adequate", "good", "" | 覆盖根据百分比或天数计算的状态。 |
types[].percent | 数字，空值 | null | 最小值：0；最大值：300 | 库存占目标的百分比。 |
types[].days | 数字，空值 | null | 最小值：0；最大值：99 | 现有库存可用天数。 |
appeal | string | "" | maxLength：140 | 公告板下方的一行，例如如何预订捐赠。 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}screenrig card create --type blood-supply --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "blood-supply",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}写入实时数据
创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档，无需包装：
{
"updatedAt": "",
"types": [],
"appeal": ""
}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":{"updatedAt":"","types":[],"appeal":""}}'