Fjord

Fjord 文档

模块

04

嵌入内容

使用可视化编辑器创建结构化消息,无需编写 JSON。

包含的功能

  • 标题、描述、字段和媒体
  • 编辑时实时预览
  • 保存并再次编辑

可以用嵌入内容创建什么?

在可视化编辑器中制作 Discord 消息,并通过实时预览检查效果。你可以组合文字、字段、图片和颜色,保存草稿,或将消息发布到频道并在之后更新。

了解消息组合

两种格式均支持预览、强调色、图片、多个嵌入内容及展开、复制、删除、排序嵌入。V1 使用 Discord 固定字段,V2 使用自由排列的块。后续章节说明输入内容及差异。

合成的名称仅用于仪表板中的管理,不会发送到 Discord。每个服务器最多可以存储 50 个作品,每个作品的名称最多为 50 个字符。

状态行为
草稿如果没有目标频道,作品将被保存但不会发布到 Discord。
托管发布使用目标频道,保存会创建一条与作品永久关联的 Discord 消息。进一步的更改将更新此确切消息。
发送一次发送当前消息,而不保存撰写内容或创建稍后的链接。此选项仅在第一次保存之前存在。

组件 V1 / V2

新组合默认使用 V2。

首次保存前选择 V1 或 V2。保存后版本固定,草稿及移除发布后也无法更改。需要其他格式时请新建组合。复制会保留版本。已保存的 V1 消息不会自动转换或删除。

V1

V1 使用 Discord 经典嵌入内容,包含强调色和固定区域。最多十个嵌入内容。表中的数字是字符上限。所有嵌入内容的作者、标题、描述、页脚以及全部字段名和字段值合计最多 6000 个字符。普通消息文本有单独的上限。 每个 V1 嵌入最多支持 25 个字段。

输入项字符上限状态
作者256可选
作者 URL512可选
标题256可选
标题链接(可选)512可选
描述4096可选
页脚文本2048可选
字段名称256添加后必填
字段值1024添加后必填

所有设计区域均可选。添加字段后,字段名和字段值均为必填。请删除不用的字段。并排显示启用行内字段,实际布局由 Discord 和屏幕宽度决定。作者链接和图标需要作者名,标题链接需要标题,页脚图标需要页脚文本。可选链接必须是完整 HTTP(S) 地址。时间戳显示发送时间。

普通文本、V1 描述和字段值支持身份组及频道选择器。作者、标题、页脚和字段名不提供这些提及选择器,但可使用服务器表情。作者 URL 和标题链接只接受网址,不能插入身份组、频道或表情。经典嵌入内容中的提及不会发送通知。

V2 每个操作行最多容纳五个链接按钮,使用总组件额度,而非 V1 的五行上限。

链接按钮打开网站,不分配身份组。每个新增按钮必须有最多 80 字符的标签和最多 512 字符的完整 HTTP(S) URL。表情可选。可排序或删除按钮。V1 将按钮放在嵌入内容下方,每行最多五个按钮、合计最多五行,即最多 25 个按钮。V2 放在对应容器内,按钮及操作行都计入 40 组件额度。

创建合成

内部名称即使只保存草稿也必填。编辑器最多允许 50 字符。新组合会获得可修改的建议名称,仅在控制面板显示。发布需要可访问目标频道及可见文本、嵌入内容或完整链接按钮。描述或图片不要求标题。空草稿暂时不需要消息内容。

所需的 Discord 权限

查看频道 发送消息 嵌入链接 附加文件 提及 @everyone、@here 和所有身份组

V1 普通文本中的提及可以通知用户,经典嵌入内容中的提及不会通知。V2 文本块也可以触发提及通知。对于 @everyone、@here 和非公开可提及的身份组,Fjord 需要相应 Discord 权限。发布前请检查提及。

每次发布都需要查看频道及发送消息权限。经典嵌入及其图片需要嵌入链接权限。单次发送本地图片文件时需要附加文件权限。保存草稿不会发布 Discord 消息。

  1. 在仪表板中打开嵌入。
  2. 选择新作品并指定一个内部名称。
  3. 如有必要,添加正常消息内容。
  4. 设计第一个嵌入,并根据需要添加其他嵌入。
  5. 在 Discord 预览中检查结果。
  6. 选择发布的目标渠道或将渠道留空以仅保存草稿。
组合名称强制

专门用于仪表板中的管理,最多可包含 50 个字符。

消息内容可选

普通消息内容为可选项,最多 2,000 个字符。发布内容也可以只有文本。消息必须有可见内容。同时请检查格式和组件限制。

嵌入可选

嵌入内容为可选项,最多可设计十个。V2 的总组件预算还会限制其数量和内容。

目标渠道可选

如果没有目标渠道,则会保存草稿。发布时必须有可访问的目标渠道。

消息内容

正常消息内容显示在嵌入内容上方,最多可包含 2,000 个字符。可以通过编辑器中的选择来使用角色、频道和服务器表情符号。

V1 普通文本中的提及可以通知用户,经典嵌入内容中的提及不会通知。V2 文本块也可以触发提及通知。对于 @everyone、@here 和非公开可提及的身份组,Fjord 需要相应 Discord 权限。发布前请检查提及。

设计嵌入

只有同时填写作者名称时,Discord 才会显示作者图标。请在上方输入名称,使图标出现在预览中。 只有同时填写页脚文本时,Discord 才会显示页脚图标。请在上方输入文本,使图标出现在预览中。

V2

图片块可包含最多十张图片的图库。使用“+ 添加图片”添加图片,每张图片均可单独移除。每张图片和缩略图可选填最多 80 个字符的描述,并设置剧透。段落最多支持三个文本,每个最多 4000 个字符。使用“+ 添加文本”增加最多两个额外文本。在附加组件中选择缩略图或链接按钮。链接按钮必须填写最多 80 个字符的标签和最多 512 个字符的完整 HTTP(S) URL。表情符号及禁用选项为可选项。额外文本和附加按钮计入组件总数。图库中的单张图片不计为额外组件。

在 V2 中,可以将容器和图片(包括缩略图)标记为剧透。内容最初隐藏,点击后显示。

V2 提供最多十个容器,各有强调色。文本块或右侧可选缩略图的段落各支持最多 4000 个字符及 Markdown。分隔线可显示线条或仅留白,间距可选小或大。可添加、复制、删除及通过箭头排序块。空文本和图片块不会产生可见内容。 V2 文本区域提供身份组、频道及服务器表情选择器。

V2 没有经典作者字段、标题链接输入框、行内字段、页脚图标或时间戳开关。请在文本块中用 Markdown 设置标题及链接。下方示例可制作小号页脚,时间标记可插入时间戳。V1 不支持自由排列的 V2 块。同一条消息不能混合两种格式。

-# ... · {time.full}

容器

快捷颜色 · 10

文本块

Markdown · 4000

带缩略图的段落

Markdown · 4000 · Thumbnail ≤ 5 MB

图片

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

分隔线

显示分隔线 · 小 / 大

V2 的整条消息合计最多 40 个组件。容器、文本、段落、缩略图、图片画廊、分隔线、操作行、按钮及菜单都分别计数。菜单选项不单独计数。自动添加的分隔线及控件也占用额度。例如,包含文本、图片、分隔线以及带操作行按钮的容器需要六个组件。 因此十个容器不能无限填充。

使用图像

图片限制按每个文件计算。V1 作者图标、缩略图和页脚图标各最多 5 MB。大图上限与下方 V2 图片块上限相同。支持 PNG、JPG/JPEG、WebP 和 GIF。选择文件替换图片,删除清空位置。作者和页脚图标没有对应文本时不可见。

可选 PNG、JPG/JPEG、WebP 或 GIF,保存时上传图片。缩略图最大 5 MB,图片块最大 10 MB。嵌入模块的一次性发送最多使用十张本地图片,总大小不超过 20 MB。

Thumbnail5 MB
图片10 MB

保存并发布

受管理消息已从 Discord 消失时,再次保存会重新发布。复制组合保留格式,但默认没有发布频道,独立于原组合。

另存为草稿

将频道选择留空并保存。该草稿在仪表板中仍然可用,而不会创建 Discord 消息。

永久发布

选择一个频道并保存。创建的 Discord 消息仍链接到该作品。保存后,后续更改将在同一条消息中更新。

推迟发布

如果您为已发布的文章选择不同的频道,则下次保存时,将先创建新消息,然后删除旧消息。

删除出版物

删除帖子仅删除托管的 Discord 消息。该作品仍保留为已保存的草稿。

删除合成

删除组合会移除保存的记录及其存储图片。Discord 中已经发送的消息不会删除,但可能失去图片引用。如需同时移除受管理消息,应先明确移除发布。单次发送的消息不会在发送后继续管理。

管理和复制

可以打开、重命名、复制和删除保存的作品。在一个合成中最多可以创建、重新排列和复制十个嵌入。如果重复会超出 Discord 的数量或文本限制,则会被阻止。

可以在模块内切换组合消息和概览,未保存的更改会保留。离开模块之前,必须保存或放弃所有未完成的更改。 共用的保存栏在概览中也会保持可见。保存会应用所有组合消息的未保存更改。取消会放弃这些更改。这也包括当前未打开的组合消息。

修复错误

观察检查
消息无法发布。是否选择了可访问的文本通道,并且允许 Fjord 发送消息并嵌入其中?
图像被拒绝。可选 PNG、JPG/JPEG、WebP 或 GIF,保存时上传图片。缩略图最大 5 MB,图片块最大 10 MB。嵌入模块的一次性发送最多使用十张本地图片,总大小不超过 20 MB。
无法发送一次。该功能仅在第一次保存之前可用,并且仅限十个本地附件。
未提及角色。V1 普通文本中的提及可以通知用户,经典嵌入内容中的提及不会通知。V2 文本块也可以触发提及通知。对于 @everyone、@here 和非公开可提及的身份组,Fjord 需要相应 Discord 权限。发布前请检查提及。
保存的频道不再可用。选择一个允许 Fjord 发布到的现有频道并再次保存。

消息组合占位符

以下占位符可用于两种版本的普通消息文本及 V1 经典文本字段,在发送或更新时替换,不会持续刷新。目前 V2 块不会替换这些服务器、频道及机器人占位符,但可使用上方说明的时间标记。成员占位符及动态头像图片属于欢迎模块。

{member.guild.member_count}成员数
{guild.owner.mention}服务器所有者提及
{member.guild.name}服务器名称
{guild.owner.id}服务器所有者 ID
{channel.mention}目标频道提及
{time.relative}相对时间
{channel.id}目标频道 ID
{bot.mention}机器人提及
{time.full}日期和时间
{guild.id}服务器标识符
{bot.name}机器人名称
{bot.id}机器人 ID

要求与限制

有效设计不需要填写所有可选区域。仅颜色或空块不能代替发布所需的可见内容。预览不会发送消息,也不能代替目标频道的实际测试。两个编辑器都不提供投票、贴纸、表单或自由编程的操作。数据及编辑权限也取决于你获得的控制面板授权。

预览、剧透与图片文件

V2 预览中的单张图库图片保留原始宽高比。多张图片以统一的 16:9 裁切区域组成网格。两张或四张图片使用两列,三张以及五至十张图片使用三列。缩略图位于分区文字右侧。图片描述用作替代文字,不会成为额外可见的图片说明。

图片和容器的剧透开关属于 V2 编辑器。每张图库图片及缩略图可以独立隐藏。容器剧透隐藏内容,但保留可见的外框。点击会在预览中显示内容,不会更改已保存的剧透设置。成员也可以在 Discord 中点击显示剧透内容。

消息图片支持 PNG、JPG/JPEG、WebP 和 GIF。文件类型必须与图片内容一致。更改 HTML 或 SVG 文件的扩展名不会让它成为受支持的图片。图片表格中的大小限制仍适用于每个文件。如果本地图片被拒绝或无法读取,请重新选择原始文件并再次保存。

Markdown 文字区域支持网页和电子邮件链接。预览可以打开 HTTP(S) 和 mailto 链接,但不会打开本地文件或 Blob 地址。作者链接、标题链接和链接按钮必须使用完整的 HTTP(S) URL。预览不会发布消息。请在 Discord 中检查保存后的结果,显示效果可能因客户端和屏幕宽度而异。