Header-Karte

Ein Balken über die gesamte Bildschirmbreite, bündig am oberen Rand, fasst die kleinen Dinge zusammen, die ein Bildschirm braucht. Die linken und rechten Slots zeigen jeweils einen Punkt: Wörter, ein Tag, eine Uhr, das aktuelle Wetter, ein Symbol, das Datum, einen Statuspunkt, Ihr Logo, einen Countdown, eine Zahl, die aktuelle Seite oder eine stille Warnung, die warm oder rot wird. Die Mitte trägt eine Nachricht, die stillsteht, bei langer Nachricht kriecht oder bis zu acht Seiten durchblättert. Sie legen die Punkte und die Nachricht fest und ändern sie während der Laufzeit; der Balken behält auf jedem Bildschirm seine Position.

Live-Karte

Kategorie: Nachrichten. Schlagwörter: Wartebereiche und Empfang, Büros und Arbeitsplätze, Geschäfte.

Layouts

Diese Balkenkarte wird als Kopfzeile platziert: eine vollbreite Leiste, 80 hoch, bündig mit der oberen Kante. Sie nimmt kein Layout oder Anker ein.

Layouts: Kopfzeile. Formulare: Streifen.

Kartenlayouts, Designs und Veröffentlichung. Karten durchsuchen.

Daten und Datenschutz

Feed: screenrig.weather/v1.

Feed-Dokumente tragen Quellenangaben. Der Player liefert den Feed an die Karte.

Wetterzuordnung: Wetterdaten von Weatherbit, wie im Feed-Dokument benannt.

Eigenschaften

Für Thema, Hintergrund und Akzent siehe Gemeinsame Eigenschaften. Eine Bar-Karte hat keine layout oder anchor Eigenschaft: Sie wird immer als Kopfzeile platziert.

Legen Sie statische Eigenschaften in den params der Karte fest, wenn Sie sie erstellen. Ihr Datendokument enthält nur dynamische Eigenschaften. Verschachtelte Zeilen beschreiben den Inhalt ihrer übergeordneten Eigenschaft.

Statische Eigenschaften

Dynamische Eigenschaften

Canvas-Beispiel

Speichern Sie die statischen Eigenschaften als params.json und erstellen Sie die Karte. Das Ergebnis enthält ihre crd_ ID.

{
  "theme": "neomustard",
  "location": {
    "name": "Vancouver",
    "latitude": 49.25,
    "longitude": -123.0
  }
}

screenrig card create --type header --major 1 --file params.json

Fügen Sie diesen Eintrag den primitives einer Playlist-Seite hinzu, mit dieser ID anstelle der Beispiel-ID. Veröffentlichen Sie die Playlist und weisen Sie einen Bildschirm zu.

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

Live-Daten schreiben

Schreiben Sie das Dokument nach dem Erstellen in die Karte und ersetzen Sie es dann, um den Bildschirm ohne erneute Veröffentlichung zu aktualisieren. Die Karte prüft jeden Schreibvorgang gegen ihre dynamischen Eigenschaften und lehnt ein Dokument ab, das sie nicht akzeptiert. Verwenden Sie dasselbe Projekt wie die Playlist.

Speichern Sie das Dokument als card-data.json. Die CLI liest das Dokument selbst, ohne Wrapper:

{
  "left": null,
  "right": null,
  "middle": null
}

screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json

Oder rufen Sie die API direkt auf. Die API verpackt dasselbe Dokument in ein document-Feld. Ein Agent-Token benennt bereits sein Projekt, daher wird kein Projekt-Header gesendet; wenn Sie ScreenRig-Project senden, muss es zum Token-Projekt passen. Stellen Sie Ihre API-Autorisierung über die Umgebung bereit; siehe API-Authentifizierung.

curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"document":{"left":null,"right":null,"middle":null}}'