提供的多轨数据按房间显示当前和下一场会议、演讲者和剩余时间,附带全天时间线并标记当前时间。横屏显示最多四个房间,当前叠加下一场,竖屏一次显示两个房间,房间减少时会议标题放大。无运行会议的房间将整张卡片用于下一场。Primetime 风格带来温和的房间面板进入、青色、黄色、绿色和橙色轨道颜色、缓慢的会议证带背景及会议边界的静音提示。现有规则继续管理房间选择、重叠会议优先级和日期选择。
直播卡片
类别:活动。标签:活动和场地,日程安排,导向和目录。
布局
此全屏卡在横屏或竖屏时填满整个屏幕,不作为角落、芯片或条带放置。
布局:全屏。表单:横向,纵向。
数据与隐私
此卡使用其配置的属性和实时卡数据。
属性
有关主题、背景、强调色和位置,请参见通用属性。
创建卡片时,在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "Schedule" | maxLength:40 | |
hour12 | boolean | false | ||
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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
sessions | array | [] | minItems:0;maxItems:120 | 节目的每个会话。卡片显示屏幕的当前日期,或有会话的下一天,或最后一天。 |
sessions[].title | string | minLength:1;maxLength:80;必填 | ||
sessions[].start | string | maxLength:32;必填 | ISO 8601。无偏移时为屏幕所在时区的本地时间:2026-10-14T09:30。 | |
sessions[].end | string | "" | maxLength:32 | ISO 8601 格式,和开始时间相同。缺省时,会话持续一小时。 |
sessions[].room | string | "" | maxLength:30 | 运行位置。若省略,表示会话在主会议室。 |
sessions[].track | string | "" | maxLength:30 | 所属的流,用其专属颜色绘制。 |
sessions[].speakers | array | [] | minItems:0;maxItems:4 | |
rooms | array | [] | minItems:0;maxItems:6 | 房间的顺序,以及今天无会议的房间。会议名称的房间按首次出现顺序排列;最多六个房间。 |
tracks | array | [] | minItems:0;maxItems:6 | 赛道的顺序,决定其颜色(四种颜色,之后循环)。 |
footnote | string | "" | maxLength:120 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}
screenrig card create --type conference --major 1 --file params.json
将此项目添加到播放列表页面的primitives中,并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "conference",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
写入实时数据
创建卡片后向其写入文档,之后替换该文档即可更新屏幕,无需重新发布。卡片会按其动态属性检查每次写入,并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档,无需包装:
{
"sessions": [],
"rooms": [],
"tracks": [],
"footnote": ""
}
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":{"sessions":[],"rooms":[],"tracks":[],"footnote":""}}'