Spotify
Incluída no Macro DeckControle a reprodução do Spotify, curta músicas, gerencie playlists e mostre no deck o que está tocando.
Dois widgets Reprodutor de música tocando uma faixa, um no estilo Capa completa e outro no estilo Capa pequena, ambos com o nome e o logotipo do Spotify no cabeçalho
- Reproduzir, pausar, pular, mudar a posição, aleatório, repetição e volume
- Toque uma faixa ou playlist, ou escolha uma ao pressionar o botão
- Curta músicas e adicione a faixa atual a uma playlist
- Mova a reprodução para outro dispositivo Spotify
- Widget Reprodutor de música e variáveis para faixa, artista e progresso
A integração Spotify conecta o Macro Deck à sua conta do Spotify pela Spotify Web API. Ela controla a reprodução onde quer que o Spotify esteja tocando para essa conta: o app de desktop, o celular, uma caixa de som ou qualquer outro dispositivo Spotify Connect. O Spotify não precisa rodar no computador em que o Macro Deck está.
Para conectar, crie um pequeno app próprio no Spotify Developer Dashboard e informe o ID do cliente e o Segredo do cliente dele no Macro Deck. O Macro Deck então abre o login do Spotify, e você permite o acesso uma única vez. Controlar a reprodução pela Web API exige o Spotify Premium; essa é uma regra do Spotify, não do Macro Deck.
O que dá para fazer
- Reproduza, pause, pule, mude a posição, ative ou desative a reprodução aleatória, defina o modo de repetição e mude o volume.
- Inicie uma faixa ou playlist específica. Deixe a escolha vazia e o Macro Deck pede para escolher uma ao pressionar o botão.
- Inicie a reprodução em um dispositivo específico, ou mova a reprodução para outro dispositivo mantendo-a tocando ou pausada.
- Adicione a faixa atual às suas Músicas Curtidas ou remova-a, e adicione-a a uma playlist ou remova-a dela.
- Mostre o que está tocando no widget Reprodutor de música, com a capa, o progresso e botões de reproduzir e pular.
- Use variáveis como
spotify_current_track_namenos rótulos dos botões e vincule um controle deslizante aspotify_volumeouspotify_current_position.
Alguns exemplos de uso:
- Um botão Toggle Play/Pause que mostra se a música está tocando ou pausada.
- Um botão de coração com Alternar música curtida que mostra se a música atual está nas suas Músicas Curtidas.
- Um botão que move a reprodução do computador para a caixa de som da sala com Transfer Playback.
- Um controle deslizante vinculado a
spotify_volumeque acompanha o volume e o muda enquanto você arrasta.
Como funciona
O Macro Deck pede ao Spotify o estado da reprodução a cada 3 segundos, mais ou menos, enquanto a música toca, a cada 5 segundos enquanto está pausada e a cada 10 segundos quando nada está tocando. As mudanças feitas no app do Spotify aparecem dentro desse tempo. Os tokens de acesso são renovados em segundo plano, então só é preciso fazer login de novo quando o Spotify revoga o acesso. Quando o Spotify limita o número de requisições ou não responde, o Macro Deck faz uma pausa, mantém o último estado conhecido e mostra um problema na página do Spotify em Integrações até poder continuar. É possível conectar uma conta do Spotify.
O que é necessário
- Uma conta Spotify Premium. O Spotify só deixa contas Premium controlarem a reprodução pela Web API.
- Um app próprio no Spotify Developer Dashboard, para obter o ID do cliente e o Segredo do cliente.
- Um navegador web no computador em que o Macro Deck está rodando, para o login do Spotify.
- O Spotify aberto em pelo menos um dispositivo, para que haja algo a controlar.
Configuração
Passo 1: Crie um app no Spotify Developer Dashboard
Abra o Spotify Developer Dashboard em developer.spotify.com/dashboard, faça login e crie um novo app. Qualquer nome e descrição servem.
Passo 2: Comece a configuração no Macro Deck
No Macro Deck, clique em Integrações na barra lateral e depois em Spotify. Na aba Visão geral, clique em Configurar na seção Configuração. Ativar a chave no canto superior direito abre a mesma caixa de diálogo, e a integração fica ativada assim que a configuração é concluída. A caixa de diálogo Conectar ao Spotify mostra um URI de redirecionamento com um botão para copiar.
Passo 3: Adicione o URI de redirecionamento ao seu app do Spotify
Nas configurações do seu app do Spotify, adicione o URI de redirecionamento que o Macro Deck mostra, exatamente como aparece, e salve.
Passo 4: Informe o ID do cliente e o Segredo do cliente
Copie o Client ID e o Client Secret do seu app do Spotify e cole-os nos campos ID do cliente e Segredo do cliente do Macro Deck. Depois clique em Continuar.
Passo 5: Permita o acesso no navegador
O Macro Deck abre o login do Spotify no navegador, e a caixa de diálogo mostra Aguardando autorização…. Faça login com a sua conta Premium e permita o acesso, depois volte ao Macro Deck. A configuração continua sozinha e recebe o nome da sua conta do Spotify, por exemplo Spotify (Alex). Quando a caixa de diálogo mostrar Configuração concluída., clique em Concluído.
Passo 6: Adicione uma ação a um botão
Na página Deck, clique no botão que você quer usar. O deck precisa estar desbloqueado: se o botão no canto superior direito mostra Bloquear, ele está desbloqueado. O editor abre com Toque curto selecionado. Clique em + Adicionar ação, selecione Spotify à esquerda da caixa de diálogo Adicionar ação e escolha uma ação como Toggle Play/Pause. Depois clique em Salvar.
Passo 7: Pressione o botão
Comece a tocar algo no Spotify em qualquer dispositivo e pressione o botão no seu deck. A reprodução pausa ou é retomada.
Ações18
Coloque estas ações em um botão ou execute-as a partir de um fluxo.
- Play
- Retoma a reprodução.
- Pause
- Pausa a reprodução.
- Toggle Play/Pause
- Alterna entre reproduzir e pausar e mostra o estado da reprodução no botão.
- Next Track
- Pula para a próxima faixa.
- Previous Track
- Volta para a faixa anterior.
- Refresh State
- Pede ao Spotify, na hora, o estado atual da reprodução.
- Set Volume
- Define o volume do dispositivo que está tocando, de 0 a 100%.
- Volume Up
- Aumenta o volume em 10%.
- Volume Down
- Diminui o volume em 10%.
- Seek
- Vai para uma posição da faixa atual, em segundos.
- Toggle Shuffle
- Ativa, desativa ou alterna a reprodução aleatória e mostra se ela está ativada.
- Set Repeat Mode
- Define a repetição como Off, Repeat Track ou Repeat Album/Playlist.
- Play Track
- Toca uma faixa pesquisada ou escolhida das suas Músicas Curtidas, ou pede para escolher uma quando a ação é executada.
- Play Playlist
- Toca uma das suas playlists ou uma pesquisada, ou pede para escolher uma quando a ação é executada.
- Play on Device
- Inicia a reprodução em um dispositivo Spotify específico, ou pede para escolher um quando a ação é executada.
- Transfer Playback
- Move a reprodução para outro dispositivo, mantendo-a tocando ou pausada.
- Alternar música curtida
- Adiciona a faixa ou o episódio atual às suas Músicas Curtidas ou o remove, e mostra se está curtido.
- Adicionar ou remover da lista de reprodução
- Adiciona a faixa ou o episódio atual a uma playlist ou o remove, e mostra se está nessa playlist.
Gatilhos8
Um botão ou fluxo pode reagir a estes eventos.
- Faixa alterada
- Outra faixa começou a tocar, com título, artista e álbum (em Reprodutor de música).
- Reprodução iniciada
- A reprodução começou ou foi retomada (em Reprodutor de música).
- Reprodução pausada
- A reprodução foi pausada (em Reprodutor de música).
- Reprodução parada
- A reprodução parou (em Reprodutor de música).
- Dispositivo de reprodução alterado
- A reprodução passou para outro dispositivo (em Reprodutor de música).
- Volume alterado
- O volume mudou, com o valor novo e o anterior (em Reprodutor de música).
- Reprodutor conectado
- O Spotify ficou acessível (em Reprodutor de música).
- Reprodutor desconectado
- O Spotify não está mais acessível (em Reprodutor de música).
Variáveis19
Mostre estes valores em botões e widgets ou use-os em condições.
spotify_current_track_name- O título da faixa que está tocando.
spotify_current_artist- Os artistas da faixa atual, separados por vírgulas.
spotify_current_album- O álbum da faixa atual.
spotify_playback_state- O estado da reprodução:
playing,pausedoustopped. spotify_is_playing- Se a música está tocando agora.
spotify_volume- O volume em porcentagem. Também é possível defini-lo, por exemplo com um controle deslizante.
spotify_track_duration- A duração da faixa atual em segundos.
spotify_current_position- Quanto da faixa já tocou, em segundos. Também é possível defini-la para ir a outra posição.
spotify_progress_percentage- Quanto da faixa já tocou, em porcentagem.
spotify_album_art_url- O endereço da capa atual no Macro Deck.
spotify_device_name- O nome do dispositivo que está tocando.
spotify_device_type- O tipo do dispositivo que está tocando, por exemplo um computador ou uma caixa de som.
spotify_shuffle_enabled- Se a reprodução aleatória está ativada.
spotify_repeat_mode- O modo de repetição:
off,trackoucontext. spotify_is_connected- Se o Macro Deck alcança o Spotify e há uma sessão utilizável.
spotify_current_track_url- O link do Spotify da faixa atual.
spotify_current_track_is_liked- Se a faixa atual está nas suas Músicas Curtidas.
spotify_top_track,spotify_top_artist- A faixa e o artista que você mais ouve.
spotify_top_tracks,spotify_top_artists- As faixas e os artistas que você mais ouve, como lista.
Widgets1
Adicione estes widgets ao seu deck pelo seletor de widgets.
- Reprodutor de música
- Mostra a faixa, os artistas e a capa do que o Spotify está tocando, com progresso e botões de reproduzir, pausar e pular.
Perguntas frequentes
Por que preciso do Spotify Premium?
O Spotify só deixa contas Premium controlarem a reprodução pela Web API. Com uma conta gratuita, o Spotify recusa os comandos, e o Macro Deck mostra o problema É necessário o Spotify Premium na página do Spotify em Integrações. Esse é um limite do Spotify, não do Macro Deck.
Por que preciso criar meu próprio app do Spotify?
O Macro Deck se comunica com o Spotify usando o Client ID e o Client Secret de um app que pertence a você. O Spotify conta as requisições por app, então o seu deck não divide o limite com outros usuários. Criar o app é gratuito e leva um minuto no Spotify Developer Dashboard.
O Spotify precisa rodar no mesmo computador que o Macro Deck?
Não. O Macro Deck controla a sua conta pela internet, então controla o Spotify em qualquer dispositivo que esteja tocando para essa conta, como o celular ou uma caixa de som Spotify Connect. Com Play on Device e Transfer Playback, você escolhe o dispositivo.
Posso conectar mais de uma conta do Spotify?
Não. A integração aceita uma configuração. Escolher Reconfigurar a substitui por outra conta, e os seus botões e widgets continuam funcionando.
O Macro Deck diz que o Spotify está limitando as requisições. O que fazer?
O Spotify para de responder quando são feitas requisições demais com as credenciais do seu app. O Macro Deck pausa as requisições e avisa quando continua. O limite conta todos os aplicativos que usam o mesmo Client ID, então fechar outros apps que o usam costuma ajudar.
Onde minhas credenciais do Spotify ficam armazenadas?
O Client Secret e os tokens que o Spotify fornece ficam armazenados criptografados no computador em que o Macro Deck está rodando. Eles só são enviados ao Spotify. A sua senha do Spotify nunca é digitada no Macro Deck; o login é feito no site do Spotify.
Mais em Música e áudio
YouTube Music Desktop App
Incluída no Macro DeckControle o YouTube Music Desktop App pelo seu deck: reprodução, volume, avaliações e o que está tocando.
WebNowPlaying
Incluída no Macro DeckControle músicas e vídeos que tocam no navegador e mostre o que está tocando, pela extensão WebNowPlaying.
Jellyfin
Incluída no Macro DeckControle apps e TVs com Jellyfin pelo seu deck, mostre o que está tocando e reaja quando a reprodução começa ou para.
SoundPad
Incluída no Macro DeckToque sons da sua lista do SoundPad, controle gravações e mostre no deck o som que está tocando.
Voicemeeter
Incluída no Macro DeckControle pelo seu deck o ganho, o silenciamento, o roteamento e os botões de macro do Voicemeeter, Banana ou Potato.