Discord.Net

其他类别 2025-08-06


Discord.Net是Discord API(https://discord.com)?*???*?*?官方.NET API包装器。

?文档

可以在https://docs.di*scor**dnet.dev/index.html上找到文档

?支持Discord.Net

Discord.Net是一个由MIT许可的开源项目,其开发完全由志愿者实现。如果您想在财务上支持我们的努力,请考虑:

  • 开放集体
  • Github赞助商
  • 贝宝

?安装

稳定(Nuget)

我们的稳定构建可从Nuget通过Discord.Net Metapackage提供:

  • Discord.Net

单个组件也可以从Nuget安装:

  • Webhooks

    • Discord.Net .webhook
  • 文本命令和交互服务。

    • Discord.Net .commands
    • Discord.Net
  • 完整的API覆盖范围。

    • Discord.Net .websocket
    • Discord.Net .rest
  • API核心。仅实施实体和准则功能。

    • Discord.Net .core

夜生活

夜班是仍处于实验阶段的Discord.Net的构建,尚未发布。
它们可通过2种不同的来源获得:

  • 小袋
  • github软件包

笔记

GitHub软件包需要身份验证。您可以在此处找到更多信息。

?已知问题

WebSocket(Win7和更早)

.NET Core 1.1不支持Win7和更早的Websocket。自从.NET Core 2.1发布以来,此问题已经解决。如果您想在旧平台上运行机器人,建议针对项目目标.NET Core 2.1或更高版本;另外,您可以选择安装Discord.Net .providers.ws4net软件包。

TLS在.NET框架上。

自20122年7月19日以来,不符合所有网站(包括API)仅支持TLS1.2+。 .NET框架默认不支持此协议。如果您依靠.NET框架,建议将您的项目升级到Net6-Windows。该框架支持FX引入的大多数仅限Windows功能,并从TLS协议不匹配中解决了启动错误。

?qureding可以保证

该库通常遵守语义版本。软件包以Major.Minor.Patch版本格式发布。

补丁组件

补丁组件的增量总是表明进行了仅内部更改,通常是一个错误。这些更改不会以任何方式影响公众的API,并且始终保证与您的代码库(任何预编译代码库的依赖性依赖性)向后和向后兼容。

次要组件

次要组件的增量表明在库中增加了一些添加,并且此添加与先前的版本不倒置。但是, Discord.Net不能保证次要添加的前向兼容。换句话说,我们允许在次要版本颠簸上进行有限的破坏变化。

由于Discord API的性质,我们通常需要向实体添加属性以支持最新的API更改。 Discord.Net提供界面作为一种消费实体的方法;因此,从技术上讲,向实体引入新领域是一种破坏性的变化。主要版本的颠簸通常表明了图书馆的一些重大变化,因此,我们不愿为图书馆的每个次要添加而碰到主要版本。为了妥协,我们决定仅将接口仅视为可消耗,并且您的应用程序通常不应实现接口。

对于实现接口的应用程序,例如在测试模拟中,我们对与SEMVER的这种不一致深表歉意。

虽然我们永远不会在次要构建上打破API(在接口更改之外),但我们有时需要通过将参数引入一种方法,以与不偏配上游匹配更改的方法来打破ABI。因此,次要版本的增量可能需要您重新编译代码,并且依赖项(例如addons)也可能需要在较新版本上重新编译和重新编译。当进行二进制破裂变更时,将在发行说明中注明更改。

主要组成部分

主要组件的增加表明对库进行了破坏变化。消费者应检查发行说明,以确定需要进行哪些更改。

分支

Release/xx

释放分支遵循Major.Minor。释放后,贴片将被推到这些分支。新的Nuget版本将在这些分支上标记。

开发

开发分支,可在Myget上找到。该分支是拉力请求的目标。

功能/X

针对开发人员的分支,添加了新功能。随时探索这些分支机构,并在必要时提供反馈。

文档/x

通常是目标开发人员。这些分支用于更新具有新功能或现有功能返工的文档。

下载源码

通过命令行克隆项目:

git clone https://github.com/discord-net/Discord.Net.git