2 menit baca
Oleh Mike
Gateway Intents Discord: Apa yang Boleh Didengar Bot
Gateway intents adalah opsi yang dinyatakan bot saat terhubung, yang memberi tahu Discord kelompok peristiwa langsung mana yang ingin diterimanya. Bot yang tidak meminta suatu intent tidak akan pernah mendengar peristiwa tersebut, yang menjaga data tetap privat dan lalu lintas tetap kecil.
Apa itu gateway
Bot menjaga koneksi konstan ke Discord, yang disebut gateway. Lewat koneksi itu Discord mendorong peristiwa saat terjadi: pesan dikirim, anggota bergabung, seseorang mulai mengetik, channel voice berubah. Tanpa batasan, setiap bot akan menerima setiap peristiwa dari setiap server.
Intent adalah filternya. Dalam pesan pertama yang dikirim bot setelah terhubung, bot mencantumkan intent yang diinginkan sebagai satu angka. Discord kemudian hanya mengirim peristiwa yang cocok.
Intent yang umum
- Guilds: server, channel, dan peran yang dibuat atau diubah. Hampir setiap bot memakainya.
- Guild messages: pesan di channel server. Teks pesan tersebut membutuhkan intent istimewa, lihat di bawah.
- Guild voice states: siapa yang bergabung atau keluar dari channel voice. Alat musik dan voice membutuhkannya.
- Guild moderation: ban dan entri audit log.
- Guild message reactions: reaksi yang ditambahkan atau dihapus.
Tiga intent bersifat khusus: presence, server members, dan message content. Ketiganya adalah intent istimewa, karena mengungkap lebih banyak data pribadi dan membutuhkan persetujuan tambahan untuk bot yang lebih besar.
Mengapa ini penting bagi pemilik server
Saat bot online tetapi mengabaikan pesan, bergabung, atau perubahan voice, intent yang hilang adalah penyebab umum. Ini juga bisa menjelaskan pemutusan dengan kode error 4014 saat bot meminta intent istimewa yang tidak diaktifkan di pengaturannya. Artikel tentang error gateway bot offline 4004 dan 4014 membahasnya.
Intent juga merupakan sinyal privasi. Bot yang hanya meminta apa yang dibutuhkan fiturnya lebih mudah dipercaya.
Intent dan Noxyr
Bot Noxyr utama dikelola untuk Anda. Jika Anda mengatur bot kustom dengan aplikasi Anda sendiri, Server Members Intent dan Message Content Intent harus diaktifkan di Discord Developer Portal, seperti dijelaskan dalam panduan pengaturan. Keduanya dibutuhkan untuk fitur seperti pesan sambutan dan perintah prefix. Jika bot kustom offline, mulailah dengan panduan bot offline.
Untuk detail lebih lanjut, lihat intent gateway istimewa dijelaskan.
Memeriksa bot yang tidak Anda tulis
Jika bot yang Anda pasang berperilaku aneh, tanyakan kepada pengembangnya intent apa yang dipakainya dan mengapa. Bot yang baik mencantumkannya di dokumennya. Untuk bot Anda sendiri, buka Developer Portal, masuk ke halaman Bot, dan bandingkan sakelarnya dengan yang diminta kode. Ketidakcocokan adalah hal pertama yang harus diperbaiki.
Pertanyaan umum
Apa yang terjadi jika bot tidak meminta suatu intent?
Discord tidak mengirim peristiwa yang cocok kepadanya. Bot tetap online tetapi tidak bisa bereaksi terhadap hal-hal tersebut.
Di mana saya mengaktifkan intent untuk bot saya sendiri?
Di Discord Developer Portal, buka aplikasi Anda, masuk ke Bot, dan aktifkan intent istimewa yang dibutuhkannya.
Apakah semua intent bersifat istimewa?
Tidak. Hanya presence, server members, dan message content yang istimewa. Yang lain bisa dipakai dengan bebas.
