YouTube
隨附於 Macro Deck顯示 YouTube 直播聊天室和直播統計資料,變更標題和標籤,並對 Super Chat 和會員做出反應。
一個 YouTube 聊天室小工具和 YouTube 直播統計小工具
- YouTube 聊天室和 YouTube 直播統計小工具
- 設定直播標題、說明和標籤
- 開始直播、結束直播和開始廣告插播
- Super Chat、Super Sticker 和會員資格觸發器
- 使用自己的 Google Cloud 專案和配額
YouTube 整合會將 YouTube 頻道連線到 Macro Deck。它會以變數顯示直播的狀態,在收到 Super Chat、Super Sticker 和會員資格時觸發觸發器,在小工具中顯示直播聊天室並可進行管理,還能從按鈕變更直播內容。
YouTube 沒有提供 Macro Deck 可供所有人共用的登入方式。連線需要透過自己的 Google Cloud 專案,只需設定一次,約十分鐘。專案免費,其配額和權限完全屬於自己。
可以做什麼
- 傳送聊天訊息到目前直播的直播聊天室。
- 變更正在直播的節目的標題、說明或標籤;未直播時則變更下一個已排定的直播。
- 使用 開始直播 開始下一個已排定的直播,使用 結束直播 結束直播,以及要求 YouTube 插播廣告。
- 在 YouTube 聊天室 小工具中顯示直播聊天室,並從中刪除訊息、暫時禁言或封鎖聊天者。
- 在 YouTube 直播統計 小工具中顯示是否正在直播、觀看人數、讚數、訂閱人數、標題和已直播時間。
設定範例:
- 準備開播 按鈕會設定下一個直播的標題和標籤。
- 廣告插播 按鈕會要求 YouTube 插播 60 秒的廣告。
- 一個在 Super Chat 時執行的流程,會顯示含作者和金額的通知。
- 一個在 新會員 時執行的流程,會在聊天室中張貼感謝訊息。
運作方式
直播期間,Macro Deck 大約每分鐘讀取一次直播狀態,每隔幾秒讀取一次聊天室。每次讀取和變更都會消耗 Google Cloud 專案的配額,每天有 10,000 個單位。Macro Deck 會持續計數。配額快用完時,會暫停聊天室更新,並降低讀取直播狀態的頻率。配額用完時,會暫停直播狀態和聊天室的更新,直到太平洋時間午夜 Google 重設配額為止。
聊天訊息、Super Chat 和會員資格事件只會在直播期間傳來。Macro Deck 未執行期間發生的事件之後不會補發。可以連線多個頻道:每個動作都有 頻道 欄位,每個觸發器都可以限定於單一頻道。
需要準備
- 在 Windows、macOS 或 Linux 上執行且可連上網際網路的 Macro Deck 3
- 可以進行直播的 YouTube 頻道
- 已啟用 YouTube Data API v3 的 Google Cloud 專案
- 類型為 TVs and Limited Input devices 的 OAuth 用戶端 ID,以及其用戶端密碼
- 開始廣告插播需要正在直播,且頻道可以顯示片中廣告
開始設定
步驟 1: 建立 Google Cloud 專案
使用擁有頻道的 Google 帳戶開啟 Google Cloud console,並建立一個專案,例如 Macro Deck。在 APIs & Services > Library 下搜尋 YouTube Data API v3,然後按一下 Enable。
步驟 2: 設定同意畫面
開啟 APIs & Services > OAuth consent screen(在較新的主控台中為 Google Auth Platform)。選擇 External,輸入應用程式名稱和電子郵件地址,然後儲存。在 Audience(或 Test users)下,將擁有頻道的 Google 帳戶新增為測試使用者。
步驟 3: 建立 OAuth 用戶端 ID
開啟 APIs & Services > Credentials,按一下 Create credentials > OAuth client ID,並選擇應用程式類型 TVs and Limited Input devices。其他類型在登入時都會被拒絕。複製 Google 顯示的 Client ID 和 Client secret。
步驟 4: 在 Macro Deck 中輸入用戶端
在 Macro Deck 的側邊欄中按一下 整合,然後按一下 YouTube。在 概覽 分頁的 設定 區段中按一下 新增設定。開啟右上角的開關也會開啟相同的對話方塊,設定完成後此整合就會啟用。在 連線 YouTube 頻道 對話方塊中貼上 用戶端 ID 和 用戶端密碼。只有在 Google 為專案核准了更多配額時,才需要開啟 進階設定,並在 每日配額(單位) 中輸入。按一下 繼續。
步驟 5: 在 Google 上核准存取
對話方塊接著會顯示 在 Google 上核准存取 和 裝置代碼。按一下 開啟 Google 並核准,使用擁有頻道的帳戶登入,輸入代碼,選擇頻道並允許存取。Google 會警告應用程式未經驗證:這是自己的專案,因此請繼續。回到 Macro Deck 並按一下 繼續。設定會以頻道命名,例如 YouTube (My Channel)。對話方塊顯示 設定完成。 時,按一下 完成。
步驟 6: 在按鈕上加入 YouTube 動作
在 面板 頁面上按一下要使用的按鈕。面板必須處於解鎖狀態:右上角的按鈕顯示 鎖定 時,即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作,在 新增動作 對話方塊左側選擇 YouTube,然後選擇一個動作,例如 設定直播標題。選擇 頻道,輸入 標題,然後按一下 儲存。
動作7
可放在按鈕上,或從流程中執行。
- 傳送聊天訊息
- 在目前直播的直播聊天室中張貼最多 200 個字元的訊息。
- 設定直播標題
- 變更目前直播的標題;未直播時則變更下一個已排定的直播。
- 設定直播說明
- 變更目前直播或下一個已排定直播的說明。
- 設定直播標籤
- 取代目前直播或下一個已排定直播的標籤。
- 開始廣告插播
- 要求 YouTube 在直播期間插播 30 秒到 3 分鐘的廣告。
- 開始直播
- 開始下一個已就緒的已排定直播。請先啟動直播軟體。
- 結束直播
- 結束目前的直播。
觸發器8
按鈕或流程可以對這些事件做出反應。
- 直播開始
- 頻道已開始直播。
- 直播結束
- 頻道的直播已結束。
- Super Chat
- 有人傳送了 Super Chat,附作者、金額、幣別和留言。
- Super Sticker
- 有人傳送了 Super Sticker。
- 新會員
- 有人成為頻道會員或升級了會員資格。
- 會員里程碑
- 會員在聊天室中分享了會員資格里程碑。
- 贈送會員資格
- 有人將會員資格贈送給其他觀眾。
- YouTube 事件(進階)
- 將此清單中的所有 YouTube 事件集中在一個觸發器中,可依類型篩選。
變數8
在按鈕和小工具上顯示這些值,或在條件中使用。
youtube_<channel>_display_name- 頻道的名稱。
youtube_<channel>_is_live- 頻道是否正在直播。
youtube_<channel>_stream_title- 直播的標題。
youtube_<channel>_viewer_count- 目前的觀看人數。隱藏觀看人數時為空白。
youtube_<channel>_like_count- 直播的讚數。
youtube_<channel>_subscriber_count- 經 YouTube 取概數後的頻道訂閱人數。
youtube_<channel>_uptime_seconds- 直播已進行的秒數。
youtube_<channel>_stream_thumbnail_url- 直播的縮圖。
小工具2
從小工具選擇器將這些小工具加入面板。
- YouTube 聊天室
- 顯示目前直播的直播聊天室,包括 Super Chat 和新會員。按下即可在較大的對話方塊中進行管理。
- YouTube 直播統計
- 以所選的樣式顯示直播狀態、觀看人數、讚數、訂閱人數、標題和已直播時間。
常見問題
為什麼需要自己的 Google Cloud 專案?
YouTube 沒有提供 Macro Deck 可供所有人共用的登入方式。使用自己的專案,配額和權限就完全屬於自己。專案免費。
為什麼每週都必須重新登入?
專案的同意畫面處於測試階段時,Google 會在 7 天後結束登入。此時 整合 會顯示登入已過期;請使用相同的用戶端 ID 和用戶端密碼重新連線。若要保持登入,請在 Google Cloud console 中發布同意畫面。
配額用完後會怎麼樣?
Macro Deck 會暫停直播狀態和聊天室的更新,整合 下的 YouTube 頁面會顯示 YouTube 配額已用完。Google 會在太平洋時間午夜重設配額,屆時就會恢復更新。在 Google 拒絕之前,動作會繼續運作。
為什麼開始直播沒有開始我的直播?
開始直播 會開始下一個串流已傳送到 YouTube 的已排定直播,因此請先啟動直播軟體。會自動開始的直播,以及 YouTube Studio 中的 Stream now,是由 YouTube 開始的,而不是由此動作開始。
可以從聊天室小工具解除封鎖某人嗎?
只能解除在目前直播期間透過 Macro Deck 進行的封鎖,且僅限 Macro Deck 重新啟動之前。YouTube 不會告知 Macro Deck 有哪些封鎖,因此其他封鎖請在 YouTube Studio 中解除。
憑證儲存在哪裡?
用戶端密碼和權杖會加密儲存在執行 Macro Deck 的電腦上,只會傳送給 Google。
更多「直播」整合
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 回報的每個事件做出反應。
Twitch
隨附於 Macro Deck顯示 Twitch 聊天室和直播統計資料、管理聊天室、進行投票和播放廣告,並對追蹤、訂閱和突襲做出反應。