本文旨在解决在 Discord.py 中从函数返回 discord.Embed 对象后，如何正确发送该嵌入消息的问题。常见的错误是直接发送函数返回的对象，导致 Discord 客户端显示为对象内存地址。核心解决方案在于，在使用 channel.send() 方法时，必须通过 embed 关键字参数来明确指定要发送的 Embed 对象，而非直接将其作为位置参数传递。
理解问题：直接发送 Embed 对象
在 discord.py 机器人开发中，为了代码的模块化和可维护性，我们经常会将复杂的逻辑（例如嵌入消息 embed 的创建）封装到单独的函数或文件中。例如，一个常见的做法是在一个名为 _embeds.py 的文件中定义一个函数，用于生成特定类型的嵌入消息，并在主程序 main.py 中调用它。
考虑以下 _embeds.py 中的函数定义，它用于生成一个设置更新成功的提示消息：
# _embeds.pyimport discordfrom datetime import datetimedef setting_update_success(setting, value): """ 生成一个表示设置更新成功的 Embed 消息。 """ embed = discord.Embed( title="Success!", description=f"Setting `{setting}` was updated to `{value}`.", colour=0x19e63b, # 绿色 timestamp=datetime.now() ) # 假设 'chix_full.png' 是通过 File 对象传递的，或者是一个可访问的URL # 这里为了示例，省略了 File 对象的创建和传递 embed.set_author(name="Chix", icon_url="https://example.com/chix_full.png") # 示例 URL embed.set_footer(text="Sent") return embed
在 main.py 中，如果尝试直接发送这个函数返回的 Embed 对象，可能会遇到问题：
# main.py (错误示例)import discordfrom discord.ext import commandsimport _embeds as messages # 导入包含 Embed 生成函数的模块bot = commands.Bot(command_prefix='!')@bot.command()async def update(ctx, setting: str, value: str): # 假设 ctx.channel 是一个有效的频道对象 # 这种调用方式是错误的，会导致发送 Embed 对象的字符串表示 await ctx.channel.send(messages.setting_update_success(setting, value))# 运行 bot# bot.run("YOUR_BOT_TOKEN")
当执行上述 await ctx.channel.send(messages.setting_update_success(setting, value)) 时，Discord 客户端不会显示格式化的嵌入消息，而是显示类似 的字符串，这表示 Python 解释器正在发送 Embed 对象的内存地址表示，而不是将其解析为实际的嵌入消息。
解决方案：使用 embed 关键字参数
discord.py 库的 TextChannel.send() 方法（以及其他类似的可发送消息的方法，如 Context.send()）被设计为可以接受多种类型的参数。当发送一个 discord.Embed 对象时，必须通过 embed 关键字参数来明确指定它。这是因为 send 方法可以同时发送文本内容、文件、视图（views）以及嵌入消息等，通过关键字参数可以清晰地区分这些不同的内容类型。
正确的调用方式如下：
# main.py (正确示例)import discordfrom discord.ext import commandsimport _embeds as messages # 导入包含 Embed 生成函数的模块bot = commands.Bot(command_prefix='!')@bot.command()async def update(ctx, setting: str, value: str): # 正确的发送方式：使用 embed 关键字参数 await ctx.channel.send(embed=messages.setting_update_success(setting, value))# 运行 bot# bot.run("YOUR_BOT_TOKEN")
通过将 messages.setting_update_success(setting, value) 的返回值赋值给 embed 关键字参数，discord.py 内部会识别这是一个 Embed 对象，并将其正确地格式化为 Discord 客户端可解析的嵌入消息。
最佳实践与注意事项
模块化和可重用性： 将 Embed 的创建逻辑封装在单独的函数或模块中是一个非常好的实践。这提高了代码的可读性、可维护性和可重用性。当你的机器人有多种不同类型的嵌入消息时，这种结构尤其有用。
参数传递： 确保你的嵌入消息生成函数接受所有必要的参数来动态构建消息内容（例如 setting 和 value）。
错误处理： 虽然本例中没有直接涉及，但在实际应用中，你可能需要考虑在 Embed 生成函数中加入参数验证或错误处理，以应对无效输入。
图标 URL： 在 embed.set_author(icon_url=”attachment://chix_full.png”) 中，attachment:// 前缀表示该图片是作为附件与消息一同发送的。如果你的 icon_url 是一个附件，你需要同时在 channel.send() 中传递 file 参数。如果 icon_url 是一个外部 URL，则无需额外操作。
# 如果 icon_url 是附件# from discord import File# file = File("path/to/chix_full.png", filename="chix_full.png")# await ctx.channel.send(file=file, embed=messages.setting_update_success(setting, value))
总结
在 Discord.py 中，从函数返回 discord.Embed 对象后，若要将其作为嵌入消息发送，核心要点是始终使用 channel.send(embed=your_embed_object) 的形式。直接将 Embed 对象作为位置参数传递会导致其字符串表示被发送，而不是预期的格式化消息。遵循这一原则，可以确保你的机器人能够正确、美观地展示各种嵌入消息，同时保持代码的整洁和高效。
以上就是在 Discord.py 中封装和正确发送 Embed 消息的教程的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1365974.html
微信扫一扫 
支付宝扫一扫 
