今天的生日和工作周年纪念居中显示，旁边列出未来几天，名字从远处清晰可见。可填满整个屏幕，适应任意矩形，居中盒子显示，角落小方块或一行显示，或沿边缘横幅显示。可设置人员、标题文字、未来几天的列表范围、卡片是否始终显示或仅在庆祝日出现，以及周年年份是否以数字形式显示在名字旁。
直播卡片
类别：人员。标签：识别，办公室和工作场所，学校和校园，大厅和接待区。
布局
此核心卡适用于所有布局：全屏、居中、宽屏、角落、芯片、条带或任何自由矩形。
布局：全屏，自由，居中，宽屏，角落，芯片，条带。表单：横向，纵向，方形，条带。
数据与隐私
此卡使用其配置的属性和实时卡数据。
仅显示名字。肖像是屏幕所有者为该人提供的项目媒体图像；仅在其同意时显示。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "Celebrations" | maxLength：60 | 混合庆祝日、空白日的眉头，以及黄金时段标题。 |
windowDays | integer | 7 | 最小值：0；最大值：31 | 即将到来的列表预览的天数。 |
presence | string | "always" | "always", "today" | 始终保持卡片在屏幕上；今天显示仅在有生日或纪念日的当天显示。 |
showYears | boolean | true | 在姓名旁以数字显示工作周年年数。 | |
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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
people | array | minItems：1；maxItems：200；必填 | ||
people[].name | string | minLength：1；maxLength：60；必填 | ||
people[].birthday | string | "" | 模式："^((0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))?$" | MM-DD；2 月 29 日生日在其他年份为 2 月 28 日。 |
people[].anniversary | string | "" | 模式："^(\\d{4}-\\d{2}-\\d{2})?$" | 开始日期，YYYY-MM-DD。 |
people[].photo | string | "" | maxLength：120 | 媒体引用（media:<id>）；全屏或居中布局中名字旁的圆形头像。为空时显示图标。 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}screenrig card create --type celebrations --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "celebrations",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}写入实时数据
创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档，无需包装：
{
"people": [
{
"name": "Example"
}
]
}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":{"people":[{"name":"Example"}]}}'