跳至主要内容

3. 連接平台 API 節點

此步驟要做的事:將直播平台的聊天・打賞接收節點連接至 MARS 事件輸入節點,使實際聊天 !Throw 能觸發反應。

準備事項​

  • 完成第 2 步的場景(規則 Throw 已啟用)
  • 所用平台的整合外掛並已登入
    • CHZZK:工作坊 CHZZK 外掛
    • SOOP:工作坊 SOOP 外掛
    • Twitch:Warudo 基本功能(在 Settings → Twitch 中連接)

操作步驟​

  1. 在藍圖頁籤點擊 + 建立新藍圖,命名為 平台 → MARS。 與反應藍圖分開管理較為方便。
  2. 放置平台接收節點。例如 CHZZK 的話放置 CHZZK Chat Receiver。
  3. 從 Moraecat 分類中放置 MARS 事件輸入節點。
  4. 選擇 MARS 事件輸入的事件類型。連接聊天節點選聊天,打賞節點選打賞。 變更事件類型後,下方欄位名稱會依該類型更新。(例:打賞 → 金額・訊息・打賞種類,訂閱 → 月數・訊息・等級)
  5. 依照下方對照表連接線路。流程輸出(→ 形狀)連至執行,資料連至相對應的欄位。空白欄位可留空。
  6. 儲存場景。
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。

下一步:4. 將自己的反應製作為 MARS 相容格式