Cartão de eventos para telas de sinalização digital

Os próximos dias de um calendário mostram o que está acontecendo agora, o que vem a seguir e a agenda, com linhas cortadas para caber no tamanho real e nunca encolhidas. Ele preenche a tela inteira, cabe em qualquer retângulo, fica no meio, se encaixa em um canto, corre como uma linha em um canto ou como uma faixa ao longo de uma borda. Você escolhe a tela cheia como agenda, uma placa de porta de sala que lê Disponível ou Em uso com reservas posteriores, ou sete colunas para a semana. Você define quantos dias mostrar, o máximo de linhas da agenda, o relógio como 12 horas, 24 horas ou horário militar, se o local aparece, e se o cartão fica oculto até um evento estar em andamento ou prestes a começar.

Cartão ao vivo

Este cartão é desenhado no seu navegador pelo mesmo código que os Players executam, com dados de exemplo.

Categoria: Eventos. Etiquetas: Programações, Eventos e locais, Saguões e recepção, Escritórios e locais de trabalho, Escolas e campi.

Layouts

Este cartão principal se encaixa em qualquer layout: tela cheia, centro, largo, canto, chip, faixa ou qualquer retângulo livre.

Layouts: cheio, livre, centro, largo, canto, chip, faixa. Formas: paisagem, retrato.

Layouts, temas e publicação de cartões. Veja os cartões.

Dados e privacidade

Feed: screenrig.events/v1.

Documentos do feed carregam atribuição da fonte. O Player fornece o feed para o cartão.

Propriedades

Para tema, fundo, destaque e posição, veja Propriedades comuns.

Defina as propriedades estáticas nos params do cartão ao criá-lo. O documento de dados dele contém apenas propriedades dinâmicas. Linhas aninhadas descrevem o conteúdo da propriedade pai.

Propriedades estáticas

Nome	Tipo	Padrão	Valores e limites	Descrição
`title`	string	`""`	maxLength: `60`	Vazio usa o nome do calendário.
`mode`	string	`"agenda"`	`"agenda"`, `"next"`, `"week"`	Composição em tela cheia: agenda (agora, próximo e a agenda), próximo (placa da porta de uma sala: Disponível ou Em uso, depois o que está acontecendo e as reservas posteriores do dia) ou semana (sete colunas diárias). Centro, canto, chip e faixa sempre mostram agora ou próximo.
`days`	integer	`7`	mínimo: `1`; máximo: `14`
`maxEvents`	integer	`8`	mínimo: `1`; máximo: `20`	No máximo este número de linhas na agenda; as linhas também são cortadas para a sala, nunca reduzidas.
`hourCycle`	string	`"24"`	`"12"`, `"24"`, `"military"`	12: 14h05. 24: 14:05. militar: 1405, quatro dígitos sem separador (e HRS quando o sufixo aparece).
`showLocation`	boolean	`true`
`timeZone`	string, nulo	`null`		Zona IANA; nulo usa a zona da tela.
`presence`	string	`"always"`	`"always"`, `"active"`	ativo: o cartão está ausente até que um evento esteja ativo ou comece dentro de leadMinutes.
`leadMinutes`	integer	`15`	mínimo: `1`; máximo: `240`	Com presença ativa, quantos minutos antes de um evento começar o cartão aparece.
`backgroundColor`	string, nulo	`null`	padrão: `"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	Substitui o fundo e a placa do cartão por uma cor plana ordenada por CSS. #RRGGBBAA fornece opacidade. background none tem precedência.
`textColor`	string, nulo	`null`	padrão: `"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"`	Substitui as cores do texto principal e secundário. As cores de destaque e status semântico mantêm seus papéis.

Propriedades dinâmicas

Nome	Tipo	Padrão	Valores e limites	Descrição
`events`	array, null	`null`	maxItems: `200`	Ocorrências de calendário fornecidas pelo agente. Null usa o feed do host; um array vazio limpa a agenda. Expanda recorrências antes de gravar.

Exemplo de tela

Salve as propriedades estáticas como params.json e crie o cartão. O resultado traz o id crd_ dele.

{
  "theme": "neomustard"
}

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

Adicione este item aos primitives de uma página da playlist, com esse id no lugar do id do exemplo. Publique a playlist e atribua uma tela.

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

Escrever dados ao vivo

Escreva o documento no cartão depois de criá-lo e depois substitua-o para atualizar a tela sem republicar. O cartão verifica cada gravação contra suas propriedades dinâmicas e recusa um documento que ele rejeita. Use o mesmo projeto da playlist.

Salve o documento como card-data.json. O CLI lê o documento em si, sem invólucro:

{
  "events": null
}

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

Ou chame a API diretamente. A API envolve o mesmo documento em um campo document. Um token de agente já nomeia seu projeto, então nenhum cabeçalho de projeto é enviado; se você enviar ScreenRig-Project, ele deve corresponder ao projeto do token. Forneça sua autorização de API pelo ambiente; veja Autenticação da 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":{"events":null}}'