屏幕显示一个大气质量数值及其类别词，一句简单说明，带标记的刻度尺和旁边的紫外线指数，便于远距离阅读。可全屏、居中、角落、一行或边缘横幅显示。选择读数地点、标题或地点名，是否显示紫外线指数，读数时间格式及是否始终显示或仅高于设定级别时显示。
直播卡片
类别：天气。标签：天气和环境，数字和指标。
布局
此核心卡适用于所有布局：全屏、居中、宽屏、角落、芯片、条带或任何自由矩形。
布局：全屏，居中，宽屏，角落，芯片，条带。表单：横向，纵向，方形，条带。
数据与隐私
信息源：screenrig.airquality/v1。
信息源文档带有来源归属。播放器向卡片提供信息源。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "" | maxLength：40 | 空白时使用地点名称。 |
showUv | boolean | true | 在空气质量指数旁显示紫外线指数。无空气质量读数时，紫外线指数为主角。 | |
hourCycle | string | "24" | "12", "24", "military" | 读数时间的写法：12小时制带上午或下午，24小时制（13:00），或军用时间（1300）。 |
timeZone | 字符串，空值 | null | ||
presence | string | "always" | "always", "unhealthy" | 始终：卡片始终显示。健康不佳：仅在空气质量指数高于 presenceFrom 时显示（陈旧或缺失的读数保持显示）。 |
presenceFrom | integer | 100 | 最小值：0；最大值：500 | 在存在不健康时，卡片显示的指数阈值（100：对敏感群体不健康时）。 |
location | object | additionalProperties：false | 测量读数的位置。选择数据源。 | |
location.name | string | maxLength：40；必填 | ||
location.latitude | number | 最小值：-90；最大值：90；必填 | ||
location.longitude | number | 最小值：-180；最大值：180；必填 | ||
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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
此卡无动态属性。
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard",
"location": {
"name": "Vancouver",
"latitude": 49.25,
"longitude": -123.0
}
}screenrig card create --type air-quality --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "air-quality",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}