
本文深入探讨 discord.py 中按钮交互时常见的“interaction error”问题,主要源于按钮回调函数签名不正确。教程将详细解释正确的按钮回调机制,通过代码示例演示如何修正错误,并提供在按钮交互中安全、高效地传递上下文数据(如原始命令的调用者或目标用户)的最佳实践,确保您的机器人能够稳定处理用户交互。
Discord.py 2.0 及更高版本引入的 UI 组件(如按钮、下拉菜单)极大地增强了机器人与用户的交互能力。当用户点击一个按钮时,Discord 会向您的机器人发送一个交互事件,触发与该按钮关联的异步回调函数。然而,如果这个回调函数的签名不符合预期,就会导致 Discord 客户端显示“interaction error”。
对于 discord.ui.Button 的回调函数,其标准签名应为 async def callback_name(self, interaction: discord.Interaction, button: discord.ui.Button)。这意味着回调函数预期接收三个参数:
任何额外的位置参数,例如直接在回调函数签名中添加 user: discord.Member,都会导致 Discord.py 无法正确解析传入的交互事件,从而引发“interaction error”。
考虑以下一个尝试实现“求婚系统”的示例代码片段,其中按钮回调函数被错误地定义:
import discord
from discord.ext import commands
# ... (client setup omitted for brevity) ...
class MarryButtons(discord.ui.View):
def __init__(self):
super().__init__()
@discord.ui.button(label="Yes", style=discord.ButtonStyle.success)
async def agree_btn(self, interaction: discord.Interaction, button: discord.ui.Button, user: discord.Member):
# 错误:user: discord.Member 是多余的参数
# ...
pass
@discord.ui.button(label="No", style=discord.ButtonStyle.danger)
async def disagree_btn(self, interaction: discord.Interaction, button: discord.ui.Button, user: discord.Member):
# 错误:user: discord.Member 是多余的参数
# ...
pass
# ... (marry command omitted for brevity) ...在上述代码中,agree_btn 和 disagree_btn 回调函数中都额外添加了 user: discord.Member 参数。当用户点击这些按钮时,Discord.py 尝试调用这些函数,但由于签名不匹配,无法将 discord.Member 对象传递给 user 参数,从而触发了“interaction error”。
要解决这个问题,只需移除回调函数签名中多余的参数,使其符合标准格式:
import discord
from discord.ext import commands
# ... (client setup omitted for brevity) ...
class MarryButtons(discord.ui.View):
def __init__(self):
super().__init__()
@discord.ui.button(label="Yes", style=discord.ButtonStyle.success)
async def agree_btn(self, interaction: discord.Interaction, button: discord.ui.Button):
# 现在签名是正确的
# ... 可以在这里处理逻辑 ...
pass
@discord.ui.button(label="No", style=discord.ButtonStyle.danger)
async def disagree_btn(self, interaction: discord.Interaction, button: discord.ui.Button):
# 现在签名是正确的
# ... 可以在这里处理逻辑 ...
pass
# ...虽然移除了多余的参数解决了交互错误,但我们通常需要在按钮回调中访问创建按钮时的一些上下文信息,例如发起求婚的用户和被求婚的用户。直接将这些信息作为回调参数是不允许的,正确的做法是将这些数据作为 discord.ui.View 实例的属性进行存储。
以下是实现上下文数据传递的步骤:
import discord
from discord.ext import commands
import os
# 1. 初始化 Bot 客户端
intents = discord.Intents.default()
intents.message_content = True # 允许读取消息内容,尽管这里主要使用斜杠命令
intents.members = True # 允许获取成员信息,用于处理用户对象
client = commands.Bot(command_prefix='!', intents=intents)
# 2. Bot 启动事件
@client.event
async def on_ready():
print(f'Bot 已登录为 {client.user} (ID: {client.user.id})')
try:
# 同步斜杠命令到 Discord
synced = await client.tree.sync()
print(f"已同步 {len(synced)} 条斜杠命令")
except Exception as e:
print(f"同步命令失败: {e}")
# 3. 定义按钮视图类
class MarryButtons(discord.ui.View):
def __init__(self, proposer: discord.Member, target_user: discord.Member):
super().__init__(timeout=180) # 设置视图超时时间为 3 分钟
self.proposer = proposer
self.target_user = target_user
self.message = None # 用于在超时时编辑原消息
async def on_timeout(self):
# 当视图超时时执行
if self.message:
embed_timeout = discord.Embed(
title="求婚超时",
description=f"{self.proposer.mention} 对 {self.target_user.mention} 的求婚已超时,未得到回应。",
color=discord.Color.orange()
)
await self.message.edit(embed=embed_timeout, view=None)
else:
# 如果某种原因消息不可用,可以尝试发送一条新消息
print("警告: 无法在超时时编辑消息,消息对象未设置。")
@discord.ui.button(label="接受", style=discord.ButtonStyle.success)
async def agree_btn(self, interaction: discord.Interaction, button: discord.ui.Button):
# 确保只有被求婚者可以点击“接受”
if interaction.user != self.target_user:
await interaction.response.send_message("你不能回应这个求婚!", ephemeral=True)
return
embed_agree = discord.Embed(
title=f'求婚成功!',
description=f'{self.target_user.mention} 接受了 {self.proposer.mention} 的求婚!恭喜!',
color=discord.Color.green()
)
# 编辑原消息,移除按钮并显示结果
await interaction.response.edit_message(embed=embed_agree, view=None)
self.stop() # 停止监听此视图的进一步交互
@discord.ui.button(label="拒绝", style=discord.ButtonStyle.danger)
async def disagree_btn(self, interaction: discord.Interaction, button: discord.ui.Button):
# 确保只有被求婚者可以点击“拒绝”
if interaction.user != self.target_user:
await interaction.response.send_message("你不能回应这个求婚!", ephemeral=True)
return
embed_disagree = discord.Embed(
title=f'求婚被拒绝',
description=f'{self.target_user.mention} 拒绝了 {self.proposer.mention} 的求婚。',
color=discord.Color.red()
)
await interaction.response.edit_message(embed=embed_disagree, view=None)
self.stop()
@discord.ui.button(label="取消", style=discord.ButtonStyle.gray, emoji="❌")
async def cancel_btn(self, interaction: discord.Interaction, button: discord.ui.Button):
# 只有求婚者或被求婚者可以取消
if interaction.user not in [self.proposer, self.target_user]:
await interaction.response.send_message("你不能取消这个求婚!", ephemeral=True)
return
embed_cancel = discord.Embed(
title=f'求婚已取消',
description=f'{interaction.user.mention} 取消了 {self.proposer.mention} 对 {self.target_user.mention} 的求婚。',
color=discord.Color.light_gray()
)
await interaction.response.edit_message(embed=embed_cancel, view=None)
self.stop()
# 4. 定义斜杠命令
@client.tree.command(name='marry', description="向某人求婚")
async def marry(interaction: discord.Interaction, user: discord.Member):
# 检查不能和自己求婚
if interaction.user == user:
await interaction.response.send_message(content=f"{interaction.user.mention} 你不能和自己结婚 :(", ephemeral=True)
return
# 检查不能和机器人求婚
if user.bot:
await interaction.response.send_message(content=f"{interaction.user.mention} 你不能和机器人结婚!", ephemeral=True)
return
embed_marry = discord.Embed(
title='? 求婚啦!',
description=f'{interaction.user.mention} 向 {user.mention} 提出了求婚!',
color=0x774dea
)
# 创建 MarryButtons 实例,并传入求婚者和被求婚者
view = MarryButtons(proposer=interaction.user, target_user=user)
# 发送消息并附带按钮视图
# 注意:这里发送的消息不设置为 ephemeral=True,以便在超时时可以编辑
await interaction.response.send_message(embed=embed_marry, view=view)
# 获取原始响应消息对象,并将其存储在视图中,以便 on_timeout 可以编辑它
# interaction.original_response() 返回一个 discord.Message 对象
view.message = await interaction.original_response()
# 5. 运行 Bot
# 请将 'YOUR_BOT_TOKEN' 替换为你的实际 Bot Token
# client.run('YOUR_BOT_TOKEN')以上就是Discord.py 按钮交互错误解析与上下文数据传递指南的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号