Spotify

Spotify 連携は、Spotify Web API を通じて Macro Deck を Spotify アカウントに接続します。デスクトップアプリ、スマートフォン、スピーカーなどの Spotify Connect デバイスなど、そのアカウントで Spotify が再生している場所ならどこでも再生を操作できます。Spotify が Macro Deck と同じコンピューターで動いている必要はありません。

接続するには、Spotify Developer Dashboard で自分用の小さなアプリを作成し、その クライアント ID と クライアントシークレット を Macro Deck に入力します。その後 Macro Deck が Spotify のログインを開くので、一度だけアクセスを許可します。Web API で再生を操作するには Spotify Premium が必要です。これは Macro Deck ではなく Spotify のルールです。

できること

• 再生、一時停止、スキップ、シーク、シャッフルのオンとオフ、リピートモードの設定、音量の変更。
• 特定の曲やプレイリストを再生する。選択を空欄にすると、ボタンを押したときに Macro Deck が選ぶよう求めます。
• 特定のデバイスで再生を開始する、または再生を別のデバイスに移して、再生または一時停止のまま続ける。
• 現在の曲をお気に入りの曲に追加または削除する、プレイリストに追加または削除する。
• ミュージックプレーヤー ウィジェットに、カバー、進行状況、再生とスキップのボタンとともに再生中の内容を表示する。
• spotify_current_track_name などの変数をボタンのラベルに使い、スライダーを spotify_volume や spotify_current_position にバインドする。

設定例:

• 音楽が再生中か一時停止中かを表示する Toggle Play/Pause ボタン。
• 現在の曲がお気に入りの曲に入っているかを表示する、お気に入りの曲の切り替え を設定したハートのボタン。
• Transfer Playback で再生をコンピューターからリビングのスピーカーに移すボタン。
• spotify_volume にバインドしたスライダー。音量に追従し、ドラッグすると音量が変わります。

動作のしくみ

Macro Deck は、音楽の再生中は約 3 秒ごと、一時停止中は 5 秒ごと、何も再生していないときは 10 秒ごとに Spotify に再生状態を問い合わせます。Spotify アプリでの変更は、その間隔のうちに反映されます。アクセストークンはバックグラウンドで更新されるので、サインインし直すのは Spotify がアクセスを取り消したときだけです。Spotify がリクエスト数を制限したり応答しなかったりすると、Macro Deck は一時停止して最後の状態を保持し、再開できるまで 連携 の Spotify のページに問題を表示します。接続できる Spotify アカウントは 1 つです。