Discord.js指南：深入理解上下文菜单交互开发-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00933/article/details/148971866

Discord.js指南：深入理解上下文菜单交互开发

guide The official guide for discord.js, created and maintained by core members of its community. 项目地址: https://gitcode.com/gh_mirrors/guide/guide

什么是上下文菜单

上下文菜单是Discord平台提供的一种特殊交互方式，当用户在消息或用户上右键点击时，会在"Apps"子菜单中显示可执行的命令选项。在Discord.js中，这种功能被称为"Context Menus"（上下文菜单）。

上下文菜单分为两种类型：

用户上下文菜单：针对特定用户触发的菜单项
消息上下文菜单：针对特定消息触发的菜单项

上下文菜单的注册

要创建上下文菜单，我们需要使用ContextMenuCommandBuilder类。这个构建器允许我们定义菜单的基本属性和类型。

const { ContextMenuCommandBuilder, ApplicationCommandType } = require('discord.js');

// 创建用户上下文菜单
const userContextMenu = new ContextMenuCommandBuilder()
    .setName('查看用户信息')
    .setType(ApplicationCommandType.User);

// 创建消息上下文菜单
const messageContextMenu = new ContextMenuCommandBuilder()
    .setName('分析消息内容')
    .setType(ApplicationCommandType.Message);

关键点说明：

setName()方法设置菜单项显示的名称
setType()方法确定菜单类型，可以是ApplicationCommandType.User或ApplicationCommandType.Message

处理上下文菜单交互

当用户触发上下文菜单时，你的应用会收到一个交互事件。处理方式与处理斜杠命令类似，但需要特别注意区分不同类型的上下文菜单。

client.on('interactionCreate', interaction => {
    // 检查是否是用户上下文菜单
    if (interaction.isUserContextMenuCommand()) {
        console.log('用户上下文菜单被触发');
        handleUserContextMenu(interaction);
    }
    
    // 检查是否是消息上下文菜单
    if (interaction.isMessageContextMenuCommand()) {
        console.log('消息上下文菜单被触发');
        handleMessageContextMenu(interaction);
    }
});

获取上下文数据

上下文菜单的核心价值在于它能够提供上下文相关的数据。根据不同类型的菜单，我们可以获取不同的信息。

用户上下文菜单数据获取

function handleUserContextMenu(interaction) {
    // 获取目标用户
    const user = interaction.targetUser;
    // 如果是服务器成员，还可以获取成员对象
    const member = interaction.targetMember;
    
    console.log(`选中的用户: ${user.username}`);
    if (member) {
        console.log(`用户在服务器中的昵称: ${member.nickname}`);
    }
}

消息上下文菜单数据获取

function handleMessageContextMenu(interaction) {
    // 获取目标消息
    const message = interaction.targetMessage;
    
    console.log(`消息内容: ${message.content}`);
    console.log(`发送者: ${message.author.username}`);
    console.log(`发送时间: ${message.createdAt}`);
}

响应上下文菜单

响应上下文菜单的方式与响应斜杠命令完全相同，可以使用以下几种方式：

即时响应：使用interaction.reply()
延迟响应：先使用interaction.deferReply()，稍后再编辑响应
更新响应：使用interaction.editReply()
跟随响应：使用interaction.followUp()

async function handleUserContextMenu(interaction) {
    await interaction.reply({
        content: `您选择了用户: ${interaction.targetUser.username}`,
        ephemeral: true // 设置为仅对触发用户可见
    });
}