提供的工作日费率窗口决定当前能源价格、下次变更和今日区间。日期覆盖全天例外，跨夜窗口遵循起始工作日。本地时间线跟踪夏令时变化，任何未覆盖时段保持未知。
直播卡片
类别：财务。标签：价格和费率，日程安排，办公室和工作场所。
布局
此全屏卡在横屏或竖屏时填满整个屏幕，不作为角落、芯片或条带放置。
布局：全屏。表单：横向，纵向。
数据与隐私
此卡使用其配置的属性和实时卡数据。
仅收费时间表；无需计费器或客户身份信息。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
currency | string | "CAD" | 模式："^[A-Z]{3}$" | |
priceDecimals | integer | 3 | 最小值：0；最大值：6 | |
perPage | integer | 6 | 最小值：2；最大值：8 | |
pageSeconds | integer | 12 | 最小值：8；最大值：120 | |
followCurrent | 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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "Electricity rates" | maxLength：100 | |
provider | string | "" | maxLength：120 | |
footnote | string | "" | maxLength：240 | |
updatedAt | string | "" | maxLength：64 | |
bands | array | [] | maxItems：24 | 第一个匹配的时间段获胜。过夜时间段使用开始的星期几。开始和结束相等表示到第二天的本地时间。缺失的覆盖时间保持未知。 |
bands[].id | string | minLength：1；maxLength：48；必填 | ||
bands[].label | string | minLength：1；maxLength：60；必填 | ||
bands[].days | array | minItems：1；maxItems：7；必填 | ||
bands[].start | string | 模式："^([01][0-9]|2[0-3]):[0-5][0-9]$"；必填 | ||
bands[].end | string | 模式："^([01][0-9]|2[0-3]):[0-5][0-9]$"；必填 | ||
bands[].rateUnits | integer | 最小值：0；最大值：100000000；必填 | 每kWh的价格，货币单位按10^priceDecimals缩放。 | |
bands[].kind | string | "custom" | "off-peak", "shoulder", "peak", "custom" | |
bands[].note | string | "" | maxLength：140 | |
dayOverrides | array | [] | maxItems：120 | 每个明确的本地日期全天使用引用的价格区间，覆盖每周时间窗口。以第一个日期条目为准。未知的价格区间 ID 会导致价格未知。 |
dayOverrides[].date | string | 模式："^[1-9][0-9]{3}-[0-9]{2}-[0-9]{2}$"；必填 | ||
dayOverrides[].bandId | string | minLength：1；maxLength：48；必填 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}screenrig card create --type tou-rates --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "tou-rates",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}写入实时数据
创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档，无需包装：
{
"title": "Electricity rates",
"provider": "",
"footnote": "",
"updatedAt": "",
"bands": [],
"dayOverrides": []
}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":{"title":"Electricity rates","provider":"","footnote":"","updatedAt":"","bands":[],"dayOverrides":[]}}'