Spotify

Spotify 연동은 Spotify Web API를 통해 Macro Deck을 Spotify 계정에 연결합니다. 데스크톱 앱, 스마트폰, 스피커 등 그 계정으로 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 계정은 하나만 연결할 수 있습니다.