屏幕显示来自官方警报源的某地活动公共警报,最严重的优先,使用主题安全色,便于远距离阅读。可全屏、适应任意矩形、居中、角落小方块或一行,或沿边缘横幅显示。设置地点、最低显示严重级别、包含或排除的事件及首选语言。选择卡片仅在警报时显示或保持平静状态,以及时间显示方式。
直播卡片
类别:公共信息。标签:警报和状态,天气和环境。
布局
此核心卡适用于所有布局:全屏、居中、宽屏、角落、芯片、条带或任何自由矩形。
布局:全屏,自由,居中,宽屏,角落,芯片,条带。表单:横向,纵向,方形,条带。
数据与隐私
信息源:screenrig.cap/v1。
信息源文档带有来源归属。播放器向卡片提供信息源。
属性
有关主题、背景、强调色和位置,请参见通用属性。
创建卡片时,在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "" | maxLength:60 | 空白显示“公共警报”。 |
presence | string | "active" | "active", "always" | active 仅在警报等级达到或超过 minSeverity 时显示卡片。always 在无警报时保持平静状态:无活动警报、无更新、该位置无警报来源。 |
minSeverity | string | "moderate" | "minor", "moderate", "severe", "extreme" | 隐藏低于此严重级别的警报。无严重级别的警报视为轻微。 |
events | array | [] | maxItems:30 | 仅显示这些事件(不区分大小写;* 匹配任意字符序列)。 |
excludeEvents | array | [] | maxItems:30 | 永不发生这些事件。 |
languages | array | [] | maxItems:30 | 语言偏好,先到先得(fr,fr-CA,en)。如果都没有,则显示其第一语言的警报。 |
hourCycle | string | "24" | "12", "24", "military" | 12:下午 2:05。24:14:05。军用时间:1405。 |
timeZone | 字符串,空值 | null | IANA 时区;空值使用屏幕时区。 | |
staleMinutes | integer | 30 | 最小值:10;最大值:1440 | 文档长时间未刷新即视为未更新,无论其状态如何。 |
location | object | additionalProperties:false | 放置警报的位置。其坐标选择覆盖该区域的官方警报源;显示该点所在区域的警报。 | |
location.name | string | maxLength:40 | ||
location.latitude | number | 最小值:-90;最大值:90;必填 | ||
location.longitude | number | 最小值:-180;最大值:180;必填 | ||
location.geocodes | array | [] | maxItems:40 | 地点的区号,与以代码命名区域的警报匹配:[{"name": "UGC", "value": "WAC033"}]。 |
location.geocodes[].name | string | minLength:1;maxLength:40;必填 | 代码系统:SAME、UGC、NUTS3、EMMA_ID。 | |
location.geocodes[].value | string | minLength:1;maxLength:120;必填 | ||
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 alerts --major 1 --file params.json
将此项目添加到播放列表页面的primitives中,并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "alerts",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}