终极 Discord.Net 应用命令开发指南从零开始掌握斜杠命令【免费下载链接】Discord.NetAn unofficial .Net wrapper for the Discord API (https://discord.com/)项目地址: https://gitcode.com/gh_mirrors/di/Discord.NetDiscord.Net 是一个强大的 .NET API 包装器专门用于 Discord 平台开发。本文将为您提供完整的 Discord.Net 应用命令开发教程涵盖从基础概念到高级功能的全面指南。无论您是 Discord 机器人开发的新手还是希望提升技能的有经验开发者这篇指南都将帮助您快速掌握 Discord 应用命令的核心开发技术。 什么是 Discord 应用命令Discord 应用命令是现代 Discord 机器人交互的核心机制主要包括三种类型斜杠命令、用户上下文菜单命令和消息上下文菜单命令。斜杠命令通过/触发包含名称、描述和参数选项上下文菜单命令则通过右键点击用户或消息访问。这些命令可以注册为全局命令在所有服务器中可用或特定服务器命令。图配置 Discord 应用命令所需的 OAuth2 权限范围 快速开始创建第一个斜杠命令1. 安装 Discord.Net 包首先通过 NuGet 安装 Discord.Net 的核心包Install-Package Discord.Net Install-Package Discord.Net.WebSocket Install-Package Discord.Net.Interactions2. 配置 OAuth2 权限要让您的机器人使用应用命令必须在 Discord 开发者门户的 OAuth2 页面选择applications.commands权限范围。这是使用斜杠命令的前提条件。3. 创建基础斜杠命令使用 Discord.Net 的SlashCommandBuilder创建您的第一个命令var guildCommand new SlashCommandBuilder(); guildCommand.WithName(hello); guildCommand.WithDescription(这是我的第一个斜杠命令); await guild.CreateApplicationCommandAsync(guildCommand.Build());️ Discord.Net 交互服务框架Discord.Net 提供了强大的InteractionService框架让应用命令开发变得更加简单和结构化。该框架采用基于属性的命令定义方式大大简化了开发流程。核心模块结构所有交互模块必须继承自InteractionModuleBaseT基类其中 T 是交互上下文类型public class ExampleModule : InteractionModuleBaseSocketInteractionContext { [SlashCommand(ping, 检查机器人延迟)] public async Task PingAsync() { await RespondAsync($ 延迟{Context.Client.Latency}ms); } }命令类型概览命令类型返回类型最大参数数允许的参数类型属性斜杠命令Task/Task25多种类型[SlashCommand]用户命令Task/Task1IUser 实现[UserCommand]消息命令Task/Task1IMessage 实现[MessageCommand]组件交互Task/Task无限string 或 string[][ComponentInteraction] 斜杠命令参数详解斜杠命令支持丰富的参数类型让您能够创建功能强大的交互体验基本参数类型[SlashCommand(echo, 重复输入的内容)] public async Task Echo( string echo, [Summary(description: 是否提及用户)] bool mention false) { await RespondAsync(echo (mention ? Context.User.Mention : string.Empty)); }通道类型限制使用[ChannelTypes]属性限制参数接受的通道类型[SlashCommand(bitrate, 获取语音通道的比特率)] public async Task GetBitrateAsync( [ChannelTypes(ChannelType.Voice, ChannelType.Stage)] IChannel channel) { await RespondAsync($此语音通道的比特率为{(channel as IVoiceChannel).Bitrate}); }枚举和选择项枚举会自动转换为多选选项public enum ExampleEnum { 选项一, 选项二, 选项三 } [SlashCommand(choice, 枚举选择示例)] public async Task ChoiceExample(ExampleEnum input) await RespondAsync($您选择了{input});图用户与斜杠命令的交互界面展示参数选择和自动完成功能 高级功能组件交互和模态按钮交互处理[ComponentInteraction(musicSelect:*,*)] public async Task ButtonPress(string id, string name) { await RespondAsync($正在播放{name}/{id}); }下拉菜单处理[ComponentInteraction(roleSelect)] public async Task RoleSelect(string[] selections) { foreach (var roleId in selections) { // 处理选择的角色 } await RespondAsync(角色选择已更新); }模态表单模态允许收集复杂的用户输入public class MyModal : IModal { public string Title 反馈表单; [InputLabel(您的姓名)] [ModalTextInput(name, placeholder: 请输入您的姓名)] public string Name { get; set; } [InputLabel(反馈内容)] [ModalTextInput(feedback, TextInputStyle.Paragraph)] public string Feedback { get; set; } } [SlashCommand(feedback, 提交反馈)] public async Task FeedbackCommand() { await RespondWithModalAsyncMyModal(feedback_modal); }图Discord 模态表单用于收集复杂的用户输入 模块分组和依赖注入命令分组使用[Group]属性创建命令组[Group(admin, 管理员命令)] public class AdminModule : InteractionModuleBaseSocketInteractionContext { [SlashCommand(ban, 封禁用户)] public async Task BanUser(IUser user, string reason 违反规则) { // 封禁逻辑 await RespondAsync($已封禁用户 {user.Username}); } }依赖注入支持Discord.Net 支持构造函数注入和属性注入public class ExampleModule : InteractionModuleBaseSocketInteractionContext { // 属性注入 public InteractionService Commands { get; set; } // 构造函数注入 private readonly DatabaseService _database; public ExampleModule(DatabaseService database) { _database database; } [SlashCommand(stats, 获取统计数据)] public async Task GetStatsAsync() { var stats await _database.GetStatisticsAsync(); await RespondAsync($统计数据{stats}); } } 命令注册和执行流程初始化交互服务var interactionService new InteractionService(client.Rest); await interactionService.AddModulesAsync(Assembly.GetEntryAssembly());注册命令到 Discord// 注册全局命令 await interactionService.RegisterCommandsGloballyAsync(); // 或注册到特定服务器 var guild client.GetGuild(guildId); await interactionService.RegisterCommandsToGuildAsync(guild.Id);处理交互事件client.InteractionCreated async interaction { var ctx new SocketInteractionContext(client, interaction); await interactionService.ExecuteCommandAsync(ctx, serviceProvider); };图机器人对斜杠命令的丰富响应包含按钮和下拉菜单等交互组件 最佳实践和性能优化1. 命令命名规范使用小写字母和连字符名称长度在 3-32 个字符之间遵循^[\w-]{3,32}$正则表达式2. 性能优化技巧启用UseCompiledLambda以提升执行速度使用适当的RunMode配置Async 或 Sync避免在命令中执行长时间运行的操作3. 错误处理[SlashCommand(divide, 除法计算)] public async Task DivideAsync(double a, double b) { if (b 0) { await RespondAsync(错误除数不能为零, ephemeral: true); return; } await RespondAsync($结果{a / b}); } 学习资源官方文档Discord.Net 官方文档斜杠命令指南交互服务框架示例项目查看 samples/InteractionFramework 目录中的完整示例代码了解实际应用场景。 总结Discord.Net 的应用命令开发框架提供了强大而灵活的工具集让您能够创建功能丰富的 Discord 机器人交互体验。通过本文的指南您应该已经掌握了从基础命令创建到高级功能实现的核心概念。记住实践是最好的学习方式。从简单的/ping命令开始逐步尝试更复杂的功能如参数验证、组件交互和模态表单。随着经验的积累您将能够创建出真正出色的 Discord 机器人应用。现在开始您的 Discord 机器人开发之旅吧【免费下载链接】Discord.NetAn unofficial .Net wrapper for the Discord API (https://discord.com/)项目地址: https://gitcode.com/gh_mirrors/di/Discord.Net创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
终极 Discord.Net 应用命令开发指南：从零开始掌握斜杠命令
终极 Discord.Net 应用命令开发指南从零开始掌握斜杠命令【免费下载链接】Discord.NetAn unofficial .Net wrapper for the Discord API (https://discord.com/)项目地址: https://gitcode.com/gh_mirrors/di/Discord.NetDiscord.Net 是一个强大的 .NET API 包装器专门用于 Discord 平台开发。本文将为您提供完整的 Discord.Net 应用命令开发教程涵盖从基础概念到高级功能的全面指南。无论您是 Discord 机器人开发的新手还是希望提升技能的有经验开发者这篇指南都将帮助您快速掌握 Discord 应用命令的核心开发技术。 什么是 Discord 应用命令Discord 应用命令是现代 Discord 机器人交互的核心机制主要包括三种类型斜杠命令、用户上下文菜单命令和消息上下文菜单命令。斜杠命令通过/触发包含名称、描述和参数选项上下文菜单命令则通过右键点击用户或消息访问。这些命令可以注册为全局命令在所有服务器中可用或特定服务器命令。图配置 Discord 应用命令所需的 OAuth2 权限范围 快速开始创建第一个斜杠命令1. 安装 Discord.Net 包首先通过 NuGet 安装 Discord.Net 的核心包Install-Package Discord.Net Install-Package Discord.Net.WebSocket Install-Package Discord.Net.Interactions2. 配置 OAuth2 权限要让您的机器人使用应用命令必须在 Discord 开发者门户的 OAuth2 页面选择applications.commands权限范围。这是使用斜杠命令的前提条件。3. 创建基础斜杠命令使用 Discord.Net 的SlashCommandBuilder创建您的第一个命令var guildCommand new SlashCommandBuilder(); guildCommand.WithName(hello); guildCommand.WithDescription(这是我的第一个斜杠命令); await guild.CreateApplicationCommandAsync(guildCommand.Build());️ Discord.Net 交互服务框架Discord.Net 提供了强大的InteractionService框架让应用命令开发变得更加简单和结构化。该框架采用基于属性的命令定义方式大大简化了开发流程。核心模块结构所有交互模块必须继承自InteractionModuleBaseT基类其中 T 是交互上下文类型public class ExampleModule : InteractionModuleBaseSocketInteractionContext { [SlashCommand(ping, 检查机器人延迟)] public async Task PingAsync() { await RespondAsync($ 延迟{Context.Client.Latency}ms); } }命令类型概览命令类型返回类型最大参数数允许的参数类型属性斜杠命令Task/Task25多种类型[SlashCommand]用户命令Task/Task1IUser 实现[UserCommand]消息命令Task/Task1IMessage 实现[MessageCommand]组件交互Task/Task无限string 或 string[][ComponentInteraction] 斜杠命令参数详解斜杠命令支持丰富的参数类型让您能够创建功能强大的交互体验基本参数类型[SlashCommand(echo, 重复输入的内容)] public async Task Echo( string echo, [Summary(description: 是否提及用户)] bool mention false) { await RespondAsync(echo (mention ? Context.User.Mention : string.Empty)); }通道类型限制使用[ChannelTypes]属性限制参数接受的通道类型[SlashCommand(bitrate, 获取语音通道的比特率)] public async Task GetBitrateAsync( [ChannelTypes(ChannelType.Voice, ChannelType.Stage)] IChannel channel) { await RespondAsync($此语音通道的比特率为{(channel as IVoiceChannel).Bitrate}); }枚举和选择项枚举会自动转换为多选选项public enum ExampleEnum { 选项一, 选项二, 选项三 } [SlashCommand(choice, 枚举选择示例)] public async Task ChoiceExample(ExampleEnum input) await RespondAsync($您选择了{input});图用户与斜杠命令的交互界面展示参数选择和自动完成功能 高级功能组件交互和模态按钮交互处理[ComponentInteraction(musicSelect:*,*)] public async Task ButtonPress(string id, string name) { await RespondAsync($正在播放{name}/{id}); }下拉菜单处理[ComponentInteraction(roleSelect)] public async Task RoleSelect(string[] selections) { foreach (var roleId in selections) { // 处理选择的角色 } await RespondAsync(角色选择已更新); }模态表单模态允许收集复杂的用户输入public class MyModal : IModal { public string Title 反馈表单; [InputLabel(您的姓名)] [ModalTextInput(name, placeholder: 请输入您的姓名)] public string Name { get; set; } [InputLabel(反馈内容)] [ModalTextInput(feedback, TextInputStyle.Paragraph)] public string Feedback { get; set; } } [SlashCommand(feedback, 提交反馈)] public async Task FeedbackCommand() { await RespondWithModalAsyncMyModal(feedback_modal); }图Discord 模态表单用于收集复杂的用户输入 模块分组和依赖注入命令分组使用[Group]属性创建命令组[Group(admin, 管理员命令)] public class AdminModule : InteractionModuleBaseSocketInteractionContext { [SlashCommand(ban, 封禁用户)] public async Task BanUser(IUser user, string reason 违反规则) { // 封禁逻辑 await RespondAsync($已封禁用户 {user.Username}); } }依赖注入支持Discord.Net 支持构造函数注入和属性注入public class ExampleModule : InteractionModuleBaseSocketInteractionContext { // 属性注入 public InteractionService Commands { get; set; } // 构造函数注入 private readonly DatabaseService _database; public ExampleModule(DatabaseService database) { _database database; } [SlashCommand(stats, 获取统计数据)] public async Task GetStatsAsync() { var stats await _database.GetStatisticsAsync(); await RespondAsync($统计数据{stats}); } } 命令注册和执行流程初始化交互服务var interactionService new InteractionService(client.Rest); await interactionService.AddModulesAsync(Assembly.GetEntryAssembly());注册命令到 Discord// 注册全局命令 await interactionService.RegisterCommandsGloballyAsync(); // 或注册到特定服务器 var guild client.GetGuild(guildId); await interactionService.RegisterCommandsToGuildAsync(guild.Id);处理交互事件client.InteractionCreated async interaction { var ctx new SocketInteractionContext(client, interaction); await interactionService.ExecuteCommandAsync(ctx, serviceProvider); };图机器人对斜杠命令的丰富响应包含按钮和下拉菜单等交互组件 最佳实践和性能优化1. 命令命名规范使用小写字母和连字符名称长度在 3-32 个字符之间遵循^[\w-]{3,32}$正则表达式2. 性能优化技巧启用UseCompiledLambda以提升执行速度使用适当的RunMode配置Async 或 Sync避免在命令中执行长时间运行的操作3. 错误处理[SlashCommand(divide, 除法计算)] public async Task DivideAsync(double a, double b) { if (b 0) { await RespondAsync(错误除数不能为零, ephemeral: true); return; } await RespondAsync($结果{a / b}); } 学习资源官方文档Discord.Net 官方文档斜杠命令指南交互服务框架示例项目查看 samples/InteractionFramework 目录中的完整示例代码了解实际应用场景。 总结Discord.Net 的应用命令开发框架提供了强大而灵活的工具集让您能够创建功能丰富的 Discord 机器人交互体验。通过本文的指南您应该已经掌握了从基础命令创建到高级功能实现的核心概念。记住实践是最好的学习方式。从简单的/ping命令开始逐步尝试更复杂的功能如参数验证、组件交互和模态表单。随着经验的积累您将能够创建出真正出色的 Discord 机器人应用。现在开始您的 Discord 机器人开发之旅吧【免费下载链接】Discord.NetAn unofficial .Net wrapper for the Discord API (https://discord.com/)项目地址: https://gitcode.com/gh_mirrors/di/Discord.Net创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
