Discord.Net 开发指南：深入理解消息组件中的选择菜单

原创于 2025-06-11 09:15:31 发布 · 248 阅读

CC 4.0 BY-SA版权

Discord.Net 开发指南：深入理解消息组件中的选择菜单

Discord.Net An unofficial .Net wrapper for the Discord API (https://discord.com/) 项目地址: https://gitcode.com/gh_mirrors/di/Discord.Net

选择菜单概述

在 Discord.Net 中，选择菜单(Select Menus)是一种强大的交互组件，它允许用户从预定义的选项列表中进行选择。这种组件特别适合用于配置命令、问卷调查或任何需要用户从多个选项中选择的场景。

选择菜单的基本构建

要创建一个选择菜单，我们需要使用 SelectMenuBuilder 类。这个构建器提供了多种方法来配置菜单的各种属性：

var menuBuilder = new SelectMenuBuilder()
    .WithPlaceholder("请选择一个选项")  // 未选择时的占位文本
    .WithCustomId("menu-1")          // 自定义ID，用于识别菜单
    .WithMinValues(1)                // 最少选择项数
    .WithMaxValues(1)                // 最多选择项数
    .AddOption("选项A", "opt-a", "选项B在说谎！")  // 添加选项
    .AddOption("选项B", "opt-b", "选项A在说真话！");

构建完成后，我们需要将其添加到组件构建器中：

var builder = new ComponentBuilder()
    .WithSelectMenu(menuBuilder);

将选择菜单集成到命令中

让我们看一个完整的命令示例，该命令会发送一个包含选择菜单的消息：

[Command("选择测试")]
public async Task SelectTest()
{
    var menuBuilder = new SelectMenuBuilder()
        .WithPlaceholder("请选择一个选项")
        .WithCustomId("menu-1")
        .WithMinValues(1)
        .WithMaxValues(1)
        .AddOption("选项A", "opt-a", "选项B在说谎！")
        .AddOption("选项B", "opt-b", "选项A在说真话！");

    var builder = new ComponentBuilder()
        .WithSelectMenu(menuBuilder);

    await ReplyAsync("谁在说谎？", components: builder.Build());
}

执行这个命令后，用户将看到一个带有下拉选择菜单的消息。

处理用户选择

当用户与选择菜单交互时，我们需要处理他们的选择。可以通过订阅 SelectMenuExecuted 事件来实现：

client.SelectMenuExecuted += MyMenuHandler;

事件处理程序接收一个 SocketMessageComponent 参数，其中包含了用户的选择信息：

public async Task MyMenuHandler(SocketMessageComponent arg)
{
    // 获取用户选择的所有值
    var selections = string.Join(", ", arg.Data.Values);
    
    // 响应选择结果
    await arg.RespondAsync($"您选择了: {selections}");
}

高级用法

多选菜单

通过调整 WithMinValues 和 WithMaxValues 参数，可以创建允许多选的菜单：

.WithMinValues(1)
.WithMaxValues(3)  // 允许最多选择3个选项

选项分组

虽然 Discord.Net 目前不直接支持选项分组，但可以通过添加分隔符选项来模拟分组效果：

.AddOption("─── 第一组 ───", "divider-1", "这是第一组选项", isDefault: true)
.AddOption("选项1", "option-1")
.AddOption("选项2", "option-2")
.AddOption("─── 第二组 ───", "divider-2", "这是第二组选项", isDefault: true)
.AddOption("选项3", "option-3")

动态更新菜单

可以根据用户的选择动态更新菜单内容：

public async Task MyMenuHandler(SocketMessageComponent arg)
{
    if(arg.Data.Values.Contains("opt-a"))
    {
        // 创建新菜单
        var newMenu = new SelectMenuBuilder()
            .WithCustomId("menu-2")
            .AddOption("子选项1", "sub-1")
            .AddOption("子选项2", "sub-2");
            
        // 更新消息
        await arg.UpdateAsync(x => x.Components = new ComponentBuilder()
            .WithSelectMenu(newMenu)
            .Build());
    }
}