Streamlabs Desktop
隨附於 Macro Deck在 Streamlabs Desktop 中切換場景，控制串流、錄製和音訊來源。
「連線 Streamlabs Desktop」對話方塊，含「API 權杖」欄位
- 切換場景，並在工作室模式中進行轉場
- 開始和停止串流、錄製和重播緩衝區
- 將音訊來源靜音並設定音量
- 在場景中顯示、隱藏、翻轉、旋轉或調整來源大小
- 串流和錄製狀態與時間的即時變數
Streamlabs Desktop 整合會透過遠端控制 API 將 Macro Deck 連線到 Streamlabs Desktop（前身為 Streamlabs OBS）。使用 Streamlabs Desktop 顯示的 API 權杖連線後，按鈕就能控制場景、來源、音訊和輸出。
可以做什麼
- 切換使用中的場景、開啟或關閉工作室模式，並將工作室模式的預覽轉場到直播輸出。
- 開始、停止或切換串流、錄製和重播緩衝區，以及儲存重播。
- 在場景中顯示、隱藏或切換來源。
- 將音訊來源靜音、取消靜音或切換靜音，設定其音量，或依級距提高和降低音量。
- 對來源執行變形：重設變形、水平或垂直翻轉、在畫面上符合大小、延展或置中，或旋轉來源。
- 將音訊來源的音量或靜音狀態，或來源的可見性讀入變數。
設定範例：
- BRB 按鈕會切換到 BRB 場景，並將麥克風靜音。
- 剪輯 按鈕會儲存重播緩衝區。
- 開始直播 按鈕會切換串流，並顯示是否正在直播。
- 一個在 串流已開始 時執行的流程，會顯示網路攝影機來源。
運作方式
Macro Deck 會監聽 Streamlabs Desktop 傳送的事件，因此場景、串流、錄製、重播緩衝區和工作室模式變數會跟隨在 Streamlabs Desktop 中的操作。場景變更、串流或錄製開始、停止或狀態變更、重播緩衝區開始或停止、工作室模式變更，以及來源被靜音、顯示或隱藏時，都會觸發觸發器。
此整合只有一個設定。預設會連線到同一台電腦上的 Streamlabs Desktop。可以在設定時於 進階設定 下輸入另一台電腦的位址。Streamlabs Desktop 關閉時，Macro Deck 會持續嘗試重新連線。如果在 Streamlabs Desktop 中產生新的權杖，整合頁面會顯示 Streamlabs Desktop 拒絕了 API 權杖，此時請使用新的權杖重新執行設定。
需要準備
- 在 Windows、macOS 或 Linux 上執行的 Macro Deck 3
- 在這台電腦或網路中另一台電腦上執行的 Streamlabs Desktop
- 已在 Streamlabs Desktop 中開啟遠端控制，並取得其 API 權杖
開始設定
步驟 1: 在 Streamlabs Desktop 中找到 API 權杖
在 Streamlabs Desktop 中開啟 Settings，然後開啟 Remote Control。在較新的版本中，它位於 Mobile、Third Party Connections 下，必須在那裡開啟。按一下 QR 碼並選擇 show details 以顯示 API 權杖，然後複製。
步驟 2: 在 Macro Deck 中開啟 Streamlabs Desktop
在 Macro Deck 的側邊欄中按一下 整合，然後按一下 Streamlabs Desktop。在 概覽 分頁的 設定 區段中按一下 設定。開啟右上角的開關也會開啟相同的對話方塊，設定完成後此整合就會啟用。
步驟 3: 貼上 API 權杖
在 連線 Streamlabs Desktop 對話方塊中，將權杖貼到 API 權杖。
如果 Streamlabs Desktop 在另一台電腦上執行，請開啟 進階設定，並在 位址 中輸入其 IP 位址。除非確定連接埠不是
59650，否則請將 連接埠 留空。按一下 繼續。Macro Deck 會在儲存前測試連線。步驟 4: 在按鈕上加入 Streamlabs Desktop 動作
在 面板 頁面上按一下要使用的按鈕。面板必須處於解鎖狀態：右上角的按鈕顯示 鎖定 時，即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作，在 新增動作 對話方塊左側選擇 Streamlabs Desktop，然後選擇一個動作，例如 設定場景。選擇 場景，然後按一下 儲存。
步驟 5: 按下按鈕
在手機、平板或網頁用戶端上按下按鈕，Streamlabs Desktop 就會切換到該場景。如果沒有反應，請確認 Streamlabs Desktop 正在執行，且 整合 下的 Streamlabs Desktop 頁面中，該設定顯示為 已連線。
動作19
可放在按鈕上，或從流程中執行。
- 設定場景
- 切換使用中的場景。
- 開始串流
- 如果尚未直播，就開始串流。
- 停止串流
- 如果正在直播，就停止串流。
- 切換串流
- 開始或停止串流。
- 開始錄製
- 如果尚未錄製，就開始錄製。
- 停止錄製
- 停止目前的錄製。
- 切換錄製
- 開始或停止錄製。
- 啟動重播緩衝區
- 啟動重播緩衝區。
- 停止重播緩衝區
- 停止重播緩衝區。
- 切換重播緩衝區
- 啟動或停止重播緩衝區。
- 儲存重播
- 將目前的重播緩衝區寫入磁碟。
- 設定來源可見性
- 在場景中顯示、隱藏或切換來源。
- 取得來源可見性
- 將來源是否可見讀入變數。
- 將音訊來源靜音
- 將音訊來源靜音、取消靜音或切換靜音。
- 設定音訊音量
- 設定、提高或降低音訊來源的音量。
- 取得音訊來源狀態
- 將音訊來源的音量或靜音狀態讀入變數。
- 場景項目動作
- 在場景中重設、翻轉、符合大小、延展、置中或旋轉來源。
- 切換工作室模式
- 開啟或關閉工作室模式。
- 工作室模式切換
- 將工作室模式的預覽轉場到直播輸出。
觸發器14
按鈕或流程可以對這些事件做出反應。
- 場景已變更
- 使用中的場景已變更。可限定於單一場景。
- 串流已開始
- Streamlabs Desktop 已開始串流。
- 串流已停止
- Streamlabs Desktop 已停止串流。
- 串流狀態已變更
- 串流在離線、啟動中、直播中、結束中和重新連線中之間變更。
- 錄製已開始
- Streamlabs Desktop 已開始錄製。
- 錄製已停止
- Streamlabs Desktop 已停止錄製。
- 錄製狀態已變更
- 錄製在離線、啟動中、錄製中和停止中之間變更。
- 重播緩衝區已啟動
- 重播緩衝區已啟動。
- 重播緩衝區已停止
- 重播緩衝區已停止。
- 工作室模式已變更
- 工作室模式已開啟或關閉。
- 來源靜音狀態已變更
- 音訊來源已靜音或取消靜音。
- 來源可見性已變更
- 場景中的來源已顯示或隱藏。
- 已連線
- Macro Deck 已連線到 Streamlabs Desktop。
- 已中斷連線
- 與 Streamlabs Desktop 的連線已中斷。
變數7
在按鈕和小工具上顯示這些值，或在條件中使用。
streamlabs_is_connected- Macro Deck 是否已連線到 Streamlabs Desktop。
streamlabs_current_scene- 使用中的場景。
streamlabs_scene_count- 場景的數量。
streamlabs_is_streaming,streamlabs_streaming_status,streamlabs_streaming_seconds- 是否正在直播、串流狀態，以及串流已進行多久。
streamlabs_is_recording,streamlabs_recording_status,streamlabs_recording_seconds- 是否正在錄製、錄製狀態，以及錄製已進行多久。
streamlabs_replay_buffer_active,streamlabs_replay_buffer_status- 重播緩衝區是否正在執行及其狀態。
streamlabs_studio_mode_active- 工作室模式是否已開啟。
常見問題
Streamlabs Desktop 在另一台電腦上執行時也能運作嗎？
可以。設定時請開啟 進階設定，並在 位址 中輸入該電腦的 IP 位址。連接埠 59650 必須能通過其防火牆連線。
Streamlabs Desktop 拒絕了 API 權杖，該怎麼辦？
權杖已在 Streamlabs Desktop 中重新產生，或遠端控制已關閉。請開啟遠端控制，顯示目前的權杖，並使用它重新執行設定。
Streamlabs Desktop 關閉後會怎麼樣？
Macro Deck 會持續嘗試重新連線，並在 Streamlabs Desktop 執行後再次連線。在此之前，動作會失敗並顯示 Streamlabs Desktop 未連線。
音量是以分貝為單位嗎？
不是。設定音訊音量 使用的是 Streamlabs Desktop 顯示的推桿位置（百分比），而不是分貝值。
API 權杖儲存在哪裡？
Macro Deck 會將權杖加密儲存在執行 Macro Deck 的電腦上，只用於連線到 Streamlabs Desktop。
更多「直播」整合
OBS Studio
隨附於 Macro Deck切換場景，控制串流、錄製和音訊，並對 OBS Studio 中發生的事情做出反應。
Meld Studio
隨附於 Macro Deck在 Meld Studio 中切換和預備場景、控制圖層、效果和音軌，並開始直播。
Streamer.bot
隨附於 Macro Deck執行 Streamer.bot 動作、傳送聊天訊息，並對 Streamer.bot 回報的每個事件做出反應。
Twitch
隨附於 Macro Deck顯示 Twitch 聊天室和直播統計資料、管理聊天室、進行投票和播放廣告，並對追蹤、訂閱和突襲做出反應。
YouTube
隨附於 Macro Deck顯示 YouTube 直播聊天室和直播統計資料，變更標題和標籤，並對 Super Chat 和會員做出反應。