从事件来源开始
Multi Alerts 展示的是 Social Stream 已经捕获到的事件。它本身不会登录 Twitch、Kick、YouTube、TikTok 或其他平台。
- 连接并激活提供该事件的平台来源。
- 保持该来源页面或独立应用的来源窗口活跃。
- 在来源、弹出菜单、停靠面板和 Multi Alerts URL 中使用相同的 Social Stream 会话 ID。
- 排查平台连接前，先从提醒叠加层的选项中测试它。
预览成功证明提醒布局正常。 这不能证明平台来源有权接收该真实事件。
Multi Alerts 类别
| 类别 | 常用事件名称 | 说明 |
|---|---|---|
| 关注 | new_follower, follow, followed | 需要能捕获关注事件的来源，以及必要的平台权限。 |
| 订阅 | new_subscriber, resub, subscription_gift、会员别名 | 在受支持时，包含周期性订阅、赠送和会员类事件。 |
| 打赏 / 礼物 | superchat, supersticker, gift, tip、打赏别名 | 打赏类聊天条目也可以改用 hasDonation 和 donoValue. |
| Bits | cheer, bits | 可使用最低打赏/现金选项过滤金额。 |
| 突袭 | raid, host, redirect | 可用性和命名取决于平台来源。 |
| 拍卖 | auction_update | 拍卖获胜提醒需要主动启用。 |
| Hype Train | hype_train | Hype Train 提醒需要主动启用，并要求符合条件的 Twitch EventSub 访问权限。 |
观众人数、关注者总数、直播状态和广告时段状态属于更新，不是普通提醒卡片。请使用 事件参考 ，用于构建 API 使用方或自定义叠加层。
主要平台事件
当所选来源模式能够提供对应活动时，以下为当前的规范事件名称。
| 活动 | YouTube | Twitch | Kick |
|---|---|---|---|
| 新会员 / 订阅者 | sponsorship |
new_subscriber |
new_subscriber |
| 续订 | resub |
resub |
resub |
| 赠送会员 / 订阅 | giftpurchase, giftredemption |
subscription_gift |
subscription_gift |
| 付费支持 | superchat, supersticker, jeweldonation |
cheer，或带有以下字段的条目： hasDonation |
gift 用于 KICKs 礼物； donation 用于支持/小费事件。两者都会填充 hasDonation. |
| 关注 / 公开订阅者提醒 | new_follower；受 API 延迟影响，且仅包含公开订阅 |
new_follower |
new_follower |
| 频道奖励 | - | reward |
reward |
| 突袭 / 主持转播 | - | raid |
仅接受兼容输入；不是当前官方 Kick 事件订阅 |
Kick raid 说明： 为保持兼容，Social Stream 接受旧版 raid/host 结构的载荷，但 Kick 当前官方事件目录没有 raid/host 订阅。不要让 Kick 工作流依赖接收此类事件。
标准模式与 WebSocket 模式
| 平台 | 标准捕获 | WebSocket / API 捕获 |
|---|---|---|
| YouTube | 付费消息、会员、会员赠礼、观众更新，以及有限的页面检测事件。 | 共同支持的付费/会员事件，以及会员里程碑、近期公开订阅者提醒和受支持的计数更新。 |
| Twitch | 在聊天中呈现的奖励、赠送订阅通知、观众更新，以及一些仅在页面中出现的通知。 | 在账号和权限范围允许时，EventSub 会增加关注、订阅、续订、cheers、raids、奖励，以及受支持的计数/状态事件。 |
| Kick | 聊天，以及礼物、奖励和观众更新的轻量页面标记。 | 身份验证后可接收官方的关注、订阅、礼物、奖励兑换、KICKs、管理和直播状态事件。 |
对于由事件触发的提醒，WebSocket 模式通常是合适的选择。当仅需要页面中显示的聊天，或无法进行身份验证时，标准捕获仍然有用。
启用所需的提醒类型
从 Social Stream 设置中打开 Multi Alerts 选项。关注、订阅、打赏、Bits 和 raid 都有各自的启用、样式、声音和外观控件。拍卖和 Hype Train 提醒需要通过专用选项主动启用。
- 使用 提醒排队 ，适用于可能同时到达多个事件的情况。
- 事件在停靠面板正常，但在 Multi Alerts 中不正常时，请检查来源过滤器。
- 缺少小额打赏或 cheers 时，请检查最低现金/打赏过滤器。
- 如果自定义提醒音频被自动播放规则阻止，请先与浏览器页面互动一次。
开播前预览
使用预览控件验证所选类别、文本、金额、媒体、声音、动画和队列行为。
各工具使用哪些字段
| 工具 | 兼容规则 |
|---|---|
| Multi Alerts | 将规范的 event 名称、别名、 hasDonation、会员字段，以及所选的 meta 值归入共享类别。 |
| Event Flow | 精确匹配 type, event，以及来源发出的字段。在依赖真实事件前，请先使用“测试消息”工具。 |
| TTS | 默认会跳过事件条目，除非它们属于打赏类。添加 &readevents ，让非打赏事件消息也能被朗读，然后应用常规 TTS 过滤器。 |
| 打赏罐 / 目标进度条 | 普通模式使用打赏金额。Hype 模式还可按会员、续订和赠送会员字段计分。 |
| 自定义叠加层 / API 使用方 | 使用事件参考中的规范载荷字段。仅为向后兼容而接受文档中记录的别名。 |
使用 创建测试消息 ，验证预期的事件以及 Event Flow 实用示例 ，查看可用的自动化示例。
平台设置说明
| 平台 | 首先检查 | 指南 |
|---|---|---|
| Twitch | 使用主播或有权限的版主账号登录，并保持 EventSub 连接。 | Twitch EventSub 设置 |
| Kick | 有针对性地选择来源模式，并在所需官方事件要求身份验证时完成验证；不要预期会收到官方 raid 事件。 | Kick 设置与身份验证 |
| 其他来源 | 确认所选来源实际会发出该事件类型，而不只是聊天消息。 | 支持的网站 |
真实提醒缺失时
- 确认在来源自身的日志、停靠面板或 API 输出中收到了该事件。
- 确认来源和 Multi Alerts 页面使用相同的会话 ID 和密码。
- 确认该类别已启用，且未被来源或频道过滤器排除。
- 检查打赏和 Bits 的最低金额过滤器。
- 对于 Twitch 或 Kick，如果聊天正常但受保护的事件不正常，请重新登录。
- 让来源窗口保持活跃，足够长时间以观察到真实事件；仅有预览不算平台的端到端测试。
如果涉及多个设备或连接模式，请查看 会话、密码与中继模式.