文档Experience Cloud KCS

Dynamic Media图像演绎版显示空格、不正确的纵横比或缺少缩放行为

最近更新： 2026年7月13日

当图像预设设置与请求的图像尺寸不符时，Dynamic Media图像演绎版会显示白色边距、不正确的宽高比、缺少缩放行为或模糊输出。 更新图像预设配置或应用适当的Dynamic Media拟合和缩放参数以实现预期的图像输出。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service
  • AEM Dynamic Media
  • Dynamic Media图像预设
  • 资产交付API

问题/症状

  • 图像在Dynamic Media演绎版的一个或多个边上显示白色填充。
  • 当请求的尺寸超过原始资源大小时，图像不会放大。
  • 与配置的图像预设相比，演绎版预览显示的长宽比不正确。
  • 资产投放输出似乎模糊，或始终以固定分辨率呈现。

原因

当源和输出尺寸不匹配时，Dynamic Media使用适应和缩放设置控制图像的呈现方式。 当图像预设或交付URL缺少合适的适合模式时，Dynamic Media会保留原始纵横比并添加白色填充。 禁用的升级可防止图像放大，并导致白色边框或缺少缩放行为。 默认视图大小设置还可以限制传递的分辨率，除非您应用scale=1.

解决方法 resolution

按照以下步骤解决问题

  1. 将交付的图像与原始资产进行比较，并确定问题涉及空格、缺少放大比例、纵横比不正确、输出大小固定或渲染模糊。
  2. 在 工具> Assets 中打开受影响的图像预设 >图像预设并查看配置的图像修饰符。
  3. 对于由长宽比差异导致的空白，添加或更新fit=fit,1修饰符。 在需要白色背景时添加bgc=FFFFFF。
  4. 对于因禁用升级而导致的白色边框，请将fit=crop,0替换为fit=crop,1,并保存预设。
  5. 对于宽高比问题，请使用fit=crop,1或仅请求一个维度（如wid）以保留图像比例。
  6. 如果Dynamic Media不放大较小的图像，请将fit=fit,1添加到图像预设或投放URL。
  7. 如果演绎版预览显示意外的纵横比，请检查配置的适合模式并将其更新为预期设置。
  8. 如果Dynamic Media始终提供固定的图像大小，请查看Dynamic Media发布设置中的默认视图大小设置，并使用scale=1测试交付URL。
  9. 如果通过资产交付API显示的图像模糊，请在生成交付URL时指定明确的宽度和裁切参数。
  10. 保存并重新发布更新的图像预设。 使用纵向、横向和非标准纵横比资源验证更新的演绎版，以确认预期输出。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles