天气卡片

当前状况,未来数小时及多日预报,重点句子引导,如“下午3点起有雨”。

大型温度和当前状况显示在未来数小时及多日预报上方,前端有如“下午3点起有雨”的简洁句子,确保从房间远处清晰可见。它可填满整个屏幕,拉伸至任意矩形,居中,收纳角落,单行角落显示或沿边缘显示条带。你设置位置和时区,选择公制或英制单位,选择显示预报天数,决定全布局或自由布局显示全部、仅当前状况或仅预报。

直播卡片

此卡由浏览器绘制,使用与播放器相同的代码,带示例数据。

类别:天气。标签:天气和环境,大堂和接待处,学校和校园。

布局

此核心卡适用于所有布局:全屏、居中、宽屏、角落、芯片、条带或任何自由矩形。

布局:全屏,自由,居中,宽屏,角落,芯片,条带。表单:横向,纵向,方形,条带。

卡片布局、主题和发布。浏览卡片。

数据与隐私

信息源:screenrig.weather/v1。

信息源文档带有来源归属。播放器向卡片提供信息源。

天气归属:天气数据由 Weatherbit 提供,源文档中有说明。

属性

有关主题、背景、强调色和位置,请参见通用属性。

创建卡片时,在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。

静态属性

名称类型默认数值和限制描述
locationobjectadditionalProperties:false;必填
location.namestringmaxLength:40;必填
location.latitudenumber最小值:-90;最大值:90;必填
location.longitudenumber最小值:-180;最大值:180;必填
unitsstring"metric""metric", "imperial"
showstring"auto""auto", "current", "forecast"完整或空白屏幕显示内容:全部(自动)、仅当前状况(当前)或仅预报(预报)。
daysinteger5最小值:3;最大值:7
showDetailsbooleantrue
hour12booleanfalse
timeZone字符串,空值null
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 weather --major 1 --file params.json

将此项目添加到播放列表页面的primitives中,并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。

{
  "id": "weather",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}