You need to enable JavaScript to run this app. Discord.NET 获取用户头像后如何在嵌入消息中缩放调整图片尺寸
优惠活动
大模型
产品
解决方案
定价
更多

Discord.NET 获取用户头像后如何在嵌入消息中缩放调整图片尺寸

Discord.NET 调整嵌入消息内头像显示尺寸的实现方案

核心原理

你当前嵌入图尺寸偏小的根源,是GetAvatarURL()方法默认拉取128px规格的小尺寸头像资源,嵌入消息不会自动拉伸低分辨率图片。
Discord CDN托管的所有用户头像,都支持通过URL查询参数指定输出的图片分辨率,嵌入消息会自适应加载匹配该分辨率的资源,自然会显示为更大的尺寸。

具体修改方法

1. 优先使用框架内置重载指定尺寸(适配Discord.NET v3.x及以上版本)

GetAvatarURL()方法本身提供了尺寸参数的重载,不需要手动拼接URL,直接替换原来的图片地址行即可:
将原有代码:
eb.WithImageURL(subject.GetAvatarURL());
替换为:
eb.WithImageURL(subject.GetAvatarURL(ImageFormat.Png, size: 1024));
参数说明:

  • ImageFormat.Png可替换为ImageFormat.Auto、ImageFormat.Webp,不影响尺寸效果
  • size支持的取值为Discord CDN规定的固定值:16、32、64、128、256、512、1024、2048,推荐直接用1024即可满足最大展示需求

2. 旧版本兼容方案(无size参数重载的低版本Discord.NET)

如果使用的框架版本过低,没有提供size参数,直接手动拼接尺寸参数到原始头像URL即可:

var baseAvatarUrl = subject.GetAvatarURL();
// 若URL本身带查询参数则改用 &size=1024 拼接,避免参数格式错误
var largeAvatarUrl = baseAvatarUrl.Contains('?') ? $"{baseAvatarUrl}&size=1024" : $"{baseAvatarUrl}?size=1024";
eb.WithImageURL(largeAvatarUrl);

完整修改后可运行代码示例

var users = Context.Message.MentionedUsers;
var subject = users.First();
var eb = new EmbedBuilder();
eb.WithColor(EmbedColor);
// 加载1024px尺寸的头像资源,嵌入会自动展示为平台允许的最大尺寸
eb.WithImageURL(subject.GetAvatarURL(ImageFormat.Png, size: 1024));
await ReplyAsync("", false, eb.Build());

注意事项

  • 不要填写非CDN支持的自定义尺寸值,否则会触发Discord返回404错误,导致嵌入图加载失败
  • 嵌入消息的图片最大展示宽度有平台上限,1024px尺寸已经可以拉满嵌入的最大展示宽度,设置更高的2048只会增大文件体积,不会让显示效果更大
  • 该参数对未设置自定义头像的默认用户头像同样生效,默认头像资源也支持尺寸查询参数

内容的提问来源于stack exchange,提问作者Iamahuman

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.21 23:06:08