Costruito intorno all’intervallo esistente, al timer di all-clear e alle regole WBGT, presenta le condizioni di fulmini e calore fornite. Durante il Primetime, gli avvisi restano immediatamente leggibili, con contorni lenti di pericolo/attenzione e segnali discreti per un aggiornamento o un nuovo all-clear. Una lettura di fulmini obsoleta non diventa mai un annuncio di all-clear.
Live card
Categoria: Meteo. Tag: Avvisi e stato, Meteo e ambiente, Conti alla rovescia e timer.
Layout
Questa scheda a schermo intero riempie tutto lo schermo in orizzontale o verticale e non è posizionata come angolo, chip o striscia.
Layout: pieno. Moduli: orizzontale, verticale.
Layout, temi e pubblicazione delle schede. Esplora le schede.
Dati e privacy
Feed: screenrig.outdoorsafety/v1.
I documenti del feed riportano l’attribuzione della fonte. Il Player fornisce il feed alla scheda.
Proprietà
Per tema, sfondo, accento e posizione, vedi Proprietà comuni.
Imposta le proprietà statiche nei params della scheda quando la crei. Il suo documento dati contiene solo proprietà dinamiche. Le righe annidate descrivono il contenuto della proprietà genitore.
Proprietà statiche
| Nome | Tipo | Predefinito | Valori e limiti | Descrizione |
|---|---|---|---|---|
title | string | "Outdoor safety" | maxLength: 40 | |
site | string | "" | maxLength: 60 | Il nome della sede, quando il feed non ne riporta alcuno. |
location | object | additionalProperties: false | Il luogo a cui si riferisce il calore: il meteo di questo luogo fornisce una stima del WBGT, che sostituisce le letture del data store. Vuoto usa le letture del data store. {screen.location} usa il luogo dello schermo stesso. | |
location.name | string | maxLength: 40; Obbligatorio | ||
location.latitude | number | minimo: -90; massimo: 90; Obbligatorio | ||
location.longitude | number | minimo: -180; massimo: 180; Obbligatorio | ||
show | string | "both" | "both", "lightning", "heat" | Quali rischi copre la scheda. |
units | string | "metric" | "metric", "imperial" | Chilometri e gradi Celsius, o miglia e gradi Fahrenheit. |
radiusKm | number | 16 | minimo: 1; massimo: 100 | Raggio di fulmini in chilometri: un fulmine all’interno sospende le attività all’aperto (16 km sono 10 miglia). |
watchKm | number | 32 | minimo: 1; massimo: 200 | I fulmini fuori dal raggio ma entro questa distanza indicano fulmini nelle vicinanze. |
clearMinutes | integer | 30 | minimo: 5; massimo: 120 | Minuti senza un colpo in area prima del via libera. |
takeover | boolean | true | Riempire tutto lo schermo mentre il fulmine è nel raggio d’azione. | |
wbgtLevels | array | [25.6,27.8,30,32.2] | minItems: 4; maxItems: 4 | I valori WBGT in gradi Celsius dove il livello sale da basso a moderato, alto, molto alto ed estremo. |
staleMinutes | integer | 10 | minimo: 1; massimo: 1440 | Letture più vecchie di questa appaiono come non aggiornate; dati sui fulmini così vecchi non mostrano mai Tutto chiaro. |
hour12 | boolean | false | ||
backgroundColor | stringa, nullo | null | modello: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | Sovrascrive il colore di sfondo e della piastra della scheda con un colore piatto ordinato in CSS. #RRGGBBAA fornisce l’opacità. background none ha la precedenza. |
textColor | stringa, nullo | null | modello: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | Sovrascrive i colori del testo principale e secondario. I colori di accento e di stato semantico mantengono i loro ruoli. |
Proprietà dinamiche
| Nome | Tipo | Predefinito | Valori e limiti | Descrizione |
|---|---|---|---|---|
strikes | array | [] | minItems: 0; maxItems: 200 | Fulmini recenti, una lista vuota significa nessuno. Un feed (screenrig.outdoorsafety/v1) con una lista di fulmini prevale se presente; altrimenti, e quando il feed indica che i fulmini non sono segnalati, il data store fornisce le stesse righe. |
strikes[].at | string | maxLength: 32; Obbligatorio | Quando lo sciopero è iniziato, ISO 8601. | |
strikes[].distanceKm | number | minimo: 0; massimo: 1000 | Distanza dal sito; uno sciopero senza questa conta come entro il raggio. | |
lastStrikeAt | string | "" | maxLength: 32 | L’ultimo strike nell’intervallo, ISO 8601: il modo rapido per iniziare il conto alla rovescia a mano. |
strikeDistanceKm | number | 0 | minimo: 0; massimo: 1000 | Quanto è lontano quel colpo, in chilometri. 0 significa in portata. |
wbgtC | number | 0 | minimo: 0; massimo: 50 | La lettura WBGT in gradi Celsius. 0 significa nessuna lettura. |
temperatureC | number | 0 | minimo: 0; massimo: 60 | Temperatura dell’aria in gradi Celsius; con umidità stima WBGT quando non c’è lettura. 0 significa nessuna. |
humidityPct | number | 0 | minimo: 0; massimo: 100 | Umidità relativa in percentuale. 0 significa nessuna. |
updated | string | "" | maxLength: 32 | Quando le letture sono state fatte, ISO 8601 (solo archivio dati; un feed contiene observedAt o fetchedAt). Un valore impostato indica che il fulmine è stato segnalato. |
Esempio di canvas
Salva le proprietà statiche come params.json e crea la scheda. Il risultato contiene il suo ID crd_.
{
"theme": "neomustard",
"location": {
"name": "Vancouver",
"latitude": 49.25,
"longitude": -123.0
}
}screenrig card create --type outdoor-safety --major 1 --file params.jsonAggiungi questo elemento ai primitives di una pagina playlist, con quell’ID al posto di quello dell’esempio. Pubblica la playlist e assegna uno schermo.
{
"id": "outdoor-safety",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}Scrivere dati live
Scrivi il documento nella scheda dopo averla creata, poi sostituiscilo per aggiornare lo schermo senza ripubblicare. La scheda controlla ogni scrittura rispetto alle sue proprietà dinamiche e rifiuta un documento che non accetta. Usa lo stesso progetto della playlist.
Salva il documento come card-data.json. Il CLI legge il documento stesso, senza wrapper:
{
"strikes": [],
"lastStrikeAt": "",
"strikeDistanceKm": 0,
"wbgtC": 0,
"temperatureC": 0,
"humidityPct": 0,
"updated": ""
}screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.jsonOppure chiamare direttamente l’API. L’API incapsula lo stesso documento in un campo document. Un token agente nomina già il suo progetto, quindi non viene inviato un header progetto; se invii ScreenRig-Project, deve corrispondere al progetto del token. Fornisci l’autorizzazione API tramite l’ambiente; vedi Autenticazione 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":{"strikes":[],"lastStrikeAt":"","strikeDistanceKm":0,"wbgtC":0,"temperatureC":0,"humidityPct":0,"updated":""}}'