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
通常是目标开发人员。这些分支用于更新具有新功能或现有功能返工的文档。
