YouTube Music Desktop App
隨附於 Macro Deck從面板控制 YouTube Music Desktop App：播放、音量、評分和正在播放的內容。
兩個正在播放曲目的音樂播放器小工具，一個為「完整封面」樣式，一個為「小封面」樣式，標題列都有 YouTube Music Desktop App 的名稱和標誌
- 播放、暫停、跳過、跳轉、隨機播放、重複播放和音量
- 對目前曲目按喜歡、不喜歡或清除評分
- 從連結或 ID 開始播放影片或播放清單
- 透過應用程式的 Companion Server 即時更新
- 音樂播放器小工具，以及曲目、演出者和進度變數
YouTube Music Desktop App 整合會將 Macro Deck 連線到 YouTube Music 的桌面應用程式 YouTube Music Desktop App (YTMDesktop)。它使用應用程式的 Companion Server，此功能內建於 2.0.6 及更新版本。只需在應用程式中允許 Macro Deck 一次，之後只要應用程式執行，Macro Deck 就會自動連線。
可以做什麼
- 播放、暫停、跳過、跳轉、開啟或關閉隨機播放、設定重複模式，以及變更音量。
- 將應用程式靜音或取消靜音。
- 對目前曲目按喜歡或不喜歡、清除評分，或開關喜歡或不喜歡。
- 從目前的佇列或其中一個播放清單開始播放曲目，或在按下按鈕時選擇。
- 從 YouTube Music 連結、youtu.be 連結、影片 ID 或播放清單 ID 開始播放特定影片或播放清單。
- 在 音樂播放器 小工具中顯示正在播放的內容，包括封面、進度，以及播放和跳過按鈕。
- 在曲目被按喜歡、不喜歡或清除評分時，以流程做出反應。
設定範例：
- Toggle Play/Pause 按鈕，會顯示音樂正在播放還是已暫停。
- 使用 切換喜歡 模式 評價曲目 的喜歡按鈕，其標籤繫結到
ytmdesktop_like_status。 - 使用 播放影片或網址 的按鈕，從 YouTube Music 連結開始播放專注用的播放清單。
- 繫結到
ytmdesktop_volume的滑桿，會跟隨應用程式的音量，並在拖曳時變更音量。
運作方式
Macro Deck 會與 Companion Server 保持即時連線，因此在應用程式中所做的變更會立即顯示在面板上。應用程式關閉時，Macro Deck 會在 5 秒後重試，每次嘗試失敗後會延長等待時間，最長一分鐘。ytmdesktop_is_connected 變數會顯示是否能連到應用程式。如果在應用程式中移除了存取權，此整合頁面上的問題 YouTube Music 桌面版拒絕了授權 會要求重新執行設定。Macro Deck 預設會在同一台電腦上尋找應用程式。可以在設定時於 進階設定 下輸入另一台電腦的位址。可以設定一個 YouTube Music Desktop App。
需要準備
- YouTube Music Desktop App 2.0.6 或更新版本。第 1 版沒有 Companion Server。
- 已在應用程式的 Settings > Integrations 下開啟 Companion Server。
- 設定 Macro Deck 期間已開啟 Companion Authorization。
開始設定
步驟 1: 安裝 YouTube Music Desktop App
安裝 YouTube Music Desktop App 2.0.6 或更新版本並啟動。Macro Deck 中的設定對話方塊會連結到應用程式的版本發布頁面。
步驟 2: 開啟 Companion Server
在 YouTube Music Desktop App 中前往 Settings > Integrations。開啟 Companion Server 和 Companion Authorization。允許 Macro Deck 後，應用程式會自動再次關閉授權。
步驟 3: 在 Macro Deck 中開始設定
在 Macro Deck 的側邊欄中按一下 整合，然後按一下 YouTube Music Desktop App。在 概覽 分頁的 設定 區段中按一下 設定。開啟右上角的開關也會開啟相同的對話方塊，設定完成後此整合就會啟用。啟用配套伺服器 對話方塊沒有需要填寫的欄位。如果應用程式在另一台電腦上執行，請開啟 進階設定 並輸入其 位址。將 連接埠 保留為
9863。按一下 繼續。步驟 4: 在應用程式中允許 Macro Deck
對話方塊接著會顯示 允許 Macro Deck 和 授權碼。按一下 繼續：YouTube Music Desktop App 中會開啟一個核准視窗，顯示 Macro Deck 和一組代碼。確認兩組代碼相符，並在 30 秒內按一下 Allow。Macro Deck 中的對話方塊顯示 設定完成。 時，按一下 完成。
步驟 5: 在按鈕上加入動作
在 面板 頁面上按一下要使用的按鈕。面板必須處於解鎖狀態：右上角的按鈕顯示 鎖定 時，即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作，在 新增動作 對話方塊左側選擇 YouTube Music Desktop App，然後選擇一個動作，例如 Toggle Play/Pause 或 評價曲目。接著按一下 儲存。
步驟 6: 按下按鈕
在 YouTube Music Desktop App 中開始播放歌曲，然後在面板上按下按鈕。播放會暫停或繼續。
動作17
可放在按鈕上，或從流程中執行。
- Play
- 繼續播放。
- Pause
- 暫停播放。
- Toggle Play/Pause
- 在播放和暫停之間切換，並在按鈕上顯示播放狀態。
- Next Track
- 跳到下一首。
- Previous Track
- 跳到上一首。
- Refresh State
- 立即讀取目前的播放狀態。
- Set Volume
- 設定應用程式的音量，從 0 到 100%。
- Volume Up
- 將音量提高 10%。
- Volume Down
- 將音量降低 10%。
- Seek
- 跳到目前曲目中的某個位置，以秒為單位。
- Toggle Shuffle
- 開啟、關閉或切換隨機播放，並顯示是否已開啟。
- Set Repeat Mode
- 將重複設為 Off、Repeat Track 或 Repeat Album/Playlist。
- Play Track
- 播放目前佇列中的曲目，或在動作執行時要求選擇一首。
- Play Playlist
- 播放其中一個播放清單，或在動作執行時要求選擇一個。
- 評價曲目
- 對目前曲目按喜歡、不喜歡或清除評分，或開關喜歡或不喜歡。
- 靜音
- 將應用程式靜音、取消靜音或切換靜音。
- 播放影片或網址
- 從 YouTube Music 連結、youtu.be 連結、影片 ID 或播放清單 ID 開始播放影片或播放清單。
觸發器8
按鈕或流程可以對這些事件做出反應。
- 評分已變更
- 目前曲目被按喜歡、不喜歡或清除評分，可限定於單一評分。
- 曲目已變更
- 開始播放另一首曲目，附其標題、演出者和專輯（位於 音樂播放器 下）。
- 播放已開始
- 播放已開始或繼續（位於 音樂播放器 下）。
- 播放已暫停
- 播放已暫停（位於 音樂播放器 下）。
- 播放已停止
- 播放已停止（位於 音樂播放器 下）。
- 音量已變更
- 音量已變更，附新值和先前的值（位於 音樂播放器 下）。
- 播放器已連線
- 應用程式已可連線（位於 音樂播放器 下）。
- 播放器已中斷連線
- 應用程式已無法連線（位於 音樂播放器 下）。
變數21
在按鈕和小工具上顯示這些值，或在條件中使用。
ytmdesktop_is_connected- Macro Deck 是否已連線到應用程式。
ytmdesktop_current_track_name- 目前曲目的標題。
ytmdesktop_current_artist- 目前曲目的演出者。
ytmdesktop_current_album- 目前曲目的專輯。
ytmdesktop_album_art_url- 目前封面在 Macro Deck 中的位址。
ytmdesktop_playback_state- 播放狀態：
playing、paused或stopped。 ytmdesktop_is_playing- 目前是否正在播放音樂。
ytmdesktop_current_position- 曲目已播放的秒數。也可以設定此值來跳轉。
ytmdesktop_track_duration- 以秒為單位的目前曲目長度。
ytmdesktop_progress_percentage- 曲目已播放的百分比。
ytmdesktop_volume- 以百分比表示的應用程式音量。也可以設定此值，例如使用滑桿。
ytmdesktop_is_muted- 應用程式是否已靜音。
ytmdesktop_like_status- 目前曲目的評分：
like、dislike或indifferent。 ytmdesktop_is_liked- 目前曲目是否已按喜歡。
ytmdesktop_shuffle_enabled- 隨機播放是否已開啟。
ytmdesktop_repeat_mode- 重複模式：
off、track或context。 ytmdesktop_is_live- 目前項目是否為直播。
ytmdesktop_media_type- 目前項目的類型：
audio、video、uploaded或podcast。 ytmdesktop_ad_playing- 目前是否正在播放廣告。
ytmdesktop_video_id- 目前曲目的 YouTube ID。
ytmdesktop_device_name- 顯示為播放來源的名稱。
小工具1
從小工具選擇器將這些小工具加入面板。
- 音樂播放器
- 顯示 YouTube Music Desktop App 正在播放的曲目、演出者和封面，以及進度和播放、暫停和跳過按鈕。
常見問題
可以搭配瀏覽器中的 YouTube Music 使用嗎？
不行。此整合只與 YouTube Music Desktop App 通訊。若要控制瀏覽器分頁中的 YouTube Music，請使用 WebNowPlaying 整合及其瀏覽器擴充功能。
Macro Deck 可以控制另一台電腦上的應用程式嗎？
可以。設定時開啟 進階設定，並輸入執行 YouTube Music Desktop App 的電腦的 位址。
設定時顯示無法連到應用程式，該怎麼辦？
請確認 YouTube Music Desktop App 正在執行、版本為 2.0.6 或更新版本，且已在 Settings > Integrations 下開啟 Companion Server。然後再按一次 繼續。
為什麼設定時要求再次開啟 Companion Authorization？
應用程式只在 Companion Authorization 開啟時接受新的授權請求，並在允許應用程式後自動關閉。請將它開啟，按下 繼續，並在 30 秒內按一下 Allow。
關閉應用程式後會怎麼樣？
ytmdesktop_is_connected 變數會顯示為 false，音樂播放器小工具會顯示 YouTube Music 未執行，而動作會失敗並顯示應用程式未連線的訊息。重新啟動應用程式後，Macro Deck 會在一分鐘內自動重新連線。
更多「音樂和音訊」整合
Spotify
隨附於 Macro Deck控制 Spotify 播放、喜歡歌曲、管理播放清單，並在面板上顯示正在播放的內容。
WebNowPlaying
隨附於 Macro Deck透過 WebNowPlaying 擴充功能，控制瀏覽器中播放的音樂和影片，並顯示正在播放的內容。
Jellyfin
隨附於 Macro Deck從面板控制 Jellyfin 應用程式和電視，顯示正在播放的內容，並在播放開始或停止時做出反應。
SoundPad
隨附於 Macro Deck播放 SoundPad 清單中的音效、控制錄製，並在面板上顯示正在播放的音效。
Voicemeeter
隨附於 Macro Deck從面板控制 Voicemeeter、Banana 或 Potato 的增益、靜音、路由和巨集按鈕。