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
相关产品推荐
相关产品推荐

