SinusBot
Disertakan dengan Macro DeckKendalikan musik instans SinusBot Anda dan tampilkan apa yang diputarnya di deck.
Dua widget Pemutar musik yang memutar lagu, satu dengan gaya Sampul penuh dan satu dengan gaya Sampul kecil, keduanya dengan nama dan logo SinusBot di bagian atas
- Putar, jeda, lewati, dan lompat posisi di instans SinusBot mana pun
- Atur volume, acak, dan ulangi
- Putar lagu dari pustaka bot
- Menampilkan lagu yang diputar di widget Pemutar musik
- Tambahkan instans bot sebanyak yang Anda mau
SinusBot adalah bot musik untuk TeamSpeak dan Discord yang Anda jalankan di server sendiri. Integrasi SinusBot menghubungkan Macro Deck ke antarmuka web SinusBot, sehingga Anda dapat mengendalikan apa yang diputar sebuah instans bot dan melihat lagu yang sedang diputar di deck. Integrasi ini bekerja dengan SinusBot mana pun yang dapat dijangkau Macro Deck melalui jaringan, di komputer yang sama, di jaringan lokal, atau di server.
Yang dapat dilakukan
- Putar, jeda, alihkan, lewati ke lagu berikutnya atau sebelumnya, dan lompat ke posisi tertentu di lagu saat ini.
- Atur volume, naikkan atau turunkan, aktifkan atau nonaktifkan acak, dan aktifkan atau nonaktifkan ulangi.
- Putar lagu tertentu dari pustaka bot dengan Play Track. Biarkan lagunya kosong untuk memilih saat tombol ditekan.
- Tampilkan lagu, artis, dan sampul yang diputar di widget Pemutar musik Macro Deck, dan gunakan lagu, posisi, dan volume bot di label melalui variabel.
Beberapa contoh penggunaan:
- Sederet tombol dengan Previous Track, Toggle Play/Pause, dan Next Track untuk bot di kanal TeamSpeak Anda. Tombol putar menampilkan apakah bot sedang memutar.
- Slider yang terikat pada variabel volume bot,
sinusbot_<instance>_volume, sehingga Anda dapat mengecilkan musik saat berbicara. - Widget Pemutar musik untuk setiap bot, di samping tombol yang warnanya mengikuti sampul melalui variabel
music_player_<player>_album_color.
Beberapa bot dan cara kerjanya
Setiap instans SinusBot yang ingin dikendalikan adalah satu konfigurasi. Anda dapat menambahkan sebanyak yang diinginkan, juga instans di server yang berbeda, dan memilih instans di kolom Player pada setiap aksi. Jika Player dibiarkan kosong, aksi mengendalikan instans pertama. Setiap konfigurasi mendapat kumpulan variabelnya sendiri, dinamai sesuai nama konfigurasinya, misalnya sinusbot_<instance>_volume.
Macro Deck memeriksa koneksi saat Anda menyiapkan konfigurasi dan memuat instans yang dimiliki bot. Selama berjalan, Macro Deck membaca status pemutaran secara berkala. Jika bot tidak dapat dijangkau sesaat, deck tetap menampilkan lagu terakhir; jika tetap tidak dapat dijangkau, variabel sinusbot_<instance>_is_connected bernilai false dan aksi tidak melakukan apa-apa sampai bot menjawab lagi.
Yang Anda butuhkan
- SinusBot yang berjalan dan antarmuka webnya dapat dijangkau Macro Deck, misalnya
http://your-bot:8087. - Nama pengguna dan kata sandi SinusBot.
- Setidaknya satu instans yang dibuat di antarmuka web SinusBot.
Cara menyiapkan
Langkah 1: Periksa antarmuka web SinusBot
Buka antarmuka web SinusBot di browser dan masuk. Catat alamatnya beserta port, misalnya
http://192.168.1.20:8087, dan pastikan ada setidaknya satu instans.Langkah 2: Buka integrasi SinusBot
Di Macro Deck, klik Integrasi di bilah samping, lalu klik SinusBot. Di tab Ringkasan, klik Tambah konfigurasi di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama, dan integrasi menjadi aktif setelah penyiapan selesai.
Langkah 3: Masukkan server dan kredensial masuk
Di dialog Hubungkan SinusBot, masukkan:
- URL server: alamat antarmuka web SinusBot, termasuk port.
- Nama pengguna dan Kata sandi: akun yang digunakan untuk masuk ke SinusBot.
Saat Anda mengklik Lanjutkan, Macro Deck menguji koneksi dan memuat instansnya.
Langkah 4: Pilih instans
Di Pilih Instance, pilih instans bot di Instance, lalu klik Lanjutkan. Konfigurasi disimpan sebagai SinusBot dengan nama instans di dalam tanda kurung. Ulangi langkah ini untuk setiap instans lain yang ingin dikendalikan.
Langkah 5: Tambahkan aksi ke tombol
Di halaman Deck, klik sebuah tombol. Deck harus dalam keadaan tidak terkunci: jika tombol Kunci tampil di kanan atas, deck tidak terkunci. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih SinusBot di sisi kiri dialog Tambah aksi, pilih Toggle Play/Pause, lalu pilih instans di Player.
Langkah 6: Tekan tombolnya
Tekan tombol di deck Anda. Bot memulai atau menjeda pemutaran, dan tombol menampilkan status saat ini. Widget Pemutar musik yang diatur ke instans tersebut menampilkan lagu yang diputar.
Aksi13
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 saat ini di tombol.
- Next Track
- Melompat ke lagu berikutnya.
- Previous Track
- Melompat ke lagu sebelumnya.
- Refresh State
- Langsung membaca ulang status yang sedang diputar.
- Set Volume
- Mengatur volume pemutaran (0 hingga 100%).
- Volume Up
- Menaikkan volume pemutaran sebesar 10%.
- Volume Down
- Menurunkan volume pemutaran sebesar 10%.
- Seek
- Melompat ke posisi tertentu di lagu saat ini, dalam detik.
- Toggle Shuffle
- Mengalihkan acak, atau mengaktifkan atau menonaktifkannya.
- Set Repeat Mode
- Mengaktifkan atau menonaktifkan ulangi. SinusBot hanya memiliki satu mode ulangi, jadi kedua opsi ulangi sama-sama mengaktifkannya.
- Play Track
- Memutar lagu dari pustaka bot. Biarkan kosong untuk memilih lagu saat tombol ditekan.
Pemicu7
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Trek Berubah
- Lagu lain mulai diputar (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 bot berubah, beserta nilai baru dan sebelumnya (di bawah Pemutar Musik).
- Pemutar Terhubung
- Instans bot dapat dijangkau (di bawah Pemutar Musik).
- Pemutar Terputus
- Instans bot tidak lagi dapat dijangkau (di bawah Pemutar Musik).
Variabel8
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Lagu saat ini dan artisnya. SinusBot tidak melaporkan album, jadi
sinusbot_<instance>_current_albumtetap kosong. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Apakah bot sedang memutar, dijeda, atau berhenti.
sinusbot_<instance>_volume- Volume pemutaran dalam persen. Anda juga dapat mengaturnya, misalnya dengan slider.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- Panjang lagu dan posisi dalam detik, serta kemajuan dalam persen. Anda dapat mengatur posisi untuk melompat.
sinusbot_<instance>_album_art_url- Alamat sampul saat ini.
sinusbot_<instance>_device_name- Nama instans bot.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Apakah acak dan ulangi aktif.
sinusbot_<instance>_is_connected- Apakah Macro Deck dapat menjangkau instans bot.
Pertanyaan yang sering diajukan
Bisakah lebih dari satu bot dikendalikan?
Bisa. Tambahkan satu konfigurasi per instans SinusBot, juga di server yang berbeda. Setiap aksi memiliki kolom Player untuk instans yang dikendalikannya, dan setiap konfigurasi memiliki variabelnya sendiri.
Apakah SinusBot harus berjalan di komputer yang sama?
Tidak. Macro Deck berkomunikasi dengan antarmuka web SinusBot melalui jaringan, sehingga bot dapat berjalan di server atau komputer lain, selama Macro Deck dapat menjangkau alamatnya.
Penyiapan menyatakan tidak ada instans yang ditemukan. Apa yang bisa dilakukan?
Akun tersebut tidak memiliki instans yang dapat digunakan. Buat instans di antarmuka web SinusBot terlebih dahulu, lalu siapkan konfigurasi lagi.
Apa yang terjadi jika bot luring?
Gangguan singkat tidak mengosongkan deck: deck tetap menampilkan lagu terakhir sebentar. Jika bot tetap tidak dapat dijangkau, variabel sinusbot_<instance>_is_connected bernilai false, dan Macro Deck terus mencoba menjangkaunya.
Di mana kata sandi disimpan?
Kata sandi disimpan terenkripsi di komputer Anda dan hanya digunakan untuk masuk ke SinusBot Anda.
Lainnya di Obrolan dan suara
Discord
Disertakan dengan Macro DeckBisukan mikrofon, nonaktifkan suara, gabung ke saluran suara, ubah pengaturan suara, dan kirim pesan webhook di Discord dari deck Anda.
Webhook Discord
Disertakan dengan Macro DeckKirim pesan kaya dengan embed dan sebutan ke saluran Discord melalui webhook, dengan pratinjau langsung.