文件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 （影像/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