Il biglietto servito e il suo sportello risaltano in un carattere grande leggibile da lontano, con le ultime chiamate e l’attesa accanto. Riempie tutto lo schermo, si adatta a qualsiasi rettangolo, si posiziona al centro, si infila in un angolo, scorre come una riga in un angolo e come una banda lungo un bordo. Si imposta l’intestazione, il numero in attesa e l’attesa media, si sceglie se la scheda rimane visibile o appare solo dopo ogni chiamata e per quanto tempo, e si mostra il biglietto attuale di ogni sportello al posto delle ultime chiamate.
Live card
Categoria: Retail. Tag: Code e attese, Negozi, Sanità.
Layout
Questa scheda core si adatta a ogni layout: schermo intero, centro, ampio, angolo, chip, striscia o qualsiasi rettangolo libero.
Layout: pieno, libero, centrale, ampio, angolo, chip, striscia. Moduli: orizzontale, verticale.
Layout, temi e pubblicazione delle schede. Esplora le schede.
Dati e privacy
Questa scheda usa le proprietà configurate e i dati live della 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 | "Now serving" | maxLength: 40 | |
chime | boolean | true | L’host riproduce il segnale di chiamata; la scheda segnala come fresca una chiamata di meno di 15 s. | |
presence | string | "always" | "always", "calls" | chiamate: la scheda mostra solo per callSeconds dopo ogni chiamata; tra chiamate è assente. |
callSeconds | integer | 30 | minimo: 5; massimo: 600 | Secondi in cui la scheda rimane visibile dopo una chiamata (chiamate di presenza). |
multiCounter | boolean | false | Mostra il biglietto corrente di ogni sportello in una griglia (completa) e come celle (striscia), al posto delle ultime chiamate. | |
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 |
|---|---|---|---|---|
serving | array | [] | minItems: 0; maxItems: 20 | Chiamata più recente per prima. |
serving[].ticket | string | minLength: 1; maxLength: 12; Obbligatorio | ||
serving[].counter | string | "" | maxLength: 12 | |
serving[].calledAt | string | "" | maxLength: 40 | Istante ISO 8601 della chiamata. |
waiting | intero, null | null | minimo: 0 | |
averageWaitMinutes | intero, null | null | minimo: 0 |
Esempio di canvas
Salva le proprietà statiche come params.json e crea la scheda. Il risultato contiene il suo ID crd_.
{
"theme": "neomustard"
}
screenrig card create --type queue --major 1 --file params.json
Aggiungi 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": "queue",
"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:
{
"serving": [],
"waiting": null,
"averageWaitMinutes": null
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json
Oppure 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":{"serving":[],"waiting":null,"averageWaitMinutes":null}}'