叠加层组件
叠加层组件库的所有组件、ID 和主要设置
本页按照叠加层标签中的组件库分类，列出所有组件、URL 所用的 ID 及主要设置。
所有组件共有的设置
大部分组件打开后按相同的顺序排列分组：内容、组件自己的分组、文字、外观、阴影与层次、动画和位置与大小，并提供实时预览。下表列出各组件额外的设置。除实时提醒外，所有组件都可创建设置和 URL 独立的副本。如何访问副本，请参阅叠加层 URL。
所有组件共用的外观控件
| 分组 | 设置 |
|---|---|
| 阴影与层次 | 投影；设置阴影方向和距离的圆形转盘（按住 Shift 按 15° 吸附，双击重置）；快捷阴影（柔和、锐利、发光、长投影、内阴影）；柔和度、扩展、阴影强度、阴影颜色、内阴影；整个小组件下的小组件不透明度、倾斜和缩放；重置阴影与层次 |
| 文字 | 字重、对齐方式、字间距、行高、大小写、斜体、可读性效果（阴影、描边或发光；阴影有自己的方向） |
| 外观 | 圆角、边框宽度、边框颜色、边框样式（实线、虚线、点线或双线） |
| 动画 | 动画样式、退出样式（或与进入相同）、动效手感、动画时长、重播 |
| 位置与大小 | 左边距 (%)、上边距 (%)、宽度 (%)、高度 (%)、对齐到、铺满画布 |
缩放范围为组件尺寸的 0.25–3 倍，倾斜范围为 -180° 至 180°。粒子类组件、观众小伙伴和物理礼物罐等由自身形状投射阴影的组件，没有扩展、内阴影设置和内阴影快捷阴影。粒子类组件和观众小伙伴没有动画分组。
预览舞台会把组件框显示在它在画布上的位置：拖动组件框可移动，拖动控制点可调整大小，按住 Alt 可停止吸附。画布形状可在横屏 16:9与**竖屏 9:16（TikTok LIVE）**之间切换。
在每个组件的设置中，样式会打开样式工具：复制样式、粘贴样式、另存为预设…、我的样式和内置样式（简洁深色卡片、霓虹光晕、柔和浅色卡片、粗描边、玻璃和贴纸）。样式包括组件的颜色、文字、边框与圆角、阴影与层次以及动画；粘贴时只会复制两个组件都有的部分。最多可以保存 50 个样式。
聊天
| 组件 | ID | 主要设置 |
|---|---|---|
| 聊天框 | chat | 最大消息数、淡出时间（秒，0 = 不淡出）、隐藏 ! 和 / 命令、忽略的观众、显示头像、显示平台标识、昵称颜色、消息颜色、气泡颜色、气泡不透明度、气泡图片；布局下的消息样式（气泡、名字在前或名字在上）、新消息位置、消息宽度、头像大小、头像形状和表情和表情符号大小；高亮可突出指定的词语或观众 |
模拟聊天可向预览发送示例消息。
提醒
| 组件 | ID | 主要设置 |
|---|---|---|
| 实时提醒 | alerts | 提醒间隔（秒）、提醒时长（秒）、礼物最低钻石数（0 为全部）、点赞里程碑间隔、总音量、提醒声音播放位置、显示礼物图片、显示卡片背景、显示平台标识 |
礼物、关注、分享、点赞、订阅和突袭各有自己的自定义消息、提醒音效、图片与视频、更多音效（随机）、**时长（秒，0 为全局设置）**及颜色。**提醒间隔（秒）**上限为 60。提醒介绍每件礼物的变体和声音。
动态信息
| 组件 | ID |
|---|---|
| 礼物动态 | giftFeed |
| 钻石滚动条 | diamondTicker |
| 最近送礼者 | lastGifter |
| 最近关注者 | lastFollower |
| 最近点赞者 | lastLiker |
| 最近分享者 | lastSharer |
| 最近评论 | lastChatter |
| 最近订阅者 | lastSubscriber |
| 最近进入观众 | lastJoiner |
主要设置：显示内容（滚动列表或最近互动者）、事件、显示条数、最低钻石数、新条目出现位置（顶部、底部或滚动条）、显示头像、标题和行距。
计数器
| 组件 | ID |
|---|---|
| 观众人数 | viewerCount |
| 粉丝人数 | followerCount |
| 直播计时 | streamClock |
| 礼物计数器 1–3 | giftCounter1 至 giftCounter3 |
| 数据标签 1–3 | statLabel1 至 statLabel3 |
| 时钟与倒计时 | clock |
除时钟与倒计时外，主要设置为：数据来源（实时指标或直播时长）、指标、平台（单个平台或所有平台）、统计范围（本场直播或全部时间）、标签、前缀、后缀、数字格式和标签放在数值上方。
时钟与倒计时
Alpha 0.4.0 新增。它可以显示当前时间、日期、倒计时或正计时，添加后默认关闭。它只是一个普通时钟：礼物永远不会为它加时。如需马拉松直播时钟，请使用目标中的倒计时器。上方的直播计时则显示你已开播多久。
| 显示 | 作用 |
|---|---|
| 时间 | 当前时间。时区留空则使用这台电脑的时间，也可以输入 Asia/Tokyo 这样的时区 |
| 日期 | 今天的日期，按你选择的日期样式显示 |
| 倒计时 | 倒数到倒计时至中设定的日期和时间。5 分钟后、15 分钟后、30 分钟后和1 小时后可一键设定。归零后显示会用你的文字替换 0:00，例如“马上开始！” |
| 正计时 | 从正计时起点中设定的时刻开始计时，也可以点击从现在开始 |
在格式下：小时制（自动、12 小时制或24 小时制）、显示秒、显示时区、在时间下方显示日期、日期样式，以及用于倒计时或正计时的显示方式：时钟式（1:02:03）或单位式（1h 2m 3s）。在标签下：标签和标签位置（上方、下方、前面或后面），文字使用标签颜色。
倒计时或正计时以一个时间点的形式保存，因此即使 OBS 重新加载或 Vfinity 重启，它也会继续计时。时钟没有命令。
目标
| 组件 | ID | 主要设置 |
|---|---|---|
| 目标 1–4 | goal1 至 goal4 | 模式（进度条或倒计时挑战）、指标、目标值、时限（秒）、每轮目标增量、达成后（保持完成或开始下一个目标）、达成时文本、手动增加、重置进度 |
| 倒计时器 | timer | 起始时间、计时方向（倒数到零或从零正计时）、时钟格式、标题位置、每金币加秒数、按礼物加时、其他事件增加的时间、结束后收到礼物重新开始计时、结束文字、紧急提示阈值（秒，0 = 关闭）、进度条、显示增加的时间（+30 秒） |
| 金币罐 | coinJar | 形状（条形、圆形或罐子）、指标、装满所需值、反向倒数、显示头部观众头像、自动开始下一目标、每轮目标增量 |
| 直播首领 | streamBoss | 与金币罐相同 |
其他事件增加的时间包含每次关注加秒、每次分享加秒、每次订阅加秒、每位 Super Fan 加秒、每档点赞数和每档点赞加秒。每位观众只算一次让同一观众的关注每场只计一次。
排行榜
| 组件 | ID |
|---|---|
| 礼物榜 | topGifter |
| 点赞榜 | topLiker |
| 连续送礼榜 | topStreaker |
| 聊天榜 | topChatter |
| 积分排行榜 | pointsRanking |
| 鸣谢名单 | credits |
主要设置：排行依据、排行来源（Vfinity 统计或 TikTok 头部观众）、统计范围、显示名次、布局（排名列表或滚动鸣谢）、每轮秒数、金银铜前三名、隐藏这些观众、显示头像和显示平台标识。
特效
| 组件 | ID |
|---|---|
| 礼物炮 | giftCannon |
| 点赞喷泉 | likeFountain |
| 礼物烟花 | giftFirework |
| 飘雪 | fallingSnow |
| 表情化 | emojify |
| 表情墙 | emoteWall |
| 彩纸 | confetti |
主要设置：触发方式（某种互动或持续运行）、最低钻石数、粒子内容（发送者头像、礼物图片、自定义图片或基本形状）、每次粒子数、粒子大小、速度、重力、显示时长和粒子上限。
展示
| 组件 | ID | 主要设置 |
|---|---|---|
| 事件展示板 | events | 显示样式（列表、网格、滚动或幻灯片）、每项秒数、滚动方向、事件 |
| 文本 | staticText | 下述媒体设置 |
| 图片 | staticImage | 下述媒体设置 |
| 视频播放器 | videoPlayer | 下述媒体设置 |
| 社交账号轮播 | socialRotator | 下述媒体设置 |
| 赞助商横幅 | sponsorBanner | 下述媒体设置 |
| 摄像头边框 | webcamFrame | 样式、粗细、圆角、边框颜色、光晕、角落装饰、中间透明 |
| 场景边框 | overlayFrame | 与摄像头边框相同 |
| 发言横幅 | talkingBanner | 与摄像头边框相同 |
| 动作媒体 | actionMedia | 画面上限、将所有视频静音 |
| 自定义组件 | customWidget | 你的代码、向代码发送实时统计 |
| 场景卡 | sceneCard | 见下方的场景卡 |
| 清单 | checklist | 见下方的清单 |
文本、图片、视频播放器、社交账号轮播和赞助商横幅共用媒体设置。显示内容可选文本、图片、视频或轮播幻灯片，并提供相应的图片填充方式、视频 URL、循环播放、静音、每张幻灯片秒数和说明文字位置。动作媒体显示显示图片或视频步骤发送的内容。
场景卡
Alpha 0.4.0 新增。一张卡片涵盖直播前后和中途休息时的画面：即将开始、马上回来和直播结束。添加后默认关闭。
| 设置 | 作用 |
|---|---|
| 当前显示 | 用三个图块选择观众看到的画面 |
| 即将开始：标题、马上回来：标题、直播结束：标题 | 各画面的标题，下方还有一行副标题。留空时，标题分别为“即将开始”“马上回来”和“感谢观看！” |
| 社交账号 | 一行文字，例如 @you · youtube.com/@you |
| 布局 | 全屏、卡片或底部横条 |
| 倒计时 | 开始（之后变为重新开始）、停止、加一分钟和减一分钟；分钟数（1–240，初始为 5）；归零后显示会用你的文字替换倒计时，留空则隐藏倒计时 |
| 轮播消息 | 最多 12 行文字，在标题下方轮流显示；每条显示秒数（3–120）和切换方式（淡入淡出或滑动） |
| 背景 | 颜色或图片；使用图片时可设置着色颜色和着色强度 |
倒计时以结束的时刻保存，因此即使 OBS 重新加载或 Vfinity 重启，它也会继续计时。
| 命令 | 作用 |
|---|---|
sceneCard.showStarting、sceneCard.showBrb、sceneCard.showEnding | 显示对应画面并开启场景卡 |
sceneCard.hide | 关闭场景卡 |
sceneCard.countdownStart、sceneCard.countdownStop | 开始或停止倒计时 |
每条命令都会作用于场景卡及其所有副本。除 sceneCard.hide 外，其余命令也都在卡片的右键菜单中。
清单
Alpha 0.4.0 新增。一份可以在直播中逐项勾选的列表，例如本场直播的目标。添加后默认关闭。
| 设置 | 作用 |
|---|---|
| 项目 | 在新项目中输入内容并按 Enter 添加，最多 30 项。勾选某项即可在直播画面上将其标为完成，拖动手柄可调整顺序，删除后可撤销。勾选下一项和全部取消勾选作用于整个列表 |
| 显示标题、标题 | 列表的标题，留空时为“直播目标” |
| 显示计数（3/5）、显示进度条 | 显示列表完成了多少 |
| 已勾选的项目 | 划掉、变淡或隐藏 |
| 标记 | 方框、圆圈、对勾或编号 |
| 同时显示的项目数 | 1–30。列表较长时会滚动，让第一个未完成的项目保持可见 |
| 勾选时让该项闪一下 | 勾选某项时短暂高亮 |
| 命令 | 作用 |
|---|---|
checklist.checkNext | 勾选下一个未完成的项目 |
checklist.uncheckAll | 取消勾选所有项目 |
这些命令也会作用于显示同一列表的所有副本，并且都在卡片的右键菜单中。
互动
| 组件 | ID | 主要设置 |
|---|---|---|
| 物理礼物罐 | giftJar | 清空礼物罐 |
| 幸运转盘 | wheel | 带权重的选项、聊天指令（!spin）、旋转冷却（秒）、礼物最低钻石数（0 不通过礼物旋转） |
| 聊天投票 | poll | 选项、聊天指令（!vote）、开始新投票、结束投票 |
| 观众队列 | viewerQueue | 聊天指令（!join）、最大条目数、下一位观众、打开 / 关闭队列 |
| 抽奖 | giveaway | 聊天指令（!enter）、谁可参与、最大参与人数、每位观众最多抽奖券、额外抽奖券礼物价值（钻石）、每个礼物额外抽奖券（0 关闭）、不重复中奖 |
| 拔河 | tugOfWar | 两队名称、颜色、聊天投票（!red、!blue）和为该队拉绳的礼物；每票分数、每钻石分数、每赞分数（0 关闭）、获胜分数（0 无）、回合时长（秒，0 不计时）、下一回合等待时间（秒，0 关闭） |
| 热度计 | hypeMeter | 热度来源、每秒下降、带名称、颜色及点数的等级、方向 |
| 观众小伙伴 | viewerBuddies | 同时最多小伙伴数、安静多久后离开、小伙伴大小、行走速度、名字标签、聊天对话气泡、点赞时飘出爱心、字体 |
转盘两次旋转至少间隔 4 秒。热度计的五个初始等级依次为升温、火热、燃起来了、烈焰和传奇。观众进入、关注或订阅、送礼时也可生成小伙伴；测试：召唤一个小伙伴会向 OBS 发送示例。
游戏组件的命令见命令的游戏章节，结果触发器见触发器的游戏章节。