3. 連接平台 API 節點
此步驟要做的事:將直播平台的聊天・打賞接收節點連接至 MARS 事件輸入節點,使實際聊天 !Throw 能觸發反應。
準備事項
- 完成第 2 步的場景(規則
Throw已啟用) - 所用平台的整合外掛並已登入
- CHZZK:工作坊 CHZZK 外掛
- SOOP:工作坊 SOOP 外掛
- Twitch:Warudo 基本功能(在 Settings → Twitch 中連接)
操作步驟
- 在藍圖頁籤點擊 + 建立新藍圖,命名為
平台 → MARS。 與反應藍圖分開管理較為方便。 - 放置平台接收節點。例如 CHZZK 的話放置 CHZZK Chat Receiver。
- 從 Moraecat 分類中放置 MARS 事件輸入節點。
- 選擇 MARS 事件輸入的事件類型。連接聊天節點選聊天,打賞節點選打賞。 變更事件類型後,下方欄位名稱會依該類型更新。(例:打賞 → 金額・訊息・打賞種類,訂閱 → 月數・訊息・等級)
- 依照下方對照表連接線路。流程輸出(→ 形狀)連至執行,資料連至相對應的欄位。空白欄位可留空。
- 儲存場景。
CHZZK 聊天接收CHZZK 外掛
MARS 事件輸入事件類型:聊天
每個事件各放一個 MARS 事件輸入。若同時使用聊天和打賞,事件輸入節點也要放兩個。
CHZZK(CHZZK 外掛)
| 接收節點 | MARS 事件類型 | 接收節點輸出 → MARS 事件輸入 |
|---|---|---|
| CHZZK Chat Receiver | 聊天 | Exit → 執行 · Nickname → 暱稱 · SenderChannelId → 使用者ID · Content → 訊息 |
| CHZZK Donation Receiver | 打賞 | Exit → 執行 · DonatorNickname → 暱稱 · DonatorChannelId → 使用者ID · PayAmount → 金額 · DonationText → 訊息 · DonationType → 打賞種類 |
| CHZZK Subscription Receiver | 訂閱 | Exit → 執行 · SubscriberNickname → 暱稱 · SubscriberChannelId → 使用者ID · Month → 月數 · TierName → 等級 |
SOOP(SOOP 外掛)
| 接收節點 | MARS 事件類型 | 接收節點輸出 → MARS 事件輸入 |
|---|---|---|
| SOOP Chat Message | 聊天 | Exit → 執行 · UserNickname → 暱稱 · UserId → 使用者ID · Message → 訊息 |
| SOOP Star Balloon Gift | 打賞 | Exit → 執行 · UserNickname → 暱稱 · UserId → 使用者ID · Count → 金額(星氣球數量) |
| SOOP Subscription Streak | 訂閱 | Exit → 執行 · UserNickname → 暱稱 · UserId → 使用者ID · SubscriptionMonths → 月數 |
| SOOP Subscription | 訂閱 | Exit → 執行 · UserNickname → 暱稱 · UserId → 使用者ID |
星氣球以數量計算
SOOP 星氣球的 Count 是星氣球數量,而非韓元金額。規則的金額條件也以數量填寫。(例:10 顆星氣球 → 基準金額 10)
Twitch(Warudo 基本功能)
| 接收節點 | MARS 事件類型 | 接收節點輸出 → MARS 事件輸入 |
|---|---|---|
| On Twitch Channel Message Received | 聊天 | Exit → 執行 · UserDisplayName → 暱稱 · Username → 使用者ID · Message → 訊息 |
| On Twitch Bits Received | 打賞 | Exit → 執行 · UserDisplayName → 暱稱 · Username → 使用者ID · BitsUsed → 金額 · Message → 訊息 |
| On Twitch Subscription Received | 訂閱 | Exit → 執行 · UserDisplayName → 暱稱 · Username → 使用者ID · CumulativeMonths → 月數 · Message → 訊息 |
| On Twitch Channel Points Received | 頻道點數 | Exit → 執行 · UserDisplayName → 暱稱 · Username → 使用者ID · RewardCost → 點數 · UserInput → 觀眾留言 · RewardTitle → 獎勵名稱 |
| On Twitch Channel Follow Received | 追蹤 | Exit → 執行 · UserDisplayName → 暱稱 · Username → 使用者ID |
| On Twitch Raid Received | 突襲 | Exit → 執行 · RaiderDisplayName → 暱稱 · RaiderUsername → 使用者ID · RaiderViewerCount → 觀眾數 |
Twitch 節點說明也可在 Warudo 節點參考查閱。
若連接埠名稱顯示不同
表格中的英文名稱是外掛內部使用的連接埠名稱。依 Warudo 語言或外掛版本,節點上可能顯示為當地語言名稱。上到下的順序相同。
不播出時確認
即使沒有實際聊天也可以確認。
- CHZZK:可使用 CHZZK Receive Tester 節點的測試按鈕發送模擬聊天・打賞。在內容中輸入
!Throw並按下試試。 - 通用:將On Key Pressed 節點連接至 MARS 事件輸入的執行,將事件輸入的事件類型設為聊天,訊息直接填入
!Throw,然後按下該按鍵。
MARS 事件輸入的成功表示「已接收請求」(並非反應已結束)。若從拒絕輸出,請查看節點的最近錯誤及中樞 MARS 執行狀態的最近通知。
確認是否完成
- 透過直播聊天(或測試)發送
!Throw後,貓咪飛來。 !throw(小寫)或!Throw!不會執行。因為規則設定為完全相符。- 中樞 MARS 執行狀態中的執行中・佇列數字變化後恢復為 0。