Twitch
隨附於 Macro Deck顯示 Twitch 聊天室和直播統計資料、管理聊天室、進行投票和播放廣告,並對追蹤、訂閱和突襲做出反應。
一個 Twitch 聊天室小工具和顯示觀眾、聊天者與追隨者人數的 Twitch 直播統計小工具
- Twitch 聊天室和 Twitch 直播統計小工具
- 設定標題和分類、播放廣告、發起突襲和建立精華片段
- 從按鈕進行投票、預測、推薦和切換聊天模式
- 追蹤、訂閱、Cheer、突襲和兌換觸發器
- 連線多個 Twitch 帳戶
Twitch 整合會將一個或多個 Twitch 帳戶連線到 Macro Deck。使用簡短的代碼在 Twitch 上登入後,Macro Deck 就會即時接收頻道的事件,並能以該帳戶的身分在頻道上執行操作。
可以做什麼
- 變更直播標題、分類和標籤,傳送聊天訊息和公告,以及發送推薦。
- 播放廣告插播、延後下一則廣告、開始或取消突襲、建立精華片段或直播標記。
- 開始和結束投票與預測,並將頻道點數兌換標示為已完成或已退還。
- 管理聊天室:停權或禁言使用者、解除停權、刪除訊息、清空聊天室,以及開啟或關閉僅限表情符號、僅限追蹤者、慢速、僅限訂閱者或獨特訊息模式。
- 在 Twitch 聊天室 小工具中顯示含表情符號和徽章的聊天室,並從中進行管理。
- 在 Twitch 直播統計 小工具中顯示直播狀態、觀眾數、聊天者、追蹤者和訂閱者、標題、分類和已直播時間。
設定範例:
- 即將開始 按鈕會設定標題和分類,並傳送公告。
- 廣告插播 按鈕會播放 90 秒的廣告。
- 精華片段 按鈕會建立精華片段,並將其編輯網址寫入變數。
- 一個針對特定獎勵在 頻道點數獎勵已兌換 時執行的流程,會切換 OBS 場景。
- 一個在 收到突襲 時執行的流程,會向突襲者發送推薦。
運作方式
Macro Deck 會為每個已連線的帳戶訂閱 Twitch 事件,因此 新追蹤者、Cheer 或 收到突襲 等觸發器會在片刻內觸發。觀眾數等直播數值每 30 秒會從 Twitch 讀取一次。所有數值都可作為以 twitch_<account>_<value> 命名的變數使用,例如 twitch_mychannel_viewer_count,因此可以在自己的小工具和條件中使用。
可以連線多個 Twitch 帳戶。每個動作都有 帳戶 欄位,每個觸發器都可以限定於單一帳戶。如果 Twitch 沒有授予 Macro Deck 要求的所有權限,整合 會列出不會觸發的事件,並提供重新連線的選項。與 Twitch 的連線中斷時,Macro Deck 會自動重新連線。如果帳戶 30 天未使用 Macro Deck,或在 Twitch 上撤銷了其存取權,登入就會過期,整合 會要求重新連線帳戶。
需要準備
- 在 Windows、macOS 或 Linux 上執行且可連上網際網路的 Macro Deck 3
- Twitch 帳戶
- 播放廣告需要正在直播的聯盟或合作夥伴頻道
- 精華片段和直播標記只在頻道直播期間有效
開始設定
步驟 1: 在 Macro Deck 中開啟 Twitch
在 Macro Deck 的側邊欄中按一下 整合,然後按一下 Twitch。在 概覽 分頁的 設定 區段中按一下 新增設定。開啟右上角的開關也會開啟相同的對話方塊,設定完成後此整合就會啟用。
步驟 2: 在 Twitch 上核准存取
連線 Twitch 帳戶 對話方塊會顯示 裝置代碼。按一下 開啟 Twitch 並核准:Twitch 會在瀏覽器中開啟,並已填入代碼。使用要連線的帳戶登入並核准存取。
若要使用自行註冊的 Twitch 應用程式,請開啟 進階設定,並在 自有 Client ID(進階) 中輸入其 Client ID。將此欄位留空即可使用 Macro Deck 的應用程式。
步驟 3: 完成設定
回到 Macro Deck 並按一下 繼續。Macro Deck 會以帳戶名稱為設定命名,例如 Twitch (mychannel)。對話方塊顯示 設定完成。 時,按一下 完成。
步驟 4: 在按鈕上加入 Twitch 動作
在 面板 頁面上按一下要使用的按鈕。面板必須處於解鎖狀態:右上角的按鈕顯示 鎖定 時,即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作,在 新增動作 對話方塊左側選擇 Twitch,然後選擇一個動作,例如 發送聊天訊息。選擇 帳戶,輸入 訊息,然後按一下 儲存。
步驟 5: 按下按鈕
在手機、平板或網頁用戶端上按下按鈕。訊息會出現在 Twitch 聊天室中。若要在面板上查看聊天室,請新增 Twitch 聊天室 小工具。
動作20
可放在按鈕上,或從流程中執行。
- 設定標題與分類
- 變更直播標題、分類或標籤。留空的欄位不會變更。
- 發送聊天訊息
- 以已連線帳戶的身分傳送訊息到頻道的聊天室,也可以作為回覆傳送。
- 發送公告
- 以所選的顏色在聊天室中張貼醒目的公告。
- 發送推薦
- 向另一個頻道發送推薦。Twitch 每兩分鐘允許一次。
- 清空聊天室
- 移除頻道聊天室中的所有訊息。
- 刪除聊天訊息
- 從聊天室中移除單一訊息。
- 設定聊天模式
- 開啟、關閉或切換僅限表情符號、僅限追蹤者、慢速、僅限訂閱者或獨特訊息模式。
- 播放廣告
- 開始 30 秒到 3 分鐘的廣告插播。
- 延後下一則廣告
- 將下一則已排定的廣告插播延後五分鐘。
- 開始突襲
- 將頻道的觀眾帶到另一個頻道。
- 取消突襲
- 停止尚未完成的突襲。
- 建立精華片段
- 剪輯直播的最後 30 秒,並可將精華片段的編輯網址寫入變數。
- 建立直播標記
- 標記直播中目前的位置,以便日後編輯。
- 停權或禁言使用者
- 將觀眾停權;如果指定了時長,則改為禁言。
- 解除停權使用者
- 解除停權或禁言。
- 建立投票
- 開始一個有二到五個選項的投票。
- 結束投票
- 結束目前進行中的投票。
- 建立預測
- 開始一個有二到十個結果的頻道點數預測。
- 結束預測
- 結算、鎖定或取消目前進行中的預測。
- 處理獎勵兌換
- 將頻道點數兌換標示為已完成或退還(僅限由同一個 Twitch 應用程式建立的獎勵)。
觸發器39
按鈕或流程可以對這些事件做出反應。
- 直播已上線
- 頻道已開始直播。
- 直播已離線
- 頻道已停止直播。
- 頻道資訊已更新
- 標題、分類、語言或內容標籤已變更。
- 廣告插播已開始
- 頻道上已開始廣告插播。
- 新追蹤者
- 有人追蹤了頻道。
- 新訂閱
- 有人訂閱了頻道。可限定於單一層級。
- 續訂
- 有人在聊天室中宣布續訂。
- 贈送的訂閱
- 有人在頻道中贈送了訂閱。
- 訂閱已到期
- 頻道的某個訂閱已到期。
- Cheer
- 有人在頻道中贈送了 Bits。
- 收到突襲
- 另一個頻道突襲了這個頻道。
- 已發出突襲
- 這個頻道突襲了另一個頻道。
- 已收到推薦
- 另一個頻道向這個頻道發送了推薦。
- 已發送推薦
- 頻道發送了推薦。
- 頻道點數獎勵已兌換
- 觀眾兌換了頻道點數獎勵。可限定於單一獎勵。
- 已兌換自動獎勵
- 觀眾使用了 Twitch 內建的頻道點數獎勵。
- 兌換已處理
- 頻道點數兌換已被接受或退還。
- 投票已開始
- 頻道中已開始投票。
- 投票已結束
- 頻道中的投票已結束。
- 預測已開始
- 頻道中已開始預測。
- 預測已鎖定
- 預測已停止接受參與。
- 預測已結束
- 預測已結算或取消。
- 熱度列車已開始
- 頻道中已開始熱度列車。
- 熱度列車進度
- 頻道中的熱度列車有所進展。
- 熱度列車已結束
- 頻道中的熱度列車已結束。
- 目標已開始
- 創作者目標已開始。
- 目標進度
- 創作者目標有所進展。
- 目標已結束
- 創作者目標已結束。
- 聊天通知
- 聊天室中的訂閱、續訂、贈送、突襲、公告或慈善通知。可限定於單一種類。
- 聊天室已清空
- 頻道的聊天室已清空。
- 聊天訊息已刪除
- 已刪除單一聊天訊息。
- 聊天模式已變更
- 已切換僅限表情符號、僅限追蹤者、慢速、僅限訂閱者或獨特訊息模式。
- 使用者遭停權或禁言
- 觀眾遭到停權或禁言。
- 使用者已解除封鎖
- 觀眾已解除停權。
- 已新增 VIP
- 觀眾獲得了 VIP 身分。
- 已移除 VIP
- 觀眾失去了 VIP 身分。
- Twitch 事件(進階)
- 所有 Twitch 事件,包括 Macro Deck 尚未建立模型的事件,並附原始資料。
- 已連線
- Macro Deck 已將帳戶連線到 Twitch。
- 已中斷連線
- 與 Twitch 的連線已中斷。
變數10
在按鈕和小工具上顯示這些值,或在條件中使用。
twitch_<account>_is_connected- 帳戶是否已連線到 Twitch。
twitch_<account>_is_live- 頻道是否正在直播。
twitch_<account>_stream_title,twitch_<account>_stream_category- 目前的標題和分類。
twitch_<account>_viewer_count,twitch_<account>_uptime_seconds- 觀眾數,以及直播已進行的秒數。
twitch_<account>_follower_count,twitch_<account>_subscriber_count,twitch_<account>_subscriber_points- 頻道的追蹤者、訂閱者和訂閱者點數總數。
twitch_<account>_chatter_count- 聊天室中的所有人,包括你自己和機器人。
twitch_<account>_stream_thumbnail_url- 目前直播縮圖的網址。
twitch_<account>_display_name,twitch_<account>_login- 帳戶的顯示名稱和登入名稱。
twitch_<account>_emote_only,twitch_<account>_followers_only,twitch_<account>_followers_only_duration,twitch_<account>_slow_mode,twitch_<account>_slow_mode_wait_time,twitch_<account>_subscriber_only,twitch_<account>_unique_chat- 聊天模式:僅限表情符號、僅限追蹤者及其時長(分鐘)、慢速模式及其等待時間(秒)、僅限訂閱者和獨特訊息模式。
twitch_<account>_last_follower,twitch_<account>_last_subscriber,twitch_<account>_last_cheerer,twitch_<account>_last_raider- 最近的追蹤者、訂閱者、Bits 贊助者和突襲者。
小工具2
從小工具選擇器將這些小工具加入面板。
- Twitch 聊天室
- 顯示含表情符號和徽章的頻道聊天室。按下即可開啟較大的聊天室,在其中刪除訊息、禁言和停權。
- Twitch 直播統計
- 以所選的樣式顯示直播狀態、觀眾數、聊天者、追蹤者和訂閱者、標題、分類和已直播時間。
常見問題
可以連線多個 Twitch 帳戶嗎?
可以。再按一次 新增設定,然後使用另一個帳戶核准。每個動作都有 帳戶 欄位,而變數會包含帳戶名稱,例如 twitch_mychannel_is_live。
為什麼必須重新登入?
Twitch 會在 30 天未使用後,或在 Twitch 上撤銷 Macro Deck 的存取權時結束登入。此時 整合 會顯示登入已過期。使用 重新連線 再次核准存取。
為什麼動作失敗?
許多動作只在特定情況下有效:建立精華片段 和 建立直播標記 需要頻道正在直播,播放廣告 需要正在直播的聯盟或合作夥伴頻道,而 發送推薦 每兩分鐘只能使用一次。如果 Twitch 沒有授予某項權限,請重新連線帳戶以授予該權限。
為什麼無法處理現有獎勵的兌換?
Twitch 只允許應用程式處理由同一個應用程式建立的獎勵兌換。在 Twitch 儀表板中建立的獎勵無法透過 API 處理。
誰可以從聊天室小工具進行管理?
任何能使用面板的人都可以。若只要顯示聊天室,請在小工具的設定中關閉 允許在聊天室對話框中管理。
Twitch 權杖儲存在哪裡?
Macro Deck 會將存取權杖和重新整理權杖加密儲存在執行 Macro Deck 的電腦上。Twitch 密碼絕不會在 Macro Deck 中輸入:存取權是在 Twitch 本身上核准的。
更多「直播」整合
OBS Studio
隨附於 Macro Deck切換場景,控制串流、錄製和音訊,並對 OBS Studio 中發生的事情做出反應。
Meld Studio
隨附於 Macro Deck在 Meld Studio 中切換和預備場景、控制圖層、效果和音軌,並開始直播。
Streamlabs Desktop
隨附於 Macro Deck在 Streamlabs Desktop 中切換場景,控制串流、錄製和音訊來源。
Streamer.bot
隨附於 Macro Deck執行 Streamer.bot 動作、傳送聊天訊息,並對 Streamer.bot 回報的每個事件做出反應。
YouTube
隨附於 Macro Deck顯示 YouTube 直播聊天室和直播統計資料,變更標題和標籤,並對 Super Chat 和會員做出反應。