Discord.Net
v3.16.0
Dokumentasi dapat ditemukan di https://docs.discordnet.dev/index.html
Discord.Net adalah proyek sumber terbuka berlisensi MIT yang pengembangannya dimungkinkan sepenuhnya oleh para sukarelawan. Jika Anda ingin mendukung upaya kami secara finansial, harap pertimbangkan:
Versi stabil kami tersedia dari NuGet melalui metapackage Discord.Net:
Masing-masing komponen juga dapat diinstal dari NuGet:
Webhook
Layanan Perintah Teks & Interaksi.
Cakupan API lengkap.
Inti API. Hanya mengimplementasikan fungsionalitas entitas dan barebone.
Nightlies merupakan build Discord.NET yang masih dalam tahap percobaan, dan belum dirilis.
Mereka tersedia melalui 2 sumber berbeda:
Catatan
Paket GitHub memerlukan otentikasi. Anda dapat menemukan informasi lebih lanjut di sini.
.NET Core 1.1 tidak mendukung WebSockets di Win7 dan versi lebih lama. Masalah ini telah diperbaiki sejak rilis .NET Core 2.1. Disarankan untuk menargetkan .NET Core 2.1 atau lebih tinggi untuk proyek Anda jika Anda ingin menjalankan bot pada platform lama; sebagai alternatif, Anda dapat memilih untuk menginstal paket Discord.Net.Providers.WS4Net.
Discord hanya mendukung TLS1.2+ di semua situs web mereka termasuk API sejak 19/07/2022. .NET Framework tidak mendukung protokol ini secara default. Jika Anda bergantung pada .NET Framework, disarankan untuk mengupgrade proyek Anda ke net6-windows . Kerangka kerja ini mendukung sebagian besar fitur khusus windows yang diperkenalkan oleh fx, dan menyelesaikan kesalahan startup dari ketidakcocokan protokol TLS.
Perpustakaan ini umumnya mematuhi Versi Semantik. Paket diterbitkan dalam format versi MAJOR.MINOR.PATCH .
Peningkatan komponen PATCH selalu menunjukkan bahwa perubahan internal saja telah dilakukan, umumnya merupakan perbaikan bug. Perubahan ini tidak akan memengaruhi API yang dapat dilihat publik dengan cara apa pun, dan selalu dijamin kompatibel maju dan mundur dengan basis kode Anda, semua dependensi basis kode Anda yang telah dikompilasi sebelumnya.
Peningkatan komponen MINOR menunjukkan bahwa beberapa penambahan telah dilakukan pada perpustakaan, dan penambahan ini tidak kompatibel dengan versi sebelumnya. Namun, Discord.Net tidak menjamin kompatibilitas ke depan pada penambahan kecil. Dengan kata lain, kami mengizinkan serangkaian perubahan yang dapat menyebabkan gangguan pada versi kecil.
Karena sifat dari Discord API, seringkali kita perlu menambahkan properti ke suatu entitas untuk mendukung perubahan API terbaru. Discord.Net menyediakan antarmuka sebagai metode penggunaan entitas; dan oleh karena itu, memperkenalkan bidang baru ke suatu entitas secara teknis merupakan perubahan besar. Peningkatan versi mayor umumnya menunjukkan beberapa perubahan besar pada perpustakaan, dan oleh karena itu kami ragu untuk mengubah versi mayor untuk setiap penambahan kecil pada perpustakaan. Untuk berkompromi, kami telah memutuskan bahwa antarmuka harus diperlakukan hanya sebagai perangkat habis pakai , dan aplikasi Anda biasanya tidak boleh mengimplementasikan antarmuka.
Untuk aplikasi yang menerapkan antarmuka, seperti dalam pengujian tiruan, kami mohon maaf atas ketidakkonsistenan ini dengan SemVer.
Meskipun kami tidak akan pernah merusak API (di luar perubahan antarmuka) pada build kecil, terkadang kami perlu merusak ABI, dengan memasukkan parameter ke metode untuk mencocokkan perubahan di bagian hulu dengan Discord. Oleh karena itu, peningkatan versi kecil mungkin mengharuskan Anda mengkompilasi ulang kode Anda, dan dependensi, seperti add-on, mungkin juga perlu dikompilasi ulang dan diterbitkan ulang pada versi yang lebih baru. Ketika perubahan pemutusan biner dilakukan, perubahan tersebut akan dicatat dalam catatan rilis.
Peningkatan komponen MAJOR menunjukkan bahwa perubahan besar telah dilakukan pada perpustakaan; konsumen harus memeriksa catatan rilis untuk menentukan perubahan apa yang perlu dilakukan.
Cabang rilis mengikuti Major.Minor. Setelah dirilis, patch akan dikirim ke cabang-cabang ini. Rilis NuGet baru akan ditandai di cabang-cabang ini.
Cabang pengembangan, tersedia di MyGet. Cabang inilah yang menjadi target permintaan tarik.
Cabang yang menargetkan Dev, menambahkan fitur baru. Jangan ragu untuk menjelajahi cabang-cabang ini dan memberikan umpan balik jika diperlukan.
Biasanya menargetkan Dev. Cabang-cabang ini digunakan untuk memperbarui dokumentasi dengan fitur baru atau pengerjaan ulang fitur yang sudah ada.
