Spotify
Disertakan dengan Macro DeckKendalikan pemutaran Spotify, sukai lagu, kelola daftar putar, dan tampilkan apa yang diputar di deck Anda.
Dua widget Pemutar musik yang memutar lagu, satu dengan gaya Sampul penuh dan satu dengan gaya Sampul kecil, keduanya dengan nama dan logo Spotify di bagian atas
- Putar, jeda, lewati, lompat posisi, acak, ulangi, dan volume
- Putar lagu atau daftar putar, atau pilih saat tombol ditekan
- Sukai lagu dan tambahkan lagu saat ini ke daftar putar
- Pindahkan pemutaran ke perangkat Spotify lain
- Widget Pemutar musik dan variabel untuk lagu, artis, dan kemajuan
Integrasi Spotify menghubungkan Macro Deck ke akun Spotify Anda melalui Spotify Web API. Integrasi ini mengendalikan pemutaran di mana pun Spotify memutar untuk akun tersebut: aplikasi desktop, ponsel, speaker, atau perangkat Spotify Connect lainnya. Spotify tidak harus berjalan di komputer yang menjalankan Macro Deck.
Untuk terhubung, buat aplikasi kecil milik Anda sendiri di Spotify Developer Dashboard dan masukkan Client ID dan Client Secret-nya di Macro Deck. Macro Deck lalu membuka halaman masuk Spotify, dan Anda mengizinkan akses satu kali. Mengendalikan pemutaran melalui Web API membutuhkan Spotify Premium; ini aturan Spotify, bukan Macro Deck.
Yang dapat dilakukan
- Putar, jeda, lewati, lompat posisi, aktifkan atau nonaktifkan acak, atur mode ulangi, dan ubah volume.
- Mulai lagu atau daftar putar tertentu. Biarkan pilihannya kosong, dan Macro Deck meminta Anda memilih saat tombol ditekan.
- Mulai pemutaran di perangkat tertentu, atau pindahkan pemutaran ke perangkat lain dan biarkan tetap diputar atau dijeda.
- Tambahkan lagu saat ini ke Lagu yang Disukai atau hapus dari sana, dan tambahkan ke atau hapus dari daftar putar.
- Tampilkan apa yang diputar di widget Pemutar musik, dengan sampul, kemajuan, serta tombol putar dan lewati.
- Gunakan variabel seperti
spotify_current_track_namedi label tombol, dan ikat slider kespotify_volumeatauspotify_current_position.
Beberapa contoh penggunaan:
- Tombol Toggle Play/Pause yang menampilkan apakah musik sedang diputar atau dijeda.
- Tombol hati dengan Alihkan Lagu yang Disukai yang menampilkan apakah lagu saat ini ada di Lagu yang Disukai.
- Tombol yang memindahkan pemutaran dari komputer ke speaker ruang keluarga dengan Transfer Playback.
- Slider yang terikat pada
spotify_volumeyang mengikuti volume dan mengubahnya saat digeser.
Cara kerjanya
Macro Deck menanyakan status pemutaran ke Spotify sekitar setiap 3 detik saat musik diputar, setiap 5 detik saat dijeda, dan setiap 10 detik saat tidak ada yang diputar. Perubahan yang Anda buat di aplikasi Spotify muncul dalam rentang waktu itu. Token akses diperbarui di latar belakang, jadi Anda hanya perlu masuk lagi jika Spotify mencabut akses. Jika Spotify membatasi jumlah permintaan atau tidak menjawab, Macro Deck berhenti sejenak, menyimpan status terakhir yang diketahui, dan menampilkan masalah di halaman Spotify pada Integrasi sampai dapat melanjutkan. Anda dapat menghubungkan satu akun Spotify.
Yang Anda butuhkan
- Akun Spotify Premium. Spotify hanya mengizinkan akun Premium mengendalikan pemutaran melalui Web API-nya.
- Aplikasi milik Anda sendiri di Spotify Developer Dashboard, untuk Client ID dan Client Secret-nya.
- Browser web di komputer yang menjalankan Macro Deck, untuk masuk ke Spotify.
- Spotify terbuka di setidaknya satu perangkat, agar ada yang dapat dikendalikan.
Cara menyiapkan
Langkah 1: Buat aplikasi di Spotify Developer Dashboard
Buka Spotify Developer Dashboard di developer.spotify.com/dashboard, masuk, dan buat aplikasi baru. Nama dan deskripsi apa pun bisa digunakan.
Langkah 2: Mulai penyiapan di Macro Deck
Di Macro Deck, klik Integrasi di bilah samping, lalu klik Spotify. Di tab Ringkasan, klik Siapkan di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama, dan integrasi menjadi aktif setelah penyiapan selesai. Dialog Hubungkan Spotify menampilkan Redirect URI dengan tombol salin.
Langkah 3: Tambahkan Redirect URI ke aplikasi Spotify
Di pengaturan aplikasi Spotify Anda, tambahkan Redirect URI yang ditampilkan Macro Deck, persis seperti yang ditampilkan, lalu simpan.
Langkah 4: Masukkan Client ID dan Client Secret
Salin Client ID dan Client Secret dari aplikasi Spotify Anda dan tempelkan ke kolom dengan nama yang sama di Macro Deck. Lalu klik Lanjutkan.
Langkah 5: Izinkan akses di browser
Macro Deck membuka halaman masuk Spotify di browser, dan dialog menampilkan Menunggu otorisasi…. Masuk dengan akun Premium Anda dan izinkan akses, lalu kembali ke Macro Deck. Penyiapan berlanjut dengan sendirinya dan menamai konfigurasi sesuai akun Spotify Anda, misalnya Spotify (Alex). Saat dialog menampilkan Pengaturan selesai., klik Selesai.
Langkah 6: Tambahkan aksi ke tombol
Di halaman Deck, klik tombol yang ingin digunakan. Deck harus dalam keadaan tidak terkunci: jika tombol di kanan atas bertuliskan Kunci, deck tidak terkunci. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih Spotify di sisi kiri dialog Tambah aksi, lalu pilih aksi seperti Toggle Play/Pause. Lalu klik Simpan.
Langkah 7: Tekan tombolnya
Mulai memutar sesuatu di Spotify di perangkat mana pun, lalu tekan tombol di deck Anda. Pemutaran dijeda atau dilanjutkan.
Aksi18
Pasang aksi ini di tombol atau jalankan dari alur.
- Play
- Melanjutkan pemutaran.
- Pause
- Menjeda pemutaran.
- Toggle Play/Pause
- Beralih antara putar dan jeda, dan menampilkan status pemutaran di tombol.
- Next Track
- Melompat ke lagu berikutnya.
- Previous Track
- Melompat ke lagu sebelumnya.
- Refresh State
- Langsung menanyakan status pemutaran saat ini ke Spotify.
- Set Volume
- Mengatur volume perangkat yang sedang memutar, dari 0 hingga 100%.
- Volume Up
- Menaikkan volume sebesar 10%.
- Volume Down
- Menurunkan volume sebesar 10%.
- Seek
- Melompat ke posisi tertentu di lagu saat ini, dalam detik.
- Toggle Shuffle
- Mengaktifkan, menonaktifkan, atau mengalihkan acak, dan menampilkan apakah acak aktif.
- Set Repeat Mode
- Mengatur ulangi ke Off, Repeat Track, atau Repeat Album/Playlist.
- Play Track
- Memutar lagu yang Anda cari atau pilih dari Lagu yang Disukai, atau meminta Anda memilih saat aksi berjalan.
- Play Playlist
- Memutar salah satu daftar putar Anda atau yang Anda cari, atau meminta Anda memilih saat aksi berjalan.
- Play on Device
- Memulai pemutaran di perangkat Spotify tertentu, atau meminta Anda memilih saat aksi berjalan.
- Transfer Playback
- Memindahkan pemutaran ke perangkat lain dan membiarkannya tetap diputar atau dijeda.
- Alihkan Lagu yang Disukai
- Menambahkan lagu atau episode saat ini ke Lagu yang Disukai atau menghapusnya, dan menampilkan apakah lagu itu disukai.
- Tambah atau Keluarkan dari Daftar Putar
- Menambahkan lagu atau episode saat ini ke daftar putar atau mengeluarkannya, dan menampilkan apakah lagu itu ada di daftar putar tersebut.
Pemicu8
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Trek Berubah
- Lagu lain mulai diputar, beserta judul, artis, dan albumnya (di bawah Pemutar Musik).
- Pemutaran Dimulai
- Pemutaran dimulai atau dilanjutkan (di bawah Pemutar Musik).
- Pemutaran Dijeda
- Pemutaran dijeda (di bawah Pemutar Musik).
- Pemutaran Dihentikan
- Pemutaran berhenti (di bawah Pemutar Musik).
- Perangkat Pemutaran Berubah
- Pemutaran berpindah ke perangkat lain (di bawah Pemutar Musik).
- Volume Berubah
- Volume berubah, beserta nilai baru dan sebelumnya (di bawah Pemutar Musik).
- Pemutar Terhubung
- Spotify dapat dijangkau (di bawah Pemutar Musik).
- Pemutar Terputus
- Spotify tidak lagi dapat dijangkau (di bawah Pemutar Musik).
Variabel19
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
spotify_current_track_name- Judul lagu yang sedang diputar.
spotify_current_artist- Artis lagu saat ini, dipisahkan dengan koma.
spotify_current_album- Album lagu saat ini.
spotify_playback_state- Status pemutaran:
playing,paused, ataustopped. spotify_is_playing- Apakah musik sedang diputar saat ini.
spotify_volume- Volume dalam persen. Anda juga dapat mengaturnya, misalnya dengan slider.
spotify_track_duration- Panjang lagu saat ini dalam detik.
spotify_current_position- Sejauh mana lagu sudah diputar, dalam detik. Anda juga dapat mengaturnya untuk melompat.
spotify_progress_percentage- Sejauh mana lagu sudah diputar, dalam persen.
spotify_album_art_url- Alamat sampul saat ini di Macro Deck.
spotify_device_name- Nama perangkat yang sedang memutar.
spotify_device_type- Jenis perangkat yang sedang memutar, misalnya komputer atau speaker.
spotify_shuffle_enabled- Apakah acak aktif.
spotify_repeat_mode- Mode ulangi:
off,track, ataucontext. spotify_is_connected- Apakah Macro Deck dapat menjangkau Spotify dan ada sesi yang dapat digunakan.
spotify_current_track_url- Tautan Spotify untuk lagu saat ini.
spotify_current_track_is_liked- Apakah lagu saat ini ada di Lagu yang Disukai Anda.
spotify_top_track,spotify_top_artist- Lagu dan artis yang paling sering Anda putar.
spotify_top_tracks,spotify_top_artists- Lagu dan artis yang paling sering Anda putar, sebagai daftar.
Widget1
Tambahkan ke deck Anda dari pemilih widget.
- Pemutar musik
- Menampilkan lagu, artis, dan sampul yang diputar Spotify, dengan kemajuan serta tombol putar, jeda, dan lewati.
Pertanyaan yang sering diajukan
Mengapa diperlukan Spotify Premium?
Spotify hanya mengizinkan akun Premium mengendalikan pemutaran melalui Web API-nya. Dengan akun gratis, Spotify menolak perintah, dan Macro Deck menampilkan masalah Diperlukan Spotify Premium di halaman Spotify pada Integrasi. Ini batasan Spotify, bukan Macro Deck.
Mengapa aplikasi Spotify sendiri harus dibuat?
Macro Deck berkomunikasi dengan Spotify menggunakan Client ID dan Client Secret dari aplikasi milik Anda. Spotify menghitung permintaan per aplikasi, sehingga deck Anda tidak berbagi batas dengan pengguna lain. Membuat aplikasinya gratis dan hanya butuh satu menit di Spotify Developer Dashboard.
Apakah Spotify harus berjalan di komputer yang sama dengan Macro Deck?
Tidak. Macro Deck mengendalikan akun Anda melalui internet, sehingga dapat mengendalikan Spotify di perangkat mana pun yang memutar untuk akun tersebut, seperti ponsel atau speaker Spotify Connect. Dengan Play on Device dan Transfer Playback, Anda memilih perangkatnya.
Bisakah lebih dari satu akun Spotify dihubungkan?
Tidak. Integrasi ini mendukung satu konfigurasi. Memilih Konfigurasi ulang menggantinya dengan akun lain, dan tombol serta widget Anda tetap berfungsi.
Macro Deck menyatakan Spotify membatasi permintaannya. Apa yang bisa dilakukan?
Spotify berhenti menjawab jika terlalu banyak permintaan dibuat dengan kredensial aplikasi Anda. Macro Deck menghentikan sementara permintaannya dan memberi tahu kapan akan melanjutkan. Batas ini menghitung setiap aplikasi yang memakai Client ID yang sama, jadi menutup aplikasi lain yang memakainya biasanya membantu.
Di mana kredensial Spotify disimpan?
Client Secret dan token yang diberikan Spotify disimpan terenkripsi di komputer yang menjalankan Macro Deck. Semuanya hanya dikirim ke Spotify. Kata sandi Spotify Anda tidak pernah dimasukkan di Macro Deck; Anda masuk di situs web Spotify.
Lainnya di Musik dan audio
YouTube Music Desktop App
Disertakan dengan Macro DeckKendalikan YouTube Music Desktop App dari deck Anda: pemutaran, volume, peringkat, dan apa yang diputar.
WebNowPlaying
Disertakan dengan Macro DeckKendalikan musik dan video yang diputar di browser Anda dan tampilkan apa yang diputar, melalui ekstensi WebNowPlaying.
Jellyfin
Disertakan dengan Macro DeckKendalikan aplikasi dan TV Jellyfin dari deck Anda, tampilkan apa yang diputar, dan bereaksi saat pemutaran dimulai atau berhenti.
SoundPad
Disertakan dengan Macro DeckPutar suara dari daftar SoundPad, kendalikan rekaman, dan tampilkan suara yang diputar di deck Anda.
Voicemeeter
Disertakan dengan Macro DeckKendalikan gain, bisu, pengarahan, dan tombol makro Voicemeeter, Banana, atau Potato dari deck Anda.