從事件來源開始
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，如果聊天正常但受保護的事件不正常，請重新登入。
- 讓來源視窗保持作用中，足夠長時間以觀察到真實事件；僅有預覽不算平台的端對端測試。
如果涉及多個裝置或連線模式，請查看 工作階段、密碼與轉送模式.