直播卡片
类别：运营。标签：数字和指标，图表和仪表，工厂和仓库，办公室和工作场所。
布局
此全屏卡在横屏或竖屏时填满整个屏幕，不作为角落、芯片或条带放置。
布局：全屏。表单：横向，纵向。
数据与隐私
此卡使用其配置的属性和实时卡数据。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "Energy now" | maxLength：40 | |
co2Factor | number | 0.4 | 最小值：0；最大值：2 | 每生成kWh避免的二氧化碳公斤数，未提供co2SavedKg时使用。 |
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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
solarKw | number | 最小值：0 | 当前太阳能发电，单位为 kW。 | |
loadKw | number | 最小值：0 | 当前消耗，单位为 kW。 | |
batteryKw | number | kW中的电池电量：正电荷，负放电。无电池时，使用batteryPct省略。 | ||
batteryPct | number | 最小值：0；最大值：100 | 电池电量，0 到 100。 | |
gridKw | number | kW 的电网功率：正值为进口，负值为出口。缺失时由其他流量推导。 | ||
generatedTodayKwh | number | 最小值：0 | 今日迄今产生的能量，单位为kWh。 | |
co2SavedKg | number | 最小值：0 | 避免的 CO₂，单位为千克。缺省时从 generatedTodayKwh 和 co2Factor 计算。 | |
footnote | string | "" | maxLength：80 | |
peakKw | number | 最小值：0 | 站点峰值需求，单位为 kW。负载达到或超过其 90% 时，黄金时段将首页瓦片标记为关注。 | |
gridAlert | string | "" | maxLength：60 | 电网警报，操作员自述（电网故障、频率故障）。任何文本都会使卡片在黄金时段进入红色警报模式，并替代状态行。 |
gridAlertAt | string | "" | maxLength：40 | 网格警报触发的时间点，ISO 8601。黄金时段从此时间点播放警报接管，所有屏幕同时显示。 |
updatedAt | string | "" | maxLength：40 | 最新读数的时间点，ISO 8601。黄金时段从此时间点开始数据滴答：沿每条实时线路的光线和数字上的冲击。 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}screenrig card create --type energy --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "energy",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}写入实时数据
创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档，无需包装：
{
"solarKw": 1,
"loadKw": 1,
"batteryKw": 1,
"batteryPct": 1,
"gridKw": 1,
"generatedTodayKwh": 1,
"co2SavedKg": 1,
"footnote": "",
"peakKw": 1,
"gridAlert": "",
"gridAlertAt": "",
"updatedAt": ""
}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":{"solarKw":1,"loadKw":1,"batteryKw":1,"batteryPct":1,"gridKw":1,"generatedTodayKwh":1,"co2SavedKg":1,"footnote":"","peakKw":1,"gridAlert":"","gridAlertAt":"","updatedAt":""}}'