Spotify

Spotify 集成通过 Spotify Web API 将 Macro Deck 连接到你的 Spotify 账户。无论该账户在哪里播放 Spotify，它都能控制播放：桌面应用、手机、音箱或任何其他 Spotify Connect 设备。Spotify 不必运行在运行 Macro Deck 的电脑上。

连接时，需要在 Spotify Developer Dashboard 中创建一个属于自己的小应用，并在 Macro Deck 中输入其 客户端 ID 和 客户端密钥。随后 Macro Deck 会打开 Spotify 登录页面，只需允许访问一次即可。通过 Web API 控制播放需要 Spotify Premium；这是 Spotify 的规定，而非 Macro Deck 的。

可以做什么

• 播放、暂停、切换曲目、跳转、开启或关闭随机播放、设置循环模式和更改音量。
• 开始播放特定的曲目或播放列表。将选择留空，Macro Deck 会在按下按键时让你选择一个。
• 在特定设备上开始播放，或将播放转移到另一台设备，并保持播放或暂停状态。
• 将当前曲目添加到 Liked Songs 或从中移除，并将其添加到播放列表或从中移除。
• 在 音乐播放器 组件中显示正在播放的内容，包括封面、进度以及播放和切换按钮。
• 在按键标签中使用 spotify_current_track_name 等变量，并将滑块绑定到 spotify_volume 或 spotify_current_position。

一些示例设置：

• 一个 Toggle Play/Pause 按键，显示音乐正在播放还是已暂停。
• 一个使用 切换歌曲喜欢状态 的爱心按键，显示当前歌曲是否在 Liked Songs 中。
• 一个使用 Transfer Playback 将播放从电脑转移到客厅音箱的按键。
• 一个绑定到 spotify_volume 的滑块，跟随音量变化，拖动时也会更改音量。

运行方式

音乐播放时，Macro Deck 大约每 3 秒向 Spotify 查询一次播放状态；暂停时每 5 秒一次；没有播放时每 10 秒一次。在 Spotify 应用中所做的更改会在这段时间内显示出来。访问令牌会在后台自动续期，因此只有在 Spotify 撤销访问权限时才需要重新登录。当 Spotify 限制请求数量或没有响应时，Macro Deck 会暂停请求，保留最后已知的状态，并在 集成 下的 Spotify 页面上显示问题，直到可以继续为止。可以连接一个 Spotify 账户。