Discord
Disertakan dengan Macro DeckBisukan mikrofon, nonaktifkan suara, gabung ke saluran suara, ubah pengaturan suara, dan kirim pesan webhook di Discord dari deck Anda.
Dialog Hubungkan Discord dengan kolom Client ID dan Client Secret
- Tombol bisukan mikrofon dan nonaktifkan suara yang menampilkan status sebenarnya
- Gabung atau tinggalkan saluran suara dan buka saluran teks
- Atur volume mikrofon dan keluaran, mode suara, dan pemrosesan suara
- Tampilkan aktivitas Rich Presence khusus di profil Anda
- Kirim pesan dan embed ke saluran melalui webhook
Integrasi Discord menghubungkan Macro Deck ke aplikasi desktop Discord resmi di komputer yang sama. Integrasi ini memakai antarmuka RPC lokal Discord, antarmuka yang sama yang disediakan Discord bagi aplikasi pengendali klien, sehingga tombol Anda bekerja seolah-olah Anda sendiri yang mengklik di Discord. Discord hanya memberikan akses ini kepada aplikasi milik Anda sendiri, jadi penyiapan meminta Anda membuat aplikasi gratis di Discord Developer Portal dan mengotorisasinya satu kali.
Yang dapat dilakukan
- Bisukan mikrofon atau nonaktifkan suara dengan Bisukan mikrofon dan Nonaktifkan suara. Tombol menampilkan apakah Anda sedang dibisukan, juga saat Anda membisukan diri di Discord sendiri.
- Gabung ke saluran suara di salah satu server Anda, tinggalkan saluran saat ini, atau buka saluran teks di aplikasi Discord.
- Atur, naikkan, atau turunkan volume mikrofon dan keluaran, beralih antara Tekan untuk bicara dan Aktivitas suara, serta aktifkan atau nonaktifkan peredam kebisingan standar, peredam gema, dan kontrol gain otomatis.
- Tampilkan aktivitas khusus di profil Anda dengan Atur Rich Presence, dan hapus lagi dengan Hapus Rich Presence.
- Kirim pesan, dengan embed opsional, ke saluran mana pun melalui webhook dengan Jalankan webhook. Aksi ini berfungsi tanpa menyiapkan integrasi, asalkan integrasi aktif.
Beberapa contoh penggunaan:
- Tombol Mik dengan Bisukan mikrofon dalam mode Sakelar, yang warnanya mengikuti variabel
discord_is_self_muted. - Tombol yang bergabung ke saluran suara tim Anda dengan Pindahkan jika sudah terhubung ke saluran lain aktif, sehingga tetap berfungsi saat Anda berada di saluran lain.
- Alur pada pemicu Mikrofon dibungkam yang menyalakan lampu merah, dan alur pada Mikrofon aktif yang mematikannya lagi.
- Tombol yang mengirim "Stream sudah live" beserta tautan ke kanal Anda melalui webhook.
Cara kerjanya
Macro Deck terhubung ke Discord saat dimulai dan terhubung kembali dengan sendirinya saat Anda menutup dan membuka lagi Discord, dengan menunggu sedikit lebih lama setelah setiap percobaan yang gagal, hingga satu menit. Pemicu Terhubung dan Terputus berjalan saat hal itu terjadi. Selama Discord tidak terhubung, variabel bernilai tidak tersedia, kecuali discord_is_connected. Perubahan yang Anda buat di Discord, serta pembisuan oleh moderator, langsung muncul di variabel dan pemicu. Anda dapat menyiapkan satu akun Discord.
Yang Anda butuhkan
- Aplikasi desktop Discord resmi, berjalan di komputer yang sama dengan Macro Deck. Di Linux, versi Flatpak dan Snap juga berfungsi.
- Akun Discord dan aplikasi gratis milik Anda sendiri di Discord Developer Portal.
- Macro Deck dan Discord dijalankan dengan hak akses yang sama (keduanya tidak sebagai administrator, atau keduanya sebagai administrator).
- Khusus untuk Jalankan webhook: URL webhook dari sebuah saluran. Aksi ini memerlukan integrasi yang aktif, tetapi tanpa penyiapan.
Cara menyiapkan
Langkah 1: Buat aplikasi Discord
Buka Discord Developer Portal dan buat aplikasi baru. Namanya tidak penting. Salin Application ID dari General Information: inilah Client ID.
Langkah 2: Tambahkan redirect URI dan salin secret
Di aplikasi Anda, buka OAuth2. Tambahkan
http://localhost/sebagai redirect dan simpan. Alamat ini tidak pernah dibuka, Discord hanya memeriksa bahwa alamat tersebut terdaftar. Lalu salin Client Secret (setel ulang jika Discord tidak menampilkannya).Langkah 3: Buka Discord di Macro Deck
Pastikan aplikasi desktop Discord sedang berjalan. Di Macro Deck, klik Integrasi di bilah samping, lalu klik Discord.
Langkah 4: Masukkan Client ID dan Client Secret
Di tab Ringkasan, klik Siapkan di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama. Di dialog Hubungkan Discord, tempelkan Client ID dan Client Secret, lalu klik Lanjutkan.
Langkah 5: Otorisasi di Discord
Di langkah Otorisasi di Discord, klik Lanjutkan. Discord menampilkan permintaan otorisasi untuk aplikasi Anda: terima permintaan tersebut. Macro Deck menyimpan koneksi sebagai Discord dengan nama pengguna Anda di dalam tanda kurung dan mengaktifkan integrasi.
Langkah 6: 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 Discord di sisi kiri dialog Tambah aksi, pilih Bisukan mikrofon, lalu atur Aksi ke Sakelar.
Langkah 7: Tekan tombolnya
Tekan tombol di deck Anda. Discord membisukan mikrofon, dan tombol menampilkan status bisu sampai Anda membunyikannya lagi, dari deck atau di Discord.
Aksi14
Pasang aksi ini di tombol atau jalankan dari alur.
- Bisukan mikrofon
- Membisukan, membunyikan, atau mengalihkan status mikrofon Anda.
- Nonaktifkan suara
- Menonaktifkan suara, mengaktifkannya lagi, atau mengalihkan statusnya.
- Peredam kebisingan standar
- Mengaktifkan atau menonaktifkan peredam kebisingan standar Discord. Tidak dapat mengendalikan Krisp.
- Peredam gema
- Mengaktifkan atau menonaktifkan peredam gema Discord.
- Kontrol gain otomatis
- Mengaktifkan atau menonaktifkan kontrol gain otomatis.
- Atur mode suara
- Beralih antara tekan untuk bicara dan aktivitas suara, atau bergantian di antara keduanya.
- Atur volume mikrofon
- Mengatur, menaikkan, atau menurunkan volume mikrofon Discord.
- Atur volume keluaran
- Mengatur, menaikkan, atau menurunkan volume keluaran Discord, hingga 200%.
- Gabung saluran suara
- Menghubungkan Anda ke saluran suara di salah satu server Anda, secara opsional memindahkan Anda dari saluran lain.
- Tinggalkan saluran suara
- Memutuskan Anda dari saluran suara saat ini.
- Buka saluran teks
- Membuka saluran teks di aplikasi Discord.
- Atur Rich Presence
- Menampilkan aktivitas khusus (bermain, mendengarkan, menonton, atau bertanding) dengan detail, gambar, dan waktu berjalan di profil Anda.
- Hapus Rich Presence
- Menghapus aktivitas yang diatur Macro Deck di profil Anda.
- Jalankan webhook
- Mengirim pesan, secara opsional dengan embed, ke saluran melalui URL webhook. Berfungsi tanpa penyiapan.
Pemicu18
Tombol atau alur dapat bereaksi terhadap peristiwa ini.
- Terhubung
- Macro Deck terhubung ke aplikasi Discord.
- Terputus
- Aplikasi Discord ditutup atau koneksi terputus.
- Mikrofon dibisukan
- Anda membisukan mikrofon sendiri.
- Mikrofon dibunyikan
- Anda membunyikan lagi mikrofon sendiri.
- Suara dinonaktifkan
- Anda menonaktifkan suara sendiri.
- Suara diaktifkan
- Anda mengaktifkan lagi suara sendiri.
- Dibisukan server
- Moderator membisukan Anda.
- Dibunyikan server
- Moderator membunyikan Anda lagi.
- Suara dinonaktifkan server
- Moderator menonaktifkan suara Anda.
- Suara diaktifkan server
- Moderator mengaktifkan lagi suara Anda.
- Mikrofon dibungkam
- Mikrofon Anda berhenti mengirim karena alasan apa pun: dibisukan atau suara dinonaktifkan oleh Anda atau moderator.
- Mikrofon aktif
- Mikrofon Anda dapat mengirim lagi: tidak ada pembisuan maupun penonaktifan suara yang berlaku.
- Bergabung ke Kanal Suara
- Anda bergabung ke saluran suara, secara opsional hanya saluran tertentu.
- Keluar dari Kanal Suara
- Anda meninggalkan saluran suara, secara opsional hanya saluran tertentu.
- Status Koneksi Suara Berubah
- Status koneksi suara Discord berubah, misalnya menjadi
VOICE_CONNECTED, beserta ping rata-rata. - Seseorang mulai berbicara
- Seseorang di saluran suara Anda saat ini mulai berbicara, beserta keterangan apakah itu Anda.
- Seseorang berhenti berbicara
- Seseorang di saluran suara Anda saat ini berhenti berbicara, beserta keterangan apakah itu Anda.
- Notifikasi diterima
- Discord menampilkan notifikasi desktop, beserta judul dan teksnya.
Variabel11
Tampilkan nilai ini di tombol dan widget, atau gunakan dalam kondisi.
discord_is_connected- Apakah Macro Deck terhubung ke aplikasi Discord.
discord_user_name- Nama akun yang terhubung.
discord_is_self_muted,discord_is_self_deafened- Apakah Anda membisukan mikrofon atau menonaktifkan suara sendiri.
discord_is_server_muted,discord_is_server_deafened- Apakah moderator membisukan mikrofon atau menonaktifkan suara Anda.
discord_is_muted,discord_is_deafened- Apakah mikrofon atau suara Anda nonaktif karena alasan apa pun.
discord_is_speaking- Apakah Anda sedang berbicara saat ini.
discord_is_in_voice_channel,discord_voice_channel,discord_voice_server- Apakah Anda berada di saluran suara, serta nama saluran dan servernya.
discord_voice_connection_state,discord_voice_ping- Status koneksi suara dan rata-rata ping-nya dalam milidetik.
discord_input_volume,discord_output_volume- Volume input dan output Discord dalam persen. Anda juga dapat mengaturnya, misalnya dengan slider.
discord_voice_mode- Apakah Discord menggunakan push to talk atau aktivitas suara.
discord_noise_suppression,discord_echo_cancellation,discord_automatic_gain_control- Apakah peredam bising, pembatalan gema, dan kontrol penguatan otomatis aktif.
Pertanyaan yang sering diajukan
Mengapa diperlukan aplikasi Discord sendiri?
Discord hanya memberikan izin untuk mengendalikan klien kepada aplikasi yang timnya Anda ikuti. Aplikasi milik Anda sendiri gratis, dan Macro Deck menggunakan Client ID dan Client Secret-nya hanya untuk otorisasi dengan Discord.
Apakah berfungsi dengan Vesktop, Legcord, atau klien Discord lain?
Tidak. Klien pihak ketiga dapat membagikan aktivitas game, tetapi Macro Deck tidak dapat mengendalikannya. Jalankan aplikasi desktop Discord resmi; klien lain dapat tetap berjalan di sampingnya.
Apakah berfungsi jika Discord berjalan di komputer lain?
Tidak. Macro Deck berkomunikasi dengan Discord melalui koneksi lokal, jadi Discord harus berjalan di komputer yang menjalankan Macro Deck. Hanya Jalankan webhook yang berfungsi tanpa aplikasi Discord.
Penyiapan menyatakan Discord menolak koneksi. Apa masalahnya?
Macro Deck dan Discord berjalan dengan hak akses yang berbeda, misalnya salah satunya dijalankan dengan Run as administrator. Jalankan keduanya dengan cara yang sama dan coba lagi.
Pengaturan suara tidak berubah. Mengapa?
Aplikasi lain yang terhubung ke Discord mungkin sedang memegang pengaturan suara, atau Discord mengabaikan pengaturan suara lanjutan selama Krisp aktif. Tutup aplikasi lain yang mengendalikan Discord, ubah pengaturan itu sekali di pengaturan Voice & Video Discord, lalu jalankan aksi lagi.
Di mana kredensial disimpan?
Client Secret dan token yang dikembalikan Discord disimpan terenkripsi di komputer Anda dan hanya dikirim ke Discord. Jika Discord tidak lagi menerima otorisasi yang tersimpan, integrasi menampilkan Otorisasi Discord kedaluwarsa dengan tombol Hubungkan ulang.
Lainnya di Obrolan dan suara
Webhook Discord
Disertakan dengan Macro DeckKirim pesan kaya dengan embed dan sebutan ke saluran Discord melalui webhook, dengan pratinjau langsung.
SinusBot
Disertakan dengan Macro DeckKendalikan musik instans SinusBot Anda dan tampilkan apa yang diputarnya di deck.