本教程旨在解决 Discord.py 应用命令（斜杠命令）开发中常见的 `Context` 与 `Interaction` 对象混淆问题。我们将详细阐述这两种对象的核心区别，解释为何应用命令必须使用 `Interaction` 对象作为其第一个参数，并提供正确的代码示例及响应机制，确保您的斜杠命令能够正常运行并与用户进行有效交互。
理解 Discord.py 中的命令类型与参数
在 Discord.py 库中，存在两种主要的命令类型：传统的前缀命令（由 commands.Bot 管理）和现代的应用命令，也称为斜杠命令（由 client.tree 管理）。这两种命令在设计哲学和内部实现上有所不同，尤其是在处理命令调用时的第一个参数上。
前缀命令 (Prefix Commands)：当用户输入以特定前缀开头的命令时（例如 !marry @user），Discord.py 会创建一个 discord.ext.commands.Context 对象，其中包含了命令的所有上下文信息，如消息对象、频道、作者、Bot 实例等。命令函数会接收这个 Context 对象作为其第一个参数。
应用命令 (Application Commands / Slash Commands)：当用户通过 Discord 的斜杠菜单选择并执行一个应用命令时（例如 /marry @user），Discord 会发送一个 Interaction 事件给 Bot。Discord.py 随后会封装这个事件，并创建一个 discord.interactions.Interaction 对象。这个 Interaction 对象包含了关于该次交互的所有信息，如交互类型、用户、频道、命令名称等。应用命令函数必须接收这个 Interaction 对象作为其第一个参数。
Context 与 Interaction 的核心区别
尽管 Context 和 Interaction 都提供了命令执行的上下文信息，但它们是完全不同的对象类型，拥有不同的属性和方法。
来源用户发送的普通消息Discord 客户端触发的应用命令交互第一个参数通常命名为 ctx通常命名为 interaction获取作者ctx.authorinteraction.user发送回复await ctx.reply(…)
await ctx.send(…)await interaction.response.send_message(…)后续消息await ctx.send(…)await interaction.followup.send(…)对象类型discord.ext.commands.Contextdiscord.interactions.Interaction
混淆这两种对象是导致应用命令无法正常工作或报错的常见原因。
常见错误示例与分析
考虑以下一个尝试创建斜杠命令的示例代码：
import discordfrom discord.ext import commandsimport asyncioimport configure # 假设 configure 模块包含 token 和 nameintents = discord.Intents.all()BOT_TOKEN = configure.config["token"]client = commands.Bot(intents=intents, command_prefix="/") # command_prefix 在这里对斜杠命令无效，但对Bot实例创建是必需的@client.eventasync def on_ready(): print("Online") try: synced = await client.tree.sync() print(f"Synced {len(synced)} commands") except Exception as e: print(e)@client.tree.command(name='marry', description="Suggest to marry")async def marry(ctx, user: discord.Member): # 错误：这里应该是 interaction print(f'{ctx}||{user}') # 错误：Interaction 对象没有 .reply() 方法 ctx.reply(f'{ctx.author} make a proposal to marry {user}') returnasync def main(): await client.start(BOT_TOKEN)asyncio.run(main())
当执行 /marry @rayanutka 命令时，print(f'{ctx}||{user}’) 的输出会是 discord.interactions.Interaction object at 0x…||rayanutka。这明确指出，ctx 变量实际上是一个 Interaction 对象，而不是 Context 对象。因此，尝试调用 ctx.reply() 方法会导致运行时错误，因为 Interaction 对象没有名为 reply 的直接方法。
另一个常见的错误尝试是向 client.tree.command 装饰器传递非法的关键字参数，例如 contextlib = True：
@client.tree.command(name='marry', description="Suggest to marry", contextlib = True) # 错误：contextlib 不是有效参数async def marry(ctx, user: discord.Member): # ...
这会立即引发 TypeError: CommandTree.command() got an unexpected keyword argument ‘contextlib’。这是因为 CommandTree.command() 装饰器只接受预定义的参数，而 contextlib 并非其中之一。
正确处理应用命令中的 Interaction 对象
要正确地处理应用命令，您需要将命令函数中的第一个参数定义为 Interaction 对象，并使用 Interaction 对象提供的方法来响应。
以下是修正后的代码示例：
import discordfrom discord.ext import commandsimport asyncioimport configure # 假设 configure 模块包含 token 和 nameintents = discord.Intents.all()BOT_TOKEN = configure.config["token"]# 创建 Bot 实例。command_prefix 对于斜杠命令不是必需的，但通常需要指定client = commands.Bot(intents=intents, command_prefix="!") # 可以是任意前缀，只要不为空@client.eventasync def on_ready(): print("Bot is Online") try: # 同步斜杠命令到 Discord synced = await client.tree.sync() print(f"Synced {len(synced)} commands globally") except Exception as e: print(f"Error syncing commands: {e}")@client.tree.command(name='marry', description="Suggest to marry someone")async def marry(interaction: discord.Interaction, user: discord.Member): # 正确：第一个参数是 Interaction print(f'Interaction received from {interaction.user} in {interaction.channel} for {user}') # 使用 interaction.response.send_message() 来发送初始回复 # interaction.user 获取发起交互的用户，而不是 interaction.author # 注意：必须使用 await 关键字，因为这是异步操作 await interaction.response.send_message( f'{interaction.user.mention} make a proposal to marry {user.mention}' ) # 如果需要发送后续消息，可以使用 interaction.followup.send() # await interaction.followup.send("This is a follow-up message!") returnasync def main(): # 可以在这里添加 setup 逻辑，例如加载 Cog await client.start(BOT_TOKEN)if __name__ == "__main__": asyncio.run(main())
关键修正点：
参数类型更改：将命令函数的第一个参数从 ctx 改为 interaction，并明确其类型为 discord.Interaction。回复机制：不再使用 ctx.reply()。对于应用命令的初始回复，必须通过 interaction.response.send_message() 方法。interaction.response 是一个 InteractionResponse 对象，它提供了多种响应交互的方法。获取命令发起者：使用 interaction.user 来获取执行命令的用户对象，而不是 interaction.author。异步操作：send_message 是一个协程，因此必须使用 await 关键字来等待其完成。
注意事项
初始回复的重要性：Discord 对应用命令的响应有严格的时间限制（通常为 3 秒）。您必须在规定时间内通过 interaction.response 发送一个初始回复（例如 send_message、defer 等），否则命令会被标记为失败。后续消息：如果您的命令需要发送多条消息，或者在初始回复后进行耗时操作，您可以使用 interaction.response.defer() 来“推迟”回复，然后使用 interaction.followup.send() 来发送实际消息。错误处理：在实际应用中，您应该为命令添加适当的错误处理机制，以优雅地处理可能出现的异常。文档查阅：始终建议查阅 Discord.py 的官方文档，特别是关于 discord.interactions.Interaction 和 discord.app_commands 的部分，以获取最新和最详细的信息。
总结
Discord.py 的应用命令（斜杠命令）与传统前缀命令在处理上下文信息时使用了不同的对象模型。核心在于，应用命令函数接收的是 discord.interactions.Interaction 对象，而非 discord.ext.commands.Context 对象。
以上就是Discord.py 应用命令：深入理解 Interaction 对象的使用的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1381823.html
微信扫一扫 
支付宝扫一扫 
