YouTube Music Desktop App
Disertakan dengan Macro DeckKendalikan YouTube Music Desktop App dari deck Anda: pemutaran, volume, peringkat, dan apa yang diputar.
Dua widget Pemutar musik yang memutar lagu, satu dengan gaya Sampul penuh dan satu dengan gaya Sampul kecil, keduanya dengan nama dan logo YouTube Music Desktop App di bagian atas
- Putar, jeda, lewati, lompat posisi, acak, ulangi, dan volume
- Sukai, tidak sukai, atau hapus peringkat lagu saat ini
- Mulai video atau daftar putar dari tautan atau id
- Pembaruan langsung melalui Companion Server aplikasi
- Widget Pemutar musik dan variabel untuk lagu, artis, dan kemajuan
Integrasi YouTube Music Desktop App menghubungkan Macro Deck ke YouTube Music Desktop App (YTMDesktop), aplikasi desktop untuk YouTube Music. Integrasi ini menggunakan Companion Server aplikasi, yang sudah ada di versi 2.0.6 dan yang lebih baru. Anda mengizinkan Macro Deck sekali di aplikasi, dan sejak itu Macro Deck terhubung dengan sendirinya setiap kali aplikasi berjalan.
Yang dapat dilakukan
- Putar, jeda, lewati, lompat posisi, aktifkan atau nonaktifkan acak, atur mode ulangi, dan ubah volume.
- Bisukan atau bunyikan aplikasi.
- Sukai atau tidak sukai lagu saat ini, hapus peringkatnya, atau nyalakan dan matikan suka atau tidak suka.
- Mulai lagu dari antrean saat ini atau salah satu daftar putar Anda, atau pilih saat tombol ditekan.
- Mulai video atau daftar putar tertentu dari tautan YouTube Music, tautan youtu.be, id video, atau id daftar putar.
- Tampilkan apa yang diputar di widget Pemutar musik, dengan sampul, kemajuan, serta tombol putar dan lewati.
- Bereaksi dengan alur saat lagu disukai, tidak disukai, atau peringkatnya dihapus.
Beberapa contoh penggunaan:
- Tombol Toggle Play/Pause yang menampilkan apakah musik sedang diputar atau dijeda.
- Tombol suka dengan Beri Peringkat Lagu dalam mode Balik Suka, dengan label yang terikat pada
ytmdesktop_like_status. - Tombol dengan Putar Video atau URL yang memulai daftar putar fokus Anda dari tautan YouTube Music-nya.
- Slider yang terikat pada
ytmdesktop_volumeyang mengikuti volume aplikasi dan mengubahnya saat digeser.
Cara kerjanya
Macro Deck menjaga koneksi langsung ke Companion Server, sehingga perubahan yang Anda buat di aplikasi langsung muncul di deck. Saat aplikasi ditutup, Macro Deck mencoba lagi setelah 5 detik dan menunggu lebih lama setelah setiap percobaan yang gagal, hingga satu menit. Variabel ytmdesktop_is_connected menampilkan apakah aplikasi dapat dijangkau. Jika akses dicabut di aplikasi, masalah YouTube Music Desktop App menolak otorisasi di halaman integrasi meminta Anda menjalankan penyiapan lagi. Secara bawaan, Macro Deck mencari aplikasi di komputer yang sama. Di Konfigurasi lanjutan pada penyiapan, Anda dapat memasukkan alamat komputer lain. Anda dapat menyiapkan satu YouTube Music Desktop App.
Yang Anda butuhkan
- YouTube Music Desktop App 2.0.6 atau yang lebih baru. Versi 1 tidak memiliki Companion Server.
- Companion Server diaktifkan di aplikasi pada Settings > Integrations.
- Companion Authorization diaktifkan selama Anda menyiapkan Macro Deck.
Cara menyiapkan
Langkah 1: Pasang YouTube Music Desktop App
Pasang YouTube Music Desktop App 2.0.6 atau yang lebih baru dan jalankan. Dialog penyiapan di Macro Deck menautkan ke halaman rilis aplikasi tersebut.
Langkah 2: Aktifkan Companion Server
Di YouTube Music Desktop App, masuk ke Settings > Integrations. Aktifkan Companion Server dan Companion Authorization. Aplikasi menonaktifkan otorisasi lagi dengan sendirinya setelah Anda mengizinkan Macro Deck.
Langkah 3: Mulai penyiapan di Macro Deck
Di Macro Deck, klik Integrasi di bilah samping, lalu klik YouTube Music Desktop App. 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 Aktifkan Companion Server tidak memiliki kolom untuk diisi. Jika aplikasi berjalan di komputer lain, aktifkan Konfigurasi lanjutan dan masukkan Alamat-nya. Biarkan Port tetap
9863. Klik Lanjutkan.Langkah 4: Izinkan Macro Deck di aplikasi
Dialog kini menampilkan Izinkan Macro Deck dengan Kode otorisasi. Klik Lanjutkan: jendela persetujuan terbuka di YouTube Music Desktop App dengan Macro Deck dan sebuah kode. Pastikan kodenya cocok dan klik Allow dalam 30 detik. Saat dialog di Macro Deck menampilkan Pengaturan selesai., klik Selesai.
Langkah 5: 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 YouTube Music Desktop App di sisi kiri dialog Tambah aksi, lalu pilih aksi seperti Toggle Play/Pause atau Beri Peringkat Lagu. Lalu klik Simpan.
Langkah 6: Tekan tombolnya
Mulai lagu di YouTube Music Desktop App dan tekan tombol di deck Anda. Pemutaran dijeda atau dilanjutkan.
Aksi17
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 membaca status pemutaran saat ini.
- Set Volume
- Mengatur volume aplikasi, 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 dari antrean saat ini, atau meminta Anda memilih saat aksi berjalan.
- Play Playlist
- Memutar salah satu daftar putar Anda, atau meminta Anda memilih saat aksi berjalan.
- Beri Peringkat Lagu
- Menyukai, tidak menyukai, atau menghapus peringkat lagu saat ini, atau menyalakan dan mematikan suka atau tidak suka.
- Bisukan
- Membisukan, membunyikan, atau mengalihkan status bisu aplikasi.
- Putar Video atau URL
- Memulai video atau daftar putar dari tautan YouTube Music, tautan youtu.be, id video, atau id daftar putar.
Pemicu8
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Peringkat Berubah
- Lagu saat ini disukai, tidak disukai, atau peringkatnya dihapus, secara opsional hanya untuk satu peringkat.
- 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).
- Volume Berubah
- Volume berubah, beserta nilai baru dan sebelumnya (di bawah Pemutar Musik).
- Pemutar Terhubung
- Aplikasi dapat dijangkau (di bawah Pemutar Musik).
- Pemutar Terputus
- Aplikasi tidak lagi dapat dijangkau (di bawah Pemutar Musik).
Variabel21
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
ytmdesktop_is_connected- Apakah Macro Deck terhubung ke aplikasi.
ytmdesktop_current_track_name- Judul lagu saat ini.
ytmdesktop_current_artist- Artis lagu saat ini.
ytmdesktop_current_album- Album lagu saat ini.
ytmdesktop_album_art_url- Alamat sampul saat ini di Macro Deck.
ytmdesktop_playback_state- Status pemutaran:
playing,paused, ataustopped. ytmdesktop_is_playing- Apakah musik sedang diputar saat ini.
ytmdesktop_current_position- Sejauh mana lagu sudah diputar, dalam detik. Anda juga dapat mengaturnya untuk melompat.
ytmdesktop_track_duration- Panjang lagu saat ini dalam detik.
ytmdesktop_progress_percentage- Sejauh mana lagu sudah diputar, dalam persen.
ytmdesktop_volume- Volume aplikasi dalam persen. Anda juga dapat mengaturnya, misalnya dengan slider.
ytmdesktop_is_muted- Apakah aplikasi dibisukan.
ytmdesktop_like_status- Peringkat lagu saat ini:
like,dislike, atauindifferent. ytmdesktop_is_liked- Apakah lagu saat ini disukai.
ytmdesktop_shuffle_enabled- Apakah acak aktif.
ytmdesktop_repeat_mode- Mode ulangi:
off,track, ataucontext. ytmdesktop_is_live- Apakah item saat ini adalah siaran live.
ytmdesktop_media_type- Jenis item saat ini:
audio,video,uploaded, ataupodcast. ytmdesktop_ad_playing- Apakah iklan sedang diputar saat ini.
ytmdesktop_video_id- ID YouTube dari lagu saat ini.
ytmdesktop_device_name- Nama yang ditampilkan sebagai sumber pemutaran.
Widget1
Tambahkan ke deck Anda dari pemilih widget.
- Pemutar musik
- Menampilkan lagu, artis, dan sampul yang diputar YouTube Music Desktop App, dengan kemajuan serta tombol putar, jeda, dan lewati.
Pertanyaan yang sering diajukan
Apakah berfungsi dengan YouTube Music di browser?
Tidak. Integrasi ini hanya berkomunikasi dengan YouTube Music Desktop App. Untuk YouTube Music di tab browser, gunakan integrasi WebNowPlaying dengan ekstensi browsernya.
Bisakah Macro Deck mengendalikan aplikasi di komputer lain?
Bisa. Saat penyiapan, aktifkan Konfigurasi lanjutan dan masukkan Alamat komputer yang menjalankan YouTube Music Desktop App.
Penyiapan menyatakan tidak dapat menjangkau aplikasi. Apa yang bisa dilakukan?
Pastikan YouTube Music Desktop App sedang berjalan, versinya 2.0.6 atau yang lebih baru, dan Companion Server aktif di Settings > Integrations. Lalu tekan Lanjutkan lagi.
Mengapa penyiapan meminta Companion Authorization diaktifkan lagi?
Aplikasi hanya menerima permintaan otorisasi baru selama Companion Authorization aktif, dan menonaktifkannya dengan sendirinya setelah Anda mengizinkan sebuah aplikasi. Aktifkan, tekan Lanjutkan, dan klik Allow dalam 30 detik.
Apa yang terjadi saat aplikasi ditutup?
Variabel ytmdesktop_is_connected bernilai false, widget Pemutar musik menampilkan bahwa YouTube Music tidak berjalan, dan aksi gagal dengan pesan bahwa aplikasi tidak terhubung. Saat Anda menjalankan aplikasi lagi, Macro Deck terhubung kembali dengan sendirinya dalam satu menit.
Lainnya di Musik dan audio
Spotify
Disertakan dengan Macro DeckKendalikan pemutaran Spotify, sukai lagu, kelola daftar putar, dan tampilkan apa yang diputar di deck Anda.
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.