文档Experience Cloud KCS

AEM Dynamic Media：调整图像大小时保留宽高比

最近更新： 2026年7月29日

本文介绍了在使用宽度和高度参数调整图像大小时，如何确保Adobe Experience Manager Dynamic Media图像投放保持原始纵横比。

描述 description

环境

Adobe Experience Manager Dynamic Media（所有版本）

症状

当通过Dynamic Media OpenAPI端点传递图像并指定width和height查询参数时，返回的图像不保留原始纵横比。 相反，输出图像将被强制转换为正方形或使用较小的尺寸作为宽度和高度，从而导致意外的调整大小。 即使资产的原始维度不是方形，也会发生这种情况。

示例：

  • 资产原始尺寸：2336 × 2400 (image/webp)
  • 请求和观察到的结果：
  • ?width=1000 → 1000 × 1000
  • ?height=1000 → 1000 × 1000
  • ?width=1000&height=500 → 500 × 500
  • ?width=1500&height=500 → 500 × 500

预期行为：应调整图像大小以适合请求的定界框，同时保持原始纵横比（例如：2336 × 2400按比例缩放以适合1000 × 500）。

观察到的行为：图像输出为正方形或与预期纵横比不匹配，不考虑原始尺寸。

引用：

解决方法 resolution

请按照以下步骤解决问题：

  1. 查看图像投放URL，并确保您指定了所需的width和height参数。

  2. 要保留原始纵横比并将图像放入请求的定界框中，请将fit=contain参数附加到投放URL。

  3. 在浏览器或API客户端中测试更新的URL。 现在，返回的图像应符合指定的尺寸，同时保持其原始纵横比（例如：对于缩放到1000×500以适合2336×2400的图像，为487×500）。

  4. 有关支持的参数的更多详细信息，请参阅官方文档：

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