触发器
事件可以监听的每个触发器，包括其专属字段、来源平台以及填充的变量
事件编辑器中事件类型菜单包含的所有触发器，连同其添加的字段、发送该触发器的平台，以及动作步骤可用的模板变量。
该菜单首先列出直播中发生的互动事件，随后列出两个通过输入文本进行匹配的触发器：API 触发和聊天消息。有关如何选择触发器的指南，请参阅选择触发器。
选择事件类型和步骤类型。下方的字段会随之变化，与应用中一致。
观众互动
| 触发器 | 触发时机 | 发送来源 | 专属字段 |
|---|---|---|---|
| 礼物 | 收到礼物，或连击结束时 | TikTok LIVE、Twitch、Kick、YouTube | 礼物名称、目录、匹配、价值至少 |
| 点赞 | 观众轻点屏幕时 | TikTok LIVE | 无 |
| 关注 | 有观众关注你时 | TikTok LIVE、Twitch、Kick | 无 |
| 分享 | 有观众分享直播间时 | TikTok LIVE | 无 |
| 聊天消息 | 聊天消息匹配指定文本时 | TikTok LIVE、Twitch、Kick、YouTube | 触发文本、匹配方式、区分大小写、每次命令消耗的积分、将第一个命令参数用于模型移动 |
| 本场直播首次发言 | 观众在本场直播中发送的第一条消息 | TikTok LIVE、Twitch、Kick、YouTube | 无 |
| 观众进入直播间 | 观众进入直播间时 | TikTok LIVE | 无 |
| 订阅 | 观众进行订阅时，或 YouTube 会员加入或达到里程碑时 | TikTok LIVE、Twitch、Kick、YouTube | 无 |
| 超级粉丝 | 观众成为超级粉丝时 | TikTok LIVE | 无 |
| 订阅者表情 | 订阅者发送表情时 | TikTok LIVE | 无 |
| 宝箱 | 观众投放宝箱时 | TikTok LIVE | 无 |
| LIVE提问 | 观众在直播中发起提问时 | TikTok LIVE | 无 |
| 突袭 仅限 Twitch | 其他频道向你发起突袭（Raid）时 | Twitch | 无 |
| Twitch 频道积分 仅限 Twitch | 观众兑换频道积分奖励时 | Twitch | 奖励菜单、任意奖励、刷新奖励 |
观众进入直播间在任意 30 秒内对同一位观众仅触发一次，因此观众断开重连不会重复触发两次。本场直播首次发言每场直播最多可记录 50,000 名观众。
来自 Twitch、Kick 和 YouTube 的礼物
Twitch、Kick 和 YouTube 上的付费互动会作为礼物送达礼物触发器，并附带你在 设置积分事件价值 中设置的钻石价值。在礼物名称中输入以下名称即可对其做出反应。
| 礼物名称 | 对应内容 |
|---|---|
Cheer | Twitch Bits |
Gift Sub | Twitch 或 Kick 上赠送的订阅，或赠送的 YouTube 会员 |
Kicks | Kick 专属礼物代币 |
Super Chat | YouTube 的 Super Chat，按其金额折算钻石 |
Super Sticker | YouTube 的 Super Sticker，按其金额折算钻石 |
| 礼物本身的名称 | YouTube Jewels 礼物，不计钻石 |
| 奖励名称 | Twitch 频道积分兑换，或 Kick 奖励 |
随 Cheer、Kicks 礼物或 Super Chat 一起发送的消息会填入 {comment}。Super Chat 的消息还会在礼物之后作为一条聊天消息到达。
Twitch 频道积分与 YouTube 会员
Twitch 频道积分按 ID 匹配奖励，因此你在 Twitch 上给奖励改名后它仍然有效。任意奖励匹配每一次兑换，Twitch 重复报告的同一次兑换只会运行一次。当 Twitch 已连接并以频道主播身份登录时，菜单会列出你的自定义奖励及其积分花费。
在 YouTube 上，新会员和会员里程碑会触发订阅，每位收到赠送会员的观众也会触发。在谁可以触发中，频道会员算作订阅者。
直播时刻与里程碑
| 触发器 | 触发时机 | 专属字段 |
|---|---|---|
| 直播开始 | 在任意平台上开启一场新直播时，或你提前加入的 YouTube 预定直播开播时 | 无 |
| 直播结束 | 直播结束时。在 YouTube 上会在一分钟内触发 | 无 |
| 直播间点赞里程碑 | 直播间累计点赞数超过设定阈值时 | 阈值、每达到一个倍数都触发 |
| 观众人数里程碑 | 直播间内的观众人数超过设定阈值时 | 阈值、每达到一个倍数都触发 |
| 粉丝数里程碑 | 你的粉丝总数超过设定阈值时 | 阈值、每达到一个倍数都触发 |
| 对战 | TikTok PK 对战开始、更新或结束时 | 对战阶段、对战结果（可选） |
| TikTok LIVE目标 | 你的 TikTok 直播目标状态发生变动时 | 仅在达成LIVE目标时触发 |
| 欢呼列车 仅限 Twitch | 欢呼列车（Hype Train）开始或结束时 | 对战阶段：begin 或 end |
| 每隔几分钟 | 倒计时结束时 | 运行间隔、随机额外时间、仅在我直播时 |
阈值默认从 100 起步，可填入从 1 起的任意正整数。里程碑在你加入直播间时读取一次当前数值并以此为基准开始计数，因此加入一场正在进行中的直播绝不会补放已经过去的里程碑。若未勾选每达到一个倍数都触发，则每场直播仅触发一次。直播间点赞里程碑读取 TikTok 的点赞总数，因此在 Twitch、Kick 和 YouTube 上会保持静默。
对战阶段提供 start、progress 和 end 三个选项。对战结果（可选）提供无、win、lose 和 draw。
突袭、欢呼列车和 Twitch 频道积分会在 Twitch 至少连接成功一次后出现在菜单中。
每隔几分钟
| 字段 | 取值范围 | 默认值 |
|---|---|---|
| 运行间隔 | 1–240 分钟，并提供 5、10、15、30 和 60 分钟的快速选择 | 10 分钟 |
| 随机额外时间 | 0 到执行间隔本身的时间（分钟） | 0 |
| 仅在我直播时 | 开启或关闭 | 开启 |
首次执行将在倒计时开始后的一个完整间隔后到来，绝不会立即执行。当 Vfinity 处于暂停状态时落入的执行会被跳过，而紧急停止会将每个倒计时重置重新开始。
游戏与叠加层小组件
当叠加层标签页中的小组件得出结果时触发。
| 触发器 | 触发时机 | 键值字段过滤条件 |
|---|---|---|
| 叠加层目标达成 | 目标小组件达到其目标值时 | 目标的小组件 ID，例如 goal1 |
| 计时器归零 | 倒计时归零，或正计时达到设定目标时 | 保持留空 |
| 转盘结果 | 幸运大转盘停止转动时 | 某个选项的结果 ID |
| 抽奖中奖者 | 抽奖转轮定格在中奖者时 | 无键值字段 |
| 拔河获胜 | 一轮拔河比赛决出胜者时 | 1、2 或队伍名称 |
| 达到热度等级 | 热度计攀升进入某一等级时 | 等级序号（1–5）或等级名称 |
该键值字段为小组件ID或结果ID（留空匹配全部）。队伍名称和等级名称匹配时不区分大小写。热度计必须下降到低于该等级 10% 后，该等级才能再次被触发。
文本匹配触发器
| 触发器 | 字段 | 匹配对象 |
|---|---|---|
| API 触发 | 触发名称 | 发送至本地 API 或触发 API 的 name 字段，忽略大小写 |
| 聊天消息 | 触发文本 | 聊天消息，依据下方的匹配方式进行比对 |
聊天匹配方式
| 方式 | 判定消息匹配的条件 |
|---|---|
| 包含（默认） | 文本出现在消息的任意位置 |
| 完全匹配 | 消息内容与文本完全一致 |
| 开头是 | 消息以该文本开头 |
| 命令与参数 | 消息以该指令开头（如 !spin）；其后的单词被解析为参数 |
| 受限正则表达式 | 消息匹配正则模式；捕获组被解析为参数 |
勾选区分大小写可严格区分英文字母大小写。正则表达式支持锚点、字符类、捕获组和最多 32 次的固定重复。
每次命令消耗的积分可设置 0–1,000,000 积分。积分不足的观众无法触发该事件；若排队的执行在开始前被丢弃，积分将自动退还。
将第一个命令参数用于模型移动会将第一个参数传递给每个移动模型步骤：旋转（°）、大小、X 位置 或 Y 位置。观众发送 !spin 90 可让模型旋转 90°。非数字的参数值将终止事件执行且不消耗积分。
所有触发器通用的高级字段
位于事件编辑器中的高级设置。
| 字段 | 适用触发器 | 范围或选项 |
|---|---|---|
| 最少礼物数、最少点赞数 或 最小数量 | 除里程碑和每隔几分钟之外的所有触发器 | 0 或更大整数 |
| 延迟（毫秒） | 所有触发器 | 0 或更大整数，在整个动作列表执行前等待 |
| 统计方式 | 除每隔几分钟之外的所有触发器 | 按每位观众分别统计 或 统计所有观众的数量 |
| 启用频率限制 | 所有触发器 | 在时间窗口（秒）内的最大触发次数；初次开启时默认为 60 秒内 5 次 |
| 数量行为 | 礼物 | 每个礼物事件只执行一次、按数量重复执行 xN、按数量延长时长 xN |
| 计数 | 设为统计所有观众的数量的礼物 | 礼物 或 钻石 |
| 最多（◆） | 礼物 | 1–1,000,000 钻石，或不限 |
| 价值计算 | 礼物 | 整个连击（礼物 × 数量） 或 单个礼物 |
当计数设置为钻石时，每当所有人的钻石累计超过要累计的钻石时就会触发一次事件，单次连击中最多触发 20 次。
步骤下方的设置包含规则配置：谁可以触发、冷却时间 和 动作队列。规则与冷却对此有详细说明。
| 规则 | 取值范围 | 默认值 |
|---|---|---|
| 谁可以触发 | 关注者、互关好友、订阅者、超级粉丝、管理员、粉丝团成员、礼物榜前列 | 所有人 |
| 取前几名送礼观众 | 1–100 | 3 |
| 始终允许、始终不允许 | 各自最多 200 个名称 | 留空 |
| 每位观众（秒）、所有人共用（秒） | 0–86,400 | 0 |
| 冷却期间 | 忽略该触发 或 等待结束后执行 | 忽略该触发 |
| 队列名称（同名队列按顺序执行） | 最多 64 个字符 | default |
| 优先级（越高越先执行） | −1000 至 1000 | 0 |
| 排队执行过期时间（秒） | 1–3600 | 120 |
各触发器填充的变量
凡是指明观众身份的触发器均会填充 {name}、{nickname}、{uniqueId} 和 {points}，且每个触发器均会填充 {trigger}。以下触发器还会补充其特有的变量：
| 触发器 | 增加的变量 |
|---|---|
| 礼物 | {gift}、{count}、{diamonds}、{totalDiamonds}；礼物附带消息时还有 {comment} |
| Twitch 频道积分 | {rewardName}、{rewardCost}、{rewardId}、{redemptionId}；需要观众输入文字的奖励还有 {comment} |
| 点赞 | {count}、{likes}、{totalLikes} |
| 聊天消息 | {comment}、{args}、{arg1} 至 {arg9} |
| 本场直播首次发言 | {comment} |
| 订阅 | {months} |
| 突袭 | {viewers} |
| 宝箱 | {coins} |
| 订阅者表情 | {emoteUrl} |
| LIVE提问 | {questionText} |
| 欢呼列车 | {phase}、{level}、{total} |
| 直播间点赞里程碑 | {totalLikes} |
| 观众人数里程碑 | {viewers} |
| 粉丝数里程碑 | {followers} |
| 叠加层目标达成 | {value}、{target}、{cycle} |
| 转盘结果 | {result} |
| 抽奖中奖者 | {winner}、{tickets}、{entrants} |
| 拔河获胜 | {team}、{score}、{otherScore} |
| 达到热度等级 | {level}、{levelName} |
| API 触发 | 传入触发器的 data 中的每个顶层文本、数字或布尔字段 |
模板变量列出了每个变量的具体含义。