Ranglistenkarte für Digital-Signage-Bildschirme

Gelieferte Ligastandings erscheinen mit Rekorden, Punkten, aktueller Form, Qualifikationszonen und Favoriten über rotierende Gruppen und Eckansichten. Primetime führt versetzte Zeilenfedern, cyanfarbene Akzente für normale Zustände und einen langsamen Podiums- und Ranking-Hintergrund ein. Abstieg und Niederlagen verwenden Bernstein, während gemeinsame Sportausrüstungs-Klammern den gelieferten Titelzonenführer markieren. Ein kleiner Hinweis markiert bestehende vergangene Feed-Aktualisierungen, Gruppenwechsel und fünfsekündige Eckübergaben. Ranglisten, Spaltenauswahl, Favoriten-Pinning und Seitenwechsel behalten ihre bestehenden Regeln bei. Eine Tabelle mit mehr als vierzehn Zeilen teilt sich in ausgewogene Seiten, die mit den Gruppen abwechseln, einige Teams füllen den Bildschirm in größerer Größe, jeder Name hat eine einheitliche Größe und Zeilenumbruch erfolgt an Wortgrenzen, und ein Feed eines früheren Tages zeigt dessen Tag und kennzeichnet dessen Alter. Bei reduzierter Bewegung wird eine ruhige Standbildansicht gezeigt.

Live-Karte

Diese Karte wird in Ihrem Browser vom gleichen Code gezeichnet, den die Player ausführen, mit Beispieldaten.

Kategorie: Sport. Schlagwörter: Bestenlisten und Tabellen, Mannschaftssport, Schulen und Campus.

Layouts

Diese Vollbildkarte füllt den gesamten Bildschirm im Quer- oder Hochformat und wird nicht als Ecke, Chip oder Streifen platziert.

Layouts: voll. Formulare: Querformat, Hochformat.

Kartenlayouts, Designs und Veröffentlichung. Karten durchsuchen.

Daten und Datenschutz

Feed: screenrig.standings/v1.

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

Eigenschaften

Für Thema, Hintergrund, Akzent und Position siehe Gemeinsame Eigenschaften.

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

Name	Typ	Standard	Werte und Grenzwerte	Beschreibung
`title`	string	`""`	maxLength: `40`	Leer verwendet den Namen der Liga.
`count`	integer	`10`	Minimum: `1`; Maximum: `24`	Teams werden von oben in der Tabelle angezeigt; ein Favorit unterhalb der Grenze nimmt den letzten Platz ein.
`group`	string	`""`	maxLength: `40`	Name einer Gruppe (Konferenz, Division). Leere Seiten blättern durch alle Gruppen.
`favourite`	string	`""`	maxLength: `8`	Der Kurzcode eines Teams; dessen Zeile ist hervorgehoben und seine Gruppe bleibt auf dem Bildschirm.
`showForm`	boolean	`true`		Letzte Ergebnisse jedes Teams anzeigen.
`pageSeconds`	integer	`12`	Minimum: `5`; Maximum: `60`	Sekunden, die jede Gruppe beim Blättern angezeigt wird.
`sport`	string	`"other"`	`"hockey"`, `"soccer"`, `"basketball"`, `"football"`, `"baseball"`, `"other"`
`hour12`	boolean	`false`
`timeZone`	String, Null	`null`
`backgroundColor`	String, Null	`null`	Muster: `"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	Überschreibt den Kartenhintergrund und die Platte mit einer flachen, CSS-geordneten Farbe. #RRGGBBAA gibt die Deckkraft an. Hintergrund none hat Vorrang.
`textColor`	String, Null	`null`	Muster: `"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	Überschreibt die Haupt- und Sekundärtextfarben. Akzent- und semantische Statusfarben behalten ihre Funktion.

Dynamische Eigenschaften

Name	Typ	Standard	Werte und Grenzwerte	Beschreibung
`league`	Objekt, Null	`null`	additionalProperties: `false`	Der Wettbewerb, für den die Tabelle gilt; sein Name ist der Titel, wenn `title` leer ist. Der Feed hat Vorrang.
`league.name`	string		maxLength: `60`; Pflichtfeld
`season`	string	`""`	maxLength: `20`	Die Saison, zum Beispiel 2026–27; der Feed hat Vorrang.
`zones`	array	`[]`	minItems: `0`; maxItems: `4`	Namen für die Legende der farbigen Balken, einer pro Art; der Feed hat Vorrang.
`zones[].kind`	string		`"champion"`, `"qualify"`, `"playoff"`, `"relegation"`; erforderlich
`zones[].label`	string		maxLength: `40`
`groups`	array	`[]`	minItems: `0`; maxItems: `20`	Die Tabellen, dieselben Gruppen wie `groups` im screenrig.standings/v1-Feed. Ein Feed hat Vorrang, wenn vorhanden; sonst liefert der Datenspeicher dieselben Zeilen.
`groups[].name`	string		maxLength: `40`	Eine Konferenz, eine Division oder eine Gruppe. Ein Name, der mit dem Namen der Liga übereinstimmt, wird nicht angezeigt.
`groups[].rows`	array		minItems: `0`; maxItems: `40`; Pflichtfeld
`groups[].rows[].rank`	integer		Minimum: `1`; Maximum: `999`	Der Platz in der Gruppe; Zeilen ohne Platz behalten ihre Reihenfolge.
`groups[].rows[].team`	object		additionalProperties: `false`; erforderlich
`groups[].rows[].team.name`	string		maxLength: `60`; Pflichtfeld
`groups[].rows[].team.short`	string		maxLength: `8`	Der Kurzcode des Teams, mit dem der Favorit der Karte abgeglichen wird. Ohne Kurzcode nimmt die Karte drei Buchstaben aus dem Namen.
`groups[].rows[].played`	integer		Minimum: `0`; Maximum: `999`	Gespielte Spiele; wenn weggelassen, die Summe der Ergebnisse.
`groups[].rows[].won`	integer		Minimum: `0`; Maximum: `999`
`groups[].rows[].wonOt`	integer		Minimum: `0`; Maximum: `999`	Siege in der Verlängerung oder im Penaltyschießen, die zusammen mit `won` in der W-Spalte gezählt werden.
`groups[].rows[].drawn`	integer		Minimum: `0`; Maximum: `999`	Unentschieden oder Ties (die T-Spalte im Football).
`groups[].rows[].lost`	integer		Minimum: `0`; Maximum: `999`
`groups[].rows[].otl`	integer		Minimum: `0`; Maximum: `999`	Niederlagen in der Verlängerung oder im Penaltyschießen.
`groups[].rows[].diff`	integer		Minimum: `-9999`; Maximum: `9999`	Tordifferenz oder Punktedifferenz.
`groups[].rows[].points`	number		Minimum: `-999`; Maximum: `9999`	Punkte; ein Punktabzug kann ein Team unter 0 bringen.
`groups[].rows[].pct`	number		Minimum: `0`; Maximum: `1`	Der Anteil gewonnener Spiele, 0 bis 1, dargestellt als .732. Seine Spalte erscheint, wenn keine Zeile Punkte hat.
`groups[].rows[].form`	String oder Array		anyOf: `[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"enum":["W","D","L"]}}]`	Die letzten Ergebnisse, die ältesten zuerst, davon fünf angezeigt: ein String wie WWDLW (andere Buchstaben werden ignoriert) oder eine Liste aus W, D und L.
`groups[].rows[].zone`	string		`"champion"`, `"qualify"`, `"playoff"`, `"relegation"`	Färbt den Balken der Zeile: champion, qualify, playoff oder relegation.
`updatedAt`	string	`""`	maxLength: `40`	Wann die Tabelle abgerufen wurde, ISO 8601 (nur Datenspeicher; ein Feed enthält fetchedAt).

Canvas-Beispiel

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

{
  "theme": "neomustard"
}

screenrig card create --type standings --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": "standings",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "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:

{
  "league": null,
  "season": "",
  "zones": [],
  "groups": [],
  "updatedAt": ""
}

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":{"league":null,"season":"","zones":[],"groups":[],"updatedAt":""}}'