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 一次，之后只要应用在运行，它就会自动连接。
可以做什么
- 播放、暂停、切换曲目、跳转、开启或关闭随机播放、设置循环模式和更改音量。
- 将应用静音或取消静音。
- 喜欢或不喜欢当前曲目、清除其评分，或者切换喜欢或不喜欢状态。
- 从当前队列或你的某个播放列表中开始播放曲目，或在按下按键时再选择。
- 通过 YouTube Music 链接、youtu.be 链接、视频 ID 或播放列表 ID 开始播放特定的视频或播放列表。
- 在 音乐播放器 组件中显示正在播放的内容，包括封面、进度以及播放和切换按钮。
- 在曲目被喜欢、不喜欢或评分被清除时，通过流程做出响应。
一些示例设置：
- 一个 Toggle Play/Pause 按键，显示音乐正在播放还是已暂停。
- 一个使用 切换喜欢 模式的 为曲目评分 的喜欢按键，其标签绑定到
ytmdesktop_like_status。 - 一个使用 播放视频或 URL 的按键，通过 YouTube Music 链接开始播放专注歌单。
- 一个绑定到
ytmdesktop_volume的滑块，跟随应用的音量变化，拖动时也会更改音量。
运行方式
Macro Deck 与 Companion Server 保持实时连接，因此在应用中所做的更改会立即显示在面板上。应用关闭时，Macro Deck 会在 5 秒后重试，每次尝试失败后等待的时间会更长，最长一分钟。ytmdesktop_is_connected 变量显示应用是否可以访问。如果在应用中移除了访问权限，该集成页面上的问题 YouTube Music Desktop App 拒绝了授权 会要求重新运行设置。默认情况下，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。在 概览 选项卡的 配置 部分中点击 设置。打开右上角的开关也会打开同一个对话框，完成设置后集成即会启用。启用 Companion Server 对话框中没有需要填写的字段。如果应用运行在另一台电脑上，请开启 高级配置 并输入其 地址。将 端口 保持为
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
- 播放你的某个播放列表，或在动作运行时让你选择一个。
- 为曲目评分
- 喜欢、不喜欢或清除当前曲目的评分，或者切换喜欢或不喜欢状态。
- 静音
- 将应用静音、取消静音或切换静音状态。
- 播放视频或 URL
- 通过 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 的增益、静音、路由和宏按钮。