提供的队伍和轮次得分显示并列排名、变动和领先差距,附带主办方消息和最终领奖台。Primetime 风格带来错落的行和领奖台弹簧、青色常规游戏强调和缓慢的答题纸与铅笔背景。计分或间隔期间,琥珀色括号接管;克制彩带标示最终计分领先者。现有规则仍管理总分、并列、轮次最佳、领奖台选择和分页,减少动画时显示稳定静态画面。
直播卡片
类别:体育。标签:记分板,排行榜和排名,酒吧和酒馆。
布局
此全屏卡在横屏或竖屏时填满整个屏幕,不作为角落、芯片或条带放置。
布局:全屏。表单:横向,纵向。
数据与隐私
此卡使用其配置的属性和实时卡数据。
属性
有关主题、背景、强调色和位置,请参见通用属性。
创建卡片时,在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "Pub quiz" | maxLength:40 | 测验名称,显示在标题中。 |
showTables | boolean | true | 在团队名称旁显示其桌号。 | |
podium | boolean | true | 测验结束时,将前三名放置于表格上方领奖台。 | |
hour12 | boolean | false | ||
timeZone | 字符串,空值 | null | ||
backgroundColor | 字符串,空值 | null | 模式:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | 用纯色 CSS 顺序覆盖卡片背景和底板。#RRGGBBAA 提供透明度。背景无则优先。 |
textColor | 字符串,空值 | null | 模式:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
rounds | array | [] | maxItems:12 | 轮次顺序:名称和可得分数。队伍得分与之对应。 |
rounds[].name | string | "" | maxLength:30 | |
rounds[].max | 数字,空值 | null | 该轮最多可得分数。 | |
teams | array | [] | maxItems:64 | 各队及其每轮得分;榜单按总分排名。 |
teams[].name | string | minLength:1;maxLength:60;必填 | ||
teams[].table | 字符串,整数 | "" | 球队表,显示在球队名称旁。 | |
teams[].scores | array | [] | maxItems:12 | 每回合得分顺序;空值(或尚无)表示该回合未标记。 |
teams[].bonus | 数字,空值 | null | 小丑或奖金点数加入总分。 | |
round | integer | 0 | 最小值:0;最大值:12 | 当前轮次(1 是第一轮);第一轮之前为 0。 |
status | string | "playing" | "playing", "scoring", "break", "final" | 正在进行的回合,标记中,间隔内或最终结果。 |
message | string | "" | maxLength:80 | 主机横幅上的一行:间隔,十分钟后回来。 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}
screenrig card create --type quiz-board --major 1 --file params.json
将此项目添加到播放列表页面的primitives中,并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "quiz-board",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
写入实时数据
创建卡片后向其写入文档,之后替换该文档即可更新屏幕,无需重新发布。卡片会按其动态属性检查每次写入,并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档,无需包装:
{
"rounds": [],
"teams": [],
"round": 0,
"status": "playing",
"message": ""
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json
或直接调用 API。API 将相同文档包装在 document 字段中。智能体令牌已指定其项目,因此不发送项目头;若发送 ScreenRig-Project,必须与令牌项目匹配。通过环境提供 API 授权;详见 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":{"rounds":[],"teams":[],"round":0,"status":"playing","message":""}}'