설명서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 게시 설정에서 기본 보기 크기 설정을 검토하고 배달 URL을 scale=1(으)로 테스트하십시오.
  9. 자산 배달 API를 통해 이미지가 흐리게 표시되는 경우 배달 URL을 생성할 때 명시적 너비와 자르기 매개 변수를 지정합니다.
  10. 업데이트된 이미지 사전 설정을 저장하고 다시 게시합니다. 세로, 가로 및 비표준 종횡비 에셋으로 업데이트된 렌디션의 유효성을 검사하여 예상 출력을 확인합니다.

관련 읽기

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