如何在 Discord.py 中为嵌入添加按钮：交互性与灵活性

2024-03-26 18:18:37

在 Discord.py 中嵌入按钮

引言

Discord.py 是一个流行的 Python 库，用于创建和管理 Discord 机器人。通过嵌入按钮，你可以将交互性元素添加到 Discord 消息中，从而提升用户体验。本文将深入探讨如何在 Discord.py 中为嵌入添加按钮。

创建按钮

要创建按钮，可以使用 discord.ui.Button 类：

button = discord.ui.Button(label="点击我")
button.style = discord.ButtonStyle.primary

label 参数指定按钮上的文本标签。
style 参数设置按钮的外观，例如 primary、secondary 或 danger。

添加按钮到嵌入

使用 add_item 方法将按钮添加到 Discord 嵌入中：

embed.add_item(button)

嵌入是一个包含丰富文本和媒体元素的 Discord 消息对象。

添加事件监听器

你可以使用 callback 参数为按钮添加事件监听器。当用户点击按钮时，将触发该监听器：

@button.callback
async def button_callback(interaction):
    await interaction.response.send_message("你点击了按钮！")

interaction 参数表示用户与按钮的交互。
response 属性允许你发送消息或执行其他操作。

添加页脚

Discord.py 不支持使用 set_footer 方法为嵌入添加页脚。作为替代，你可以使用 set_author 方法：

embed.set_author(name="页脚文本", icon_url="可选图标 URL")

完整示例

以下是一个完整的示例，演示如何创建带有按钮和页脚的嵌入：

import discord
from discord.ext import commands
from discord.ui import Button

client = commands.Bot(command_prefix="!")

@client.event
async def on_message(message):
    if message.content.lower().startswith("!help"):
        embed = discord.Embed(
            title="帮助屏幕",
            description="这里你可以找到如何使用机器人的说明！",
            color=discord.Colour.blue())
        embed.add_field(
            name="游戏命令",
            value="这些命令用于在游戏中执行操作，使用 !GameCMDS 查看所有与游戏相关的命令",
            inline=False)
        embed.add_field(
            name="服务器命令",
            value="这些命令用于对服务器执行操作。使用 !ServerCMDS 查看所有与服务器相关的命令",
            inline=False)
        embed.set_thumbnail(
            url="https://images.unsplash.com/photo-1477959858617-67f85cf4f1df?ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&ixlib=rb-1.2.1&auto=format&fit=crop&w=1244&q=80")

        button = discord.ui.Button(label="点击我")
        button.style = discord.ButtonStyle.primary
        embed.add_item(button)

        @button.callback
        async def button_callback(interaction):
            await interaction.response.send_message("你点击了按钮！")

        embed.set_author(name="页脚文本", icon_url="可选图标 URL")

        await message.channel.send(embed=embed)

client.run("你的机器人令牌")

常见问题解答

我可以向嵌入中添加多个按钮吗？
- 是的，你可以使用 add_item 方法添加多个按钮。
如何禁用按钮？
- 使用 disabled 参数，将其设置为 True 以禁用按钮。
我可以为按钮添加自定义样式吗？
- 是的，你可以使用 custom_id 参数指定按钮的自定义样式。
如何从嵌入中删除按钮？
- 使用 remove_item 方法从嵌入中删除按钮。
Discord.py 是否支持为嵌入添加页脚？
- 不，Discord.py 不支持 set_footer 方法。你可以使用 set_author 方法模拟页脚。