Streamer.bot
隨附於 Macro Deck執行 Streamer.bot 動作、傳送聊天訊息，並對 Streamer.bot 回報的每個事件做出反應。
「連線 Streamer.bot」對話方塊，含位址、連接埠、端點和密碼
- 執行任何 Streamer.bot 動作，可帶入引數
- 觸發自訂程式碼觸發器
- 傳送聊天訊息到 Twitch、YouTube、Trovo 或 Kick
- 對 Streamer.bot 回報的任何事件做出反應
- 將 Streamer.bot 全域變數讀入 Macro Deck
Streamer.bot 整合會將 Macro Deck 連線到 Streamer.bot 的 WebSocket 伺服器。按鈕可以啟動在 Streamer.bot 中建立的動作，而 Streamer.bot 回報的所有內容（聊天訊息、追蹤、訂閱、突襲、頻道點數兌換、計時器和自訂程式碼事件）都能在 Macro Deck 中啟動流程。
可以做什麼
- 執行 Streamer.bot 動作。從動作清單中選擇，並可傳入選用的引數，動作會以
%key%讀取。 - 觸發自訂程式碼觸發器，同樣可帶入選用的引數。
- 透過 Streamer.bot 以主播帳戶或機器人帳戶傳送聊天訊息到 Twitch、YouTube、Trovo 或 Kick。訊息中可以包含 Macro Deck 變數和事件值。
- 將 Streamer.bot 全域變數（已保存或僅限目前工作階段）讀入 Macro Deck 變數。
- 使用 Streamer.bot 事件 觸發器對任何 Streamer.bot 事件做出反應。選擇來源（例如 Twitch）和事件來縮小範圍，或兩者都留空以對所有事件做出反應。流程會收到使用者、訊息和以 JSON 格式提供的原始事件資料。
設定範例：
- 場景：遊戲 按鈕執行 Streamer.bot 動作，並將場景名稱作為引數傳入。
- 補充水分 按鈕包含兩個 傳送聊天訊息 動作，在 Twitch 和 YouTube 上張貼相同的提醒。
- 一個流程在 Streamer.bot 收到 Twitch 追蹤事件時執行，並在 Macro Deck 中顯示通知。
- 一個按鈕從 Streamer.bot 全域變數讀取計數器，並顯示為按鈕標籤。
運作方式
Macro Deck 會與 Streamer.bot 保持連線，並即時接收事件。變數會顯示連線狀態、Streamer.bot 版本、執行個體名稱，以及主播的名稱和平台。當 Streamer.bot 關閉或其 WebSocket 伺服器停止時，Macro Deck 會持續嘗試重新連線，而 已連線 和 已中斷連線 觸發器可讓流程做出反應。此整合只有一個設定。
需要準備
- 在 Windows、macOS 或 Linux 上執行的 Macro Deck 3
- 在這台電腦或網路中另一台電腦上執行的 Streamer.bot
- 已在 Streamer.bot 的 Servers/Clients > WebSocket Server 下啟動 WebSocket 伺服器
開始設定
步驟 1: 在 Streamer.bot 中啟動 WebSocket 伺服器
在 Streamer.bot 中開啟 Servers/Clients > WebSocket Server，並確認伺服器已啟動。記下位址、連接埠和端點；如果啟用了驗證，也請記下密碼。
步驟 2: 在 Macro Deck 中開啟 Streamer.bot
在 Macro Deck 的側邊欄中按一下 整合，然後按一下 Streamer.bot。在 概覽 分頁的 設定 區段中按一下 設定。開啟右上角的開關也會開啟相同的對話方塊，設定完成後此整合就會啟用。
步驟 3: 輸入連線詳細資料
填寫 連線 Streamer.bot 對話方塊：
- 位址：Streamer.bot 在同一台電腦上執行時為
127.0.0.1，否則為其 IP 位址。 - 連接埠：WebSocket 伺服器的連接埠，預設為
8080。 - 端點：伺服器監聽的路徑，預設為
/。 - 密碼：僅在 Streamer.bot 中啟用驗證時需要。
按一下 繼續。Macro Deck 會在儲存前測試連線。
- 位址：Streamer.bot 在同一台電腦上執行時為
步驟 4: 在按鈕上加入 Streamer.bot 動作
在 面板 頁面上按一下要使用的按鈕。面板必須處於解鎖狀態：右上角的按鈕顯示 鎖定 時，即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作，在 新增動作 對話方塊左側選擇 Streamer.bot，然後選擇 執行動作。在 動作 下選擇 Streamer.bot 動作，如有需要請加入 引數。然後按一下 儲存。
步驟 5: 按下按鈕
在手機、平板或網頁用戶端上按下按鈕，Streamer.bot 就會執行該動作。如果沒有反應，請確認 Streamer.bot 中的 WebSocket 伺服器已啟動，且 整合 下的 Streamer.bot 頁面中，該設定顯示為 已連線。
動作4
可放在按鈕上，或從流程中執行。
- 執行動作
- 執行 Streamer.bot 動作，可帶入選用的引數。
- 執行程式碼觸發器
- 觸發 Streamer.bot 自訂程式碼觸發器，可帶入選用的引數。
- 傳送聊天訊息
- 透過 Streamer.bot 傳送聊天訊息到 Twitch、YouTube、Trovo 或 Kick。
- 取得全域變數
- 將 Streamer.bot 全域變數讀入 Macro Deck 變數。
觸發器3
按鈕或流程可以對這些事件做出反應。
- Streamer.bot 事件
- Streamer.bot 回報的任何內容，例如聊天訊息、追蹤、訂閱、突襲、兌換、計時器和自訂程式碼事件。可依來源和事件縮小範圍。
- 已連線
- Macro Deck 已連線到 Streamer.bot。
- 已中斷連線
- 與 Streamer.bot 的連線已中斷。
變數5
在按鈕和小工具上顯示這些值，或在條件中使用。
streamerbot_is_connected- Macro Deck 是否已連線到 Streamer.bot。
streamerbot_version- Streamer.bot 的版本。
streamerbot_instance_name- Streamer.bot 執行個體的名稱。
streamerbot_broadcaster_name- Streamer.bot 中的主播帳戶。
streamerbot_broadcaster_platform- 主播帳戶所在的平台。
常見問題
Streamer.bot 在另一台電腦上執行時也能運作嗎？
可以。在 位址 中輸入該電腦的 IP 位址。在 Streamer.bot 中，WebSocket 伺服器必須監聽另一台電腦能連到的位址，且該連接埠必須在其防火牆中開放。
需要密碼嗎？
只有在 Streamer.bot 中為 WebSocket 伺服器啟用驗證時才需要。Macro Deck 會將密碼加密儲存在執行 Macro Deck 的電腦上。
如何將值傳給 Streamer.bot 動作？
在 執行動作 或 執行程式碼觸發器 的 引數 下加入。每個鍵在 Streamer.bot 中都能以 %key% 使用。
Streamer.bot 關閉後會怎麼樣？
Macro Deck 會持續嘗試重新連線，並在 WebSocket 伺服器恢復後再次連線。在此之前，動作會失敗並顯示 Streamer.bot 未連線。
為什麼取得全域變數顯示變數不存在？
請檢查名稱，以及該變數是否已在 Streamer.bot 中保存。若要讀取僅存在於目前工作階段的變數，請在動作中關閉 已保存。
更多「直播」整合
OBS Studio
隨附於 Macro Deck切換場景，控制串流、錄製和音訊，並對 OBS Studio 中發生的事情做出反應。
Meld Studio
隨附於 Macro Deck在 Meld Studio 中切換和預備場景、控制圖層、效果和音軌，並開始直播。
Streamlabs Desktop
隨附於 Macro Deck在 Streamlabs Desktop 中切換場景，控制串流、錄製和音訊來源。
Twitch
隨附於 Macro Deck顯示 Twitch 聊天室和直播統計資料、管理聊天室、進行投票和播放廣告，並對追蹤、訂閱和突襲做出反應。
YouTube
隨附於 Macro Deck顯示 YouTube 直播聊天室和直播統計資料，變更標題和標籤，並對 Super Chat 和會員做出反應。