DokumentationExperience Cloud KCS

AEM Dynamic Media: Beibehalten des Seitenverhältnisses beim Ändern der Bildgröße

Letzte Aktualisierung: 29. Juli 2026

In diesem Artikel wird erläutert, wie Sie bei der Größenanpassung von Bildern mit Breiten- und Höhenparametern sicherstellen können, dass bei der Bildbereitstellung mit Adobe Experience Manager Dynamic Media das ursprüngliche Seitenverhältnis erhalten bleibt.

Beschreibung description

Umgebung

Adobe Experience Manager Dynamic Media (alle Versionen)

Symptome

Beim Bereitstellen von Bildern über den OpenAPI-Endpunkt von Dynamic Media und beim Angeben von width- und height-Abfrageparametern behält das zurückgegebene Bild nicht das ursprüngliche Seitenverhältnis bei. Stattdessen wird das Ausgabebild in ein Quadrat gezwungen oder verwendet die kleinere Dimension für Breite und Höhe, was zu einer unerwarteten Größe führt. Dies tritt auch dann auf, wenn die ursprünglichen Abmessungen des Assets nicht quadratisch sind.

Beispiel:

  • Originalabmessungen des Assets: 2336 × 2400 (Bild/WebP)
  • Anfragen und beobachtete Ergebnisse:
  • ?width=1000 → 1000 × 1000
  • ?height=1000 → 1000 × 1000
  • ?width=1000&height=500 → 500 × 500
  • ?width=1500&height=500 → 500 × 500

Erwartetes Verhalten: Die Größe des Bildes sollte so angepasst werden, dass es in den angeforderten Begrenzungsrahmen passt, während das ursprüngliche Seitenverhältnis beibehalten wird (z. B.: 2336 × 2400 proportional skaliert, um in 1000 × 500 zu passen).

Beobachtetes Verhalten: Die Bildausgabe ist quadratisch oder entspricht nicht dem erwarteten Seitenverhältnis, unabhängig von den Originalabmessungen.

Verweise:

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Überprüfen Sie die Bildbereitstellungs-URL und stellen Sie sicher, dass Sie die gewünschten width- und height angeben.

  2. Hängen Sie den fit=contain-Parameter an die Versand-URL an, um das ursprüngliche Seitenverhältnis beizubehalten und das Bild in das angeforderte Begrenzungsfeld einzupassen.

  3. Testen der aktualisierten URL in einem Browser oder API-Client. Das zurückgegebene Bild sollte nun in die angegebenen Abmessungen passen, während das ursprüngliche Seitenverhältnis beibehalten wird (z. B.: 487 × 500 für ein Bild mit 2336 × 2400, das auf 1000 × 500 skaliert werden kann).

  4. Weitere Informationen zu unterstützten Parametern finden Sie in der offiziellen Dokumentation:

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