ドキュメント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 レンディションでは、画像の1つまたは複数の面に白いパディングが表示されます。
  • 要求されたディメンションが元のアセットサイズを超えると、画像がアップスケールしない。
  • レンディションプレビューに、設定した画像プリセットと比較して誤った縦横比が表示される。
  • アセット配信の出力がぼやけて見えたり、常に一定の解像度でレンダリングされたりする。

原因

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を使用するか、1つのディメンション（幅など）のみを要求して画像の縦横比を保持します。
  6. Dynamic Mediaで小さい画像が拡大されない場合は、画像プリセットまたは配信URLにfit=fit,1を追加します。
  7. レンディションのプレビューで予期しない縦横比が表示される場合は、設定された適合モードを確認し、目的の設定に更新します。
  8. Dynamic Mediaが常に固定の画像サイズを配信する場合は、Dynamic Media公開設定のデフォルトの表示サイズ設定を確認し、配信URLをscale=1でテストします。
  9. アセット配信APIで画像がぼやけて見える場合は、配信URLの生成時に明示的な幅と切り抜きパラメーターを指定します。
  10. 更新した画像プリセットを保存して再公開します。 更新されたレンディションをポートレート、風景、および非標準の縦横比アセットで検証して、予想される出力を確認します。

関連トピックス

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