在discord.py中从函数正确发送Discord Embeds-Python教程-PHP中文网

在discord.py中从函数正确发送Discord Embeds

DDD

发布： 2025-07-20 21:34:01

原创

299人浏览过

在discord.py中从函数正确发送discord embeds

本文探讨了在discord.py机器人开发中，如何正确地从独立函数中返回并发送Discord Embeds。许多开发者在尝试直接发送Embed对象时会遇到问题，即机器人发送的是对象内存地址而非格式化消息。本教程将详细解释为何会出现此问题，并提供使用channel.send(embed=...)参数的正确解决方案，以确保您的Embeds能被成功渲染和发送。

理解问题：为何直接发送Embed对象失败

在discord.py中，discord.Embed对象是用于创建富文本消息的强大工具。为了代码的模块化和可维护性，开发者通常会将Embed的创建逻辑封装在单独的函数或文件中。然而，当尝试将这些函数返回的Embed对象直接传递给channel.send()方法时，例如await channel.send(my_embed_function())，机器人发送的却是一串类似<discord.embeds.Embed object at 0x00000219A7514CA0>的字符串，而非预期的美观消息。

这是因为channel.send()方法在默认情况下期望接收一个字符串作为消息内容。当它接收到一个非字符串对象时，会尝试将其转换为字符串表示（即对象的__repr__方法返回的内容），这通常是对象的类型和内存地址，而不是其视觉渲染结果。因此，尽管您正确地创建了Embed对象并从函数中返回了它，但send()方法并未将其识别为需要特殊处理的Embed类型。

解决方案：使用embed关键字参数

discord.TextChannel.send()方法提供了一个专门用于发送Embed对象的关键字参数：embed。当您希望发送一个discord.Embed实例时，必须明确地通过embed=参数来指定它。

正确的使用方式如下：

await channel.send(embed=your_embed_object)

登录后复制

通过这种方式，discord.py内部机制会识别到这是一个需要特殊处理的Embed对象，并将其正确地渲染为Discord消息中的嵌入式内容。

组织Embed代码：最佳实践

将Embed的创建逻辑封装在单独的模块中是一种非常好的实践。这不仅可以提高代码的可读性和复用性，还能让您的主逻辑文件保持整洁。

ChatBA

AI幻灯片生成工具

查看详情

假设您有一个名为 _embeds.py 的文件，其中包含用于生成不同类型Embed的函数：

_embeds.py 示例：

import discord
from datetime import datetime

def setting_update_success(setting: str, value: str) -> discord.Embed:
    """
    生成一个表示设置更新成功的Embed。

    Args:
        setting (str): 被更新的设置名称。
        value (str): 设置的新值。

    Returns:
        discord.Embed: 构造好的Embed对象。
    """
    embed = discord.Embed(
        title="操作成功！",
        description=f"设置 `{setting}` 已更新为 `{value}`。",
        colour=0x19e63b,  # 绿色
        timestamp=datetime.now()
    )
    # 示例：设置作者和页脚，可以根据实际情况调整
    embed.set_author(name="Chix Bot", icon_url="https://example.com/chix_icon.png") # 替换为实际的图标URL
    embed.set_footer(text="消息已发送")
    return embed

# 您可以添加更多用于不同场景的Embed生成函数
def error_message_embed(error_description: str) -> discord.Embed:
    """
    生成一个表示错误的Embed。
    """
    embed = discord.Embed(
        title="错误！",
        description=f"发生了一个错误：\n`{error_description}`",
        colour=discord.Colour.red(),
        timestamp=datetime.now()
    )
    return embed

登录后复制

在您的主机器人文件（例如 main.py）中，您只需要导入这个模块，并调用相应的函数来获取Embed对象，然后将其传递给channel.send()的embed参数。

main.py 示例：

import discord
from discord.ext import commands
import _embeds as messages # 导入_embeds模块并取别名为messages

# 假设您的bot实例已经创建
bot = commands.Bot(command_prefix="!")

@bot.event
async def on_ready():
    print(f'Bot已上线：{bot.user}')

@bot.command()
async def update(ctx, setting: str, value: str):
    """
    模拟一个更新设置的命令，并发送成功Embed。
    """
    try:
        # 假设这里是更新设置的逻辑
        # ...

        # 调用_embeds模块中的函数获取Embed对象
        success_embed = messages.setting_update_success(setting, value)
        # 正确地通过embed参数发送Embed
        await ctx.send(embed=success_embed)

    except Exception as e:
        error_embed = messages.error_message_embed(str(e))
        await ctx.send(embed=error_embed)

# 运行您的bot
# bot.run('YOUR_BOT_TOKEN') # 替换为您的机器人令牌

登录后复制

注意事项

参数传递： 当您的Embed生成函数需要动态内容时（如本例中的setting和value），确保将这些数据作为参数传递给函数。这样，您的Embed就能根据上下文生成定制化的内容。
错误处理： 在实际应用中，处理可能出现的错误并发送相应的错误Embed是良好的实践。
Embeds列表： channel.send()方法也支持通过embeds参数（注意是复数）发送一个Embed对象列表，这在您需要一次性发送多个Embed时非常有用。例如：await channel.send(embeds=[embed1, embed2])。
文件附件： 如果您的Embed使用了set_author或set_thumbnail等方法引用了本地文件作为图标（如示例中的attachment://chix_full.png），您还需要在channel.send()中通过file或files参数同时发送这些附件。

总结

在discord.py中，从函数返回discord.Embed对象并发送它的关键在于理解channel.send()方法的参数机制。始终使用embed=关键字参数来传递您的Embed对象，以确保它被正确解析和渲染。通过将Embed创建逻辑封装在独立模块中，并配合正确的发送方式，您可以构建出更加模块化、可维护且功能强大的Discord机器人。

以上就是在discord.py中从函数正确发送Discord Embeds的详细内容，更多请关注php中文网其它相关文章！