屏幕显示发送者原文的紧急和公共警报,最严重优先,长警报分段显示,避免截断。可全屏、居中、角落、角落一行或边缘横幅显示。设置警报源、屏幕位置、显示严重级别、首选语言、卡片是否在无警报时保持显示及警报显示时长。
直播卡片
类别:公共信息。标签:警报和状态,学校和校园,办公室和工作场所,大堂和接待处。
布局
此核心卡适用于所有布局:全屏、居中、宽屏、角落、芯片、条带或任何自由矩形。
布局:全屏,居中,宽屏,角落,芯片,条带。表单:横向,纵向,方形,条带。
数据与隐私
信息源:screenrig.cap/v1。
信息源文档带有来源归属。播放器向卡片提供信息源。
属性
有关主题、背景、强调色和位置,请参见通用属性。
创建卡片时,在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "" | maxLength:60 | 名称卡片在保持平静状态时显示。空时显示“警报”。 |
presence | string | "active" | "active", "always" | active 仅在有警报时显示卡片。always 在无警报时保持平静状态:无活动警报、无更新、无警报来源。 |
sources | array | [] | maxItems:5 | CAP 来源:CAP 1.0 至 1.2 警报的 http 或 https URL(端口 80 或 443),或警报的 ATOM 或 RSS 索引。每个 URL 每分钟为每个命名它的屏幕抓取一次。为空时读取覆盖 location 的公共警报源(NWS、加拿大 NAAD 和 MeteoAlarm 针对带区号的位置)。 |
publicAlerts | 布尔值,空值 | null | 还可读取涵盖 location 的公共信息流。无 sources 时为真,有时为假。 | |
location | object | additionalProperties:false | 屏幕位置。区域为多边形或圆形的警报在包含此点时显示;按区号通知的警报在geocodes共享代码时显示。无指定时显示所有来源的警报。 | |
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;必填 | ||
minSeverity | string | "minor", "moderate", "severe", "extreme" | 隐藏低于此严重级别的警报。未设置则显示所有严重级别。 | |
maxSeverity | string | "minor", "moderate", "severe", "extreme" | 隐藏高于此严重级别的警报:较低级别警报显示在角落或条带中,严重警报则全屏显示。 | |
minUrgency | string | "past", "future", "expected", "immediate" | ||
minCertainty | string | "unlikely", "possible", "likely", "observed" | ||
events | array | maxItems:30 | 仅显示这些事件(不区分大小写;* 匹配任意字符序列)。 | |
excludeEvents | array | maxItems:30 | ||
senders | array | maxItems:30 | 仅来自这些发送者的警报(不区分大小写;允许使用 *)。 | |
statuses | array | maxItems:4 | 显示哪些 CAP 状态。未设置为仅实际:测试和演习仅在列出时显示。 | |
scopes | array | maxItems:3 | 显示哪些 CAP 范围。未设置为公开。 | |
languages | array | maxItems:30 | 语言偏好,先到先得(fr,fr-CA,en)。显示警报的第一种可用语言;如果都没有,则显示其第一语言的警报。 | |
areaUnknown | string | "hide" | "hide", "show" | 仅由该位置无的区号告知的警报:隐藏或显示。 |
hourCycle | string | "24" | "12", "24", "military" | 12:下午 2:05。24:14:05。军用时间:1405 小时。 |
timeZone | 字符串,空值 | null | IANA 时区;空值使用屏幕时区。 | |
pageSeconds | integer | 12 | 最小值:6;最大值:60 | 每个警报及长警报的每个部分在下一个警报出现前的显示时间。 |
staleMinutes | integer | 30 | 最小值:10;最大值:1440 | 文档长时间未刷新即视为未更新,无论其状态如何。 |
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 cap-alert --major 1 --file params.json
将此项目添加到播放列表页面的primitives中,并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "cap-alert",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}