一到四个大写字母填满屏幕并停留，呼吸般律动。风格决定进入方式：slam 让字母撞击出现，whip 让条形快速出现，burst 弹出星形爆炸，cut 则快速切换字词。用于促销或开门通知，设定精确时刻让屏幕同步爆发，使用 | 连接短语（如 GRAND OPENING|THIS SATURDAY）。支持横屏、竖屏、方形和条形九种主题，文本实时变化，减少动画时显示静态画面。
直播卡片
类别：消息。标签：商店，大厅与接待，活动与场地。
布局
此全屏卡在横屏或竖屏时填满整个屏幕，不作为角落、芯片或条带放置。
布局：全屏。表单：横向，纵向，方形，条带。
数据与隐私
此卡使用其配置的属性和实时卡数据。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
style | string | "slam" | "slam", "whip", "burst", "cut" | 文字出现方式：slam逐字撞入，whip用独立条带驱动每个词，burst从星爆中弹出，cut在词间快速切换。然后它们停留，呼吸，直到页面结束。 |
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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
text | string | "SMASH" | maxLength：80 | 一到四个大写字词。用 | 分隔短语以保持词组完整。 |
at | 字符串，空值 | null | maxLength：40 | 一个 ISO 时间点。每个屏幕同时播放该时间点的爆破；无此时间点时，爆破在卡片出现时播放。 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}screenrig card create --type smash --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "smash",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}写入实时数据
创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档，无需包装：
{
"text": "SMASH",
"at": null
}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":{"text":"SMASH","at":null}}'