Tarjeta de posiciones para pantallas de señalización digital

Las posiciones en la liga suministradas aparecen con récords, puntos, forma reciente, zonas de clasificación y favoritos, a través de grupos rotativos y vistas de esquina. Primetime introduce resortes escalonados en filas, acentos cian para estados normales y un fondo lento de podio y clasificación. El descenso y las derrotas usan ámbar, mientras que los corchetes del equipo deportivo compartido marcan al líder de la zona de título suministrada. Una pequeña señal marca las actualizaciones pasadas del feed existentes, cambios de grupo y entregas de esquina de cinco segundos. El ranking, selección de columna, fijación de favorito y paginación mantienen sus reglas existentes. Una tabla de más de catorce filas se divide en páginas equilibradas que se turnan con los grupos, unos pocos equipos llenan la pantalla a un tamaño mayor, cada nombre comparte un tamaño y se ajusta en palabras, y un feed de un día anterior muestra su día y señala su antigüedad. Bajo movimiento reducido, se muestra una imagen fija compuesta.

Tarjeta en vivo

Esta tarjeta se dibuja en su navegador con el mismo código que ejecutan los Players, con datos de ejemplo.

Categoría: Deportes. Etiquetas: Clasificaciones y posiciones, Deportes en equipo, Escuelas y campus.

Diseños

Esta tarjeta de pantalla completa llena toda la pantalla en modo horizontal o vertical y no se coloca como esquina, chip o tira.

Diseños: completo. Formularios: horizontal, vertical.

Diseños, temas y publicación de tarjetas. Explorar las tarjetas.

Datos y privacidad

Feed: screenrig.standings/v1.

Los documentos del feed llevan atribución de la fuente. El Player suministra el feed a la tarjeta.

Propiedades

Para tema, fondo, acento y posición, consulte Propiedades comunes.

Establezca las propiedades estáticas en los params de la tarjeta al crearla. Su documento de datos solo contiene propiedades dinámicas. Las filas anidadas describen el contenido de su propiedad principal.

Propiedades estáticas

Nombre	Tipo	Predeterminado	Valores y límites	Descripción
`title`	string	`""`	maxLength: `40`	Vacío usa el nombre de la liga.
`count`	integer	`10`	mínimo: `1`; máximo: `24`	Equipos mostrados desde la parte superior de la tabla; un favorito debajo del corte toma el último lugar.
`group`	string	`""`	maxLength: `40`	El nombre de un grupo (una conferencia, una división). Páginas vacías para cada grupo.
`favourite`	string	`""`	maxLength: `8`	El código corto de un equipo; su fila está resaltada y su grupo permanece en pantalla.
`showForm`	boolean	`true`		Mostrar los últimos resultados de cada equipo.
`pageSeconds`	integer	`12`	mínimo: `5`; máximo: `60`	Segundos que cada grupo permanece visible al paginar.
`sport`	string	`"other"`	`"hockey"`, `"soccer"`, `"basketball"`, `"football"`, `"baseball"`, `"other"`
`hour12`	boolean	`false`
`timeZone`	cadena, nulo	`null`
`backgroundColor`	cadena, nulo	`null`	patrón: `"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	Sobrescribe el fondo y la placa de la tarjeta con un color plano ordenado por CSS. #RRGGBBAA suministra opacidad. background none tiene prioridad.
`textColor`	cadena, nulo	`null`	patrón: `"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	Sobrescribe los colores de texto principal y secundario. Los colores de acento y estado semántico mantienen sus roles.

Propiedades dinámicas

Nombre	Tipo	Predeterminado	Valores y límites	Descripción
`league`	objeto, nulo	`null`	additionalProperties: `false`	La competencia a la que corresponde la tabla; su nombre es el título cuando `title` está vacío. Gana la del feed.
`league.name`	string		maxLength: `60`; Requerido
`season`	string	`""`	maxLength: `20`	La temporada, por ejemplo 2026–27; gana la del feed.
`zones`	array	`[]`	minItems: `0`; maxItems: `4`	Nombres para la leyenda de las barras de color, uno por tipo; ganan los del feed.
`zones[].kind`	string		`"champion"`, `"qualify"`, `"playoff"`, `"relegation"`; Requerido
`zones[].label`	string		maxLength: `40`
`groups`	array	`[]`	minItems: `0`; maxItems: `20`	Las tablas, los mismos grupos que `groups` del feed screenrig.standings/v1. Un feed gana cuando está presente; de lo contrario, el almacén de datos suministra las mismas filas.
`groups[].name`	string		maxLength: `40`	Una conferencia, una división o un grupo. Un nombre igual al de la liga no se muestra.
`groups[].rows`	array		minItems: `0`; maxItems: `40`; Requerido
`groups[].rows[].rank`	integer		mínimo: `1`; máximo: `999`	El puesto en el grupo; las filas sin puesto conservan su orden.
`groups[].rows[].team`	object		additionalProperties: `false`; Requerido
`groups[].rows[].team.name`	string		maxLength: `60`; Requerido
`groups[].rows[].team.short`	string		maxLength: `8`	El código corto del equipo, con el que coincide el favorito de la tarjeta. Sin él, la tarjeta toma tres letras del nombre.
`groups[].rows[].played`	integer		mínimo: `0`; máximo: `999`	Juegos jugados; la suma de los resultados cuando se omite.
`groups[].rows[].won`	integer		mínimo: `0`; máximo: `999`
`groups[].rows[].wonOt`	integer		mínimo: `0`; máximo: `999`	Victorias en tiempo extra o en una tanda de penales, que se cuentan con `won` en la columna W.
`groups[].rows[].drawn`	integer		mínimo: `0`; máximo: `999`	Empates (la columna T del fútbol americano).
`groups[].rows[].lost`	integer		mínimo: `0`; máximo: `999`
`groups[].rows[].otl`	integer		mínimo: `0`; máximo: `999`	Derrotas en tiempo extra o en una tanda de penales.
`groups[].rows[].diff`	integer		mínimo: `-9999`; máximo: `9999`	Diferencia de goles o de puntos.
`groups[].rows[].points`	number		mínimo: `-999`; máximo: `9999`	Puntos; una deducción puede dejar a un equipo por debajo de 0.
`groups[].rows[].pct`	number		mínimo: `0`; máximo: `1`	La proporción de juegos ganados, de 0 a 1, que se muestra como .732. Su columna se muestra cuando ninguna fila tiene puntos.
`groups[].rows[].form`	cadena o arreglo		anyOf: `[{"type":"string","maxLength":20},{"type":"array","maxItems":20,"items":{"enum":["W","D","L"]}}]`	Los últimos resultados, del más antiguo al más reciente; se muestran cinco: una cadena como WWDLW (las demás letras se ignoran) o una lista de W, D y L.
`groups[].rows[].zone`	string		`"champion"`, `"qualify"`, `"playoff"`, `"relegation"`	Colorea la barra de la fila: champion, qualify, playoff o relegation.
`updatedAt`	string	`""`	maxLength: `40`	Cuándo se obtuvo la tabla, en ISO 8601 (solo almacén de datos; un feed lleva fetchedAt).

Ejemplo de lienzo

Guarde las propiedades estáticas como params.json y cree la tarjeta. El resultado incluye su id crd_.

{
  "theme": "neomustard"
}

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

Agregue este elemento a los primitives de una página de la lista de reproducción, con ese id en lugar del del ejemplo. Publique la lista de reproducción y asigne una pantalla.

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

Escribir datos en vivo

Escriba el documento en la tarjeta después de crearla y luego reemplácelo para actualizar la pantalla sin republicar. La tarjeta verifica cada escritura contra sus propiedades dinámicas y rechaza un documento que no acepta. Use el mismo proyecto que la lista de reproducción.

Guarde el documento como card-data.json. La CLI lee el documento en sí, sin envoltorio:

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

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

O llame a la API directamente. La API envuelve el mismo documento en un campo document. Un token de agente ya nombra su proyecto, por lo que no se envía encabezado de proyecto; si envía ScreenRig-Project, debe coincidir con el proyecto del token. Proporcione su autorización API a través del entorno; vea Autenticación 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":{"league":null,"season":"","zones":[],"groups":[],"updatedAt":""}}'