提供的社交帖子显示照片或文本、作者、网络和排队帖子。Primetime 引入温和的特色帖子进入、青色框架、多样非警告头像颜色和缓慢的标签与连接背景，接受的源更新和现有帖子轮换边界有静音提示。排序、过滤、限制、截断、图片回退和轮换保持不变，减少动画时显示稳定静态画面。
直播卡片
类别：媒体。标签：社交与观众，活动与场地，商店。
布局
此全屏卡在横屏或竖屏时填满整个屏幕，不作为角落、芯片或条带放置。
布局：全屏。表单：横向，纵向。
数据与隐私
信息源：screenrig.posts/v1。
信息源文档带有来源归属。播放器向卡片提供信息源。
属性
有关主题、背景、强调色和位置，请参见通用属性。
创建卡片时，在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。
静态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
title | string | "" | maxLength：60 | 空白时使用信息源名称。 |
intervalSeconds | integer | 10 | 最小值：5；最大值：120 | |
maxLength | integer | 220 | 最小值：60；最大值：500 | 较长的帖子在单词边界处截断并加省略号。 |
maxPosts | integer | 12 | 最小值：3；最大值：24 | 参与轮播的最新帖子数量。 |
showImages | boolean | true | ||
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})?$" | 覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。 |
动态属性
| 名称 | 类型 | 默认 | 数值和限制 | 描述 |
|---|---|---|---|---|
source | 对象，空值 | null | additionalProperties：false | 帖子来源的账号或话题标签；以数据源为准。 |
source.name | string | minLength：1；maxLength：60；必填 | ||
posts | array | [] | minItems：0；maxItems：50 | 帖子，与 screenrig.posts/v1 数据源的 posts 行相同：最新的在前，每条帖子需要文字或图片。存在数据源时以数据源为准；否则由数据存储提供相同的行。 |
posts[].author | string | maxLength：80；必填 | ||
posts[].handle | string | maxLength：60 | ||
posts[].avatar | string | maxLength：120 | 作者图片的媒体引用（media:<id>）；为空时显示其首字母。 | |
posts[].text | string | maxLength：1000 | ||
posts[].image | string | maxLength：120 | 帖子所附图片的媒体引用（media:<id>）。 | |
posts[].published | string | maxLength：40；必填 | 发布时间，ISO 8601瞬时。 | |
posts[].network | string | maxLength：20 | instagram、x（或 twitter）、facebook、tiktok、linkedin、threads 或 youtube；其他任何值则显示其自身名称。 |
画布示例
将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。
{
"theme": "neomustard"
}screenrig card create --type social-wall --major 1 --file params.json将此项目添加到播放列表页面的primitives中，并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。
{
"id": "social-wall",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}写入实时数据
创建卡片后向其写入文档，之后替换该文档即可更新屏幕，无需重新发布。卡片会按其动态属性检查每次写入，并拒绝它不接受的文档。请使用与播放列表相同的项目。
将文档保存为card-data.json。CLI直接读取文档，无需包装：
{
"source": null,
"posts": []
}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":{"source":null,"posts":[]}}'