📜  discordjs.guide embed (1)

📅  最后修改于: 2023-12-03 15:14:42.661000             🧑  作者: Mango

使用 Discord.js 创建丰富的嵌入式(embed)消息

Discord.js 是一个功能强大的 Node.js 框架,用于编写 Discord 机器人。其中最强大的功能之一就是创建丰富的嵌入式(embed)消息,因为它能让您发送精美的消息给您的服务器成员。

创建一个简单的嵌入式消息

在开始创建嵌入式消息之前,让我们简要了解一下嵌入式消息的组成部分。嵌入式消息由一个 "embed" 对象组成,其具有用于配置嵌入式消息的各种属性。最基本的嵌入式消息需要以下三个属性:

  1. 标题 (title):显示在嵌入式消息顶部的文本。
  2. 描述 (description):显示在标题之下的文本。
  3. 颜色 (color):嵌入式消息条颜色。

以下是一个基本的嵌入式消息代码片段:

const Discord = require("discord.js");

const embed = new Discord.MessageEmbed()
  .setTitle("这是一个标题")
  .setDescription("这里是嵌入式消息的描述内容。")
  .setColor(0x00ff00);

message.channel.send(embed);

这个代码片段将创建一个标题为 "这是一个标题",颜色为绿色的嵌入式消息,并在当前频道中发送它。

添加图像和链接

嵌入式消息不仅限于文本。您还可以将图像和链接添加到嵌入式消息中,以创建更丰富的消息。

要添加图像,请在 "embed" 对象中使用 setImage() 方法。这个方法需要一个图像 URL 作为参数:

const embed = new Discord.MessageEmbed()
  .setTitle("这是一个标题")
  .setDescription("这里是嵌入式消息的描述内容。")
  .setImage("https://i.imgur.com/5pTSXlX.png")
  .setColor(0x00ff00);

如果您还想添加链接,请使用 setURL() 方法。这个方法需要一个 URL 作为参数:

const embed = new Discord.MessageEmbed()
  .setTitle("这是一个标题")
  .setDescription("这里是嵌入式消息的描述内容。")
  .setImage("https://i.imgur.com/5pTSXlX.png")
  .setURL("https://discord.js.org")
  .setColor(0x00ff00);

这将在嵌入式消息中添加一个可点击的链接,将用户重定向到 discord.js 的官方网站。

添加字段

您可以将字段添加到嵌入式消息中,以显示更多的信息。每个字段需要具有以下属性:

  1. 名称 (name):字段名称。
  2. (value):嵌入式消息中的文本值。
  3. 行内展示 (inline):一个布尔值,指定该字段是要在同一行上展示,还是将其换到下一行。

使用 addField() 方法将字段添加到嵌入式消息中:

const embed = new Discord.MessageEmbed()
  .setTitle("这是一个标题")
  .setDescription("这里是嵌入式消息的描述内容。")
  .setImage("https://i.imgur.com/5pTSXlX.png")
  .setURL("https://discord.js.org")
  .setColor(0x00ff00)
  .addField("字段 1 名称", "字段 1 值", true)
  .addField("字段 2 名称", "字段 2 值", true);

这将创建两个嵌入式消息中的字段,它们将依次在同一行上展示。第三个参数传入 false 则会将第二个字段放置到下一行。

最后想说的话

嵌入式消息可以让您的机器人更加丰富和有趣。使用 Discord.js 中的 MessageEmbed 类,您可以创建令人眼花缭乱的嵌入式消息,以让您和您的服务器成员更好地与 Discord 交互。