설명서AEM사용 안내서

[AEM Assets]{class="badge positive" title="AEM Assets에 적용됩니다)."}

Dynamic Media 문제 해결 troubleshooting-dynamic-media-scene-mode

마지막 업데이트: 2026년 9월 25일
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • Admin
  • User

이 항목에서는 일반적인 문제, 가능한 원인 및 일반적인 해결 방법에 대해 다루는 Dynamic Media​에 대한 문제 해결 지침을 제공합니다. Dynamic Media는 이미지, 비디오 및 대화형 경험과 같은 리치 미디어 에셋을 규모에 맞게 생성, 관리 및 전달하고, 다양한 디바이스, 화면 크기 및 보기 조건에 콘텐츠를 적용하는 데 사용되는 기능입니다. 여러 환경에서 에셋 처리, 전달 및 렌더링을 포괄하므로, 일반적으로 문제 해결은 에셋 수집, 활성화 또는 전달 중 문제가 발생하는지 여부를 격리해야 합니다.

일반적인 Dynamic Media 문제 범주

대부분의 Dynamic Media 문제는 인식할 수 있는 소수의 범주에 속합니다. 카테고리를 식별하면 조사가 좁혀지고 해결 속도가 빨라집니다.

  • 자산 업로드 및 처리 실패 — 가져오지 않거나, 렌디션을 생성하지 못하거나, 처리 상태에서 남아 있는 자산입니다.
  • 활성화 및 게시 문제 - 정상적으로 처리되지만 게재 계층에서 사용할 수 없는 에셋입니다.
  • 게재 및 렌더링 문제 — 이미지 또는 비디오가 로드되지 않거나 잘못 표시되거나 잘못된 차원 또는 품질로 제공되는 경우
  • 뷰어 및 임베드 문제 - 초기화되지 않거나 예상대로 동작하지 않는 대화형 뷰어, 비디오 플레이어 또는 임베드된 경험.
  • 구성 및 연결 문제 — 잘못된 서비스 설정, 자격 증명 또는 네트워크 조건으로 인해 작성 환경과 게재 서비스 간의 통신이 중단됩니다.

일반 문제 해결 방법

구조화된 접근 방식은 시행착오보다 대부분의 Dynamic Media 문제를 안정적으로 해결합니다. 다음 단계를 순서대로 수행합니다.

  1. 자산이 올바르게 처리되었는지 확인합니다. 게재 및 렌더링 실패가 종종 불완전한 처리로 다시 추적되므로 소스 에셋이 완전히 업로드되고 예상 렌디션이 생성되었는지 확인합니다.
  2. 활성화 상태를 확인하십시오. 활성화가 완료되지 않은 경우 작성에 올바르게 표시되는 자산을 최종 사용자가 계속 사용할 수 없기 때문에 자산이 게재 서비스에 게시되거나 활성화되었는지 확인합니다.
  3. 게재 URL 및 렌더링 매개 변수를 확인하십시오. 게재 URL이 올바르고 크기 조정, 형식 또는 품질 매개 변수가 의도한 출력과 일치하는지 확인합니다.
  4. 환경을 격리합니다. 이 경우 오류가 발생하는 위치를 정확하게 나타내므로 작성, 게재 서비스 또는 클라이언트 브라우저에서 문제가 발생하는지 확인합니다.
  5. 구성 및 연결을 검토하십시오. 작성 환경과 Dynamic Media 게재 서비스 간의 서비스 설정, 자격 증명 및 네트워크 연결을 확인합니다.

일반적으로 문제가 발생하는 위치

일반적인 실패 지점을 이해하면 조사 대상이 되는 데 도움이 됩니다.

  • 수집 중 지원되지 않는 파일 형식, 손상된 소스 파일 또는 중단된 업로드는 일반적으로 성공적인 처리를 방해합니다.
  • 활성화 중​에 게시가 완료되지 않았거나 지연되면 작성 환경에 에셋이 있어도 게재 계층에서 누락됩니다.
  • 게재 중 캐싱, 잘못된 URL 또는 잘못 구성된 매개 변수로 인해 에셋이 느리게 로드되거나, 잘못 로드되거나, 전혀 로드되지 않습니다.

처리, 활성화 및 전달과 같은 순서로 각 단계를 확인하면 Dynamic Media 문제의 근본 원인을 효율적으로 격리하고 적절한 해결 방법을 적용할 수 있습니다.

새 Dynamic Media 구성 new-dm-config

새로운 다이내믹 미디어(DM) 구성​은(는) 이미지, 비디오 및 기타 리치 미디어를 규모에 맞게 처리, 최적화 및 제공할 수 있도록 Adobe Experience Manager Assets을 Dynamic Media에 연결합니다. Dynamic Media를 사용하면 단일 마스터 에셋에서 동적 렌디션 생성, 반응형 이미지 제공, 대화형 뷰어 및 스트리밍 비디오를 사용할 수 있으므로 미리 렌더링된 여러 변형을 저장하고 관리할 필요가 줄어듭니다.

목적 및 문제 해결 범위

새 Dynamic Media 구성을 설정하면 AEM Assets 환경과 Dynamic Media 서비스 간에 링크가 설정되므로, AEM에 업로드된 에셋을 동기화, 처리하고 최적화된 배달에 사용할 수 있습니다. Dynamic Media 기능(예: 스마트 이미징, 동적 변환 및 뷰어 임베드)이 예상대로 작동하려면 올바르게 완료된 구성이 필요합니다.

구성 문제는 일반적으로 에셋이 동기화되지 않거나, 렌디션이 생성되지 않거나, 게재 URL이 해결되지 않으면 나타납니다. 이러한 문제는 일반적으로 구성 설정이 불완전하거나 잘못 적용되었기 때문에 구성을 확인하는 것이 진단 시 권장되는 첫 번째 단계입니다.

이러한 문제를 진단하고 해결하는 방법에 대한 단계별 지침은 새 Dynamic Media 구성 문제 해결을 참조하십시오.

일반(모든 Assets) general-all-assets

다음 모범 사례는 모든 자산 유형에 적용됩니다. 이 지침을 적용하면 작업 중인 특정 유형의 자산에 관계없이 조직, 검색 가능성 및 장기 유지 가능성이 일관되게 향상됩니다.

이름 지정 및 조직

일관된 이름 지정과 구조가 관리 가능한 자산의 토대를 형성합니다. 주요 사례는 다음과 같습니다.

  • 명확하고 설명적인 이름을 사용하십시오. 일반 레이블을 사용하는 대신 각 에셋의 이름을 목적이나 콘텐츠에 따라 지정합니다. 이를 통해 프로젝트가 성장하는 동안에도 에셋을 한눈에 확인하고 나중에 검색할 수 있습니다.
  • 일관된 명명 규칙을 채택합니다. 모든 에셋에 동일한 대/소문자, 구분 기호 및 접두사를 적용하면 혼동이 줄어들고 자동화된 처리 및 정렬의 신뢰성이 향상됩니다.
  • 관련 자산을 함께 그룹화합니다. 에셋을 논리 폴더 또는 카테고리로 구성하면 대규모 컬렉션을 탐색할 수 있고 팀원이 필요한 항목을 신속하게 찾을 수 있습니다.

재사용 및 효율성

기존 에셋을 다시 사용하는 것이 에셋을 다시 만드는 것보다 효율적이며 시각적 및 기능적 일관성을 유지하는 데 도움이 됩니다. 권장되는 접근 방식은 다음과 같습니다.

  • 새 자산을 만들기 전에 기존 자산을 확인하십시오. 이를 통해 중복을 방지하고 시간을 절약하며 중복 파일이 누적되는 것을 방지할 수 있습니다.
  • 동일한 요소가 여러 위치에 나타나는 경우 공유 또는 재사용 가능한 자산을 선호합니다. 단일 소스를 중앙 집중화하면 여러 위치를 변경할 필요 없이 에셋이 사용되는 모든 곳에서 업데이트가 전파됨을 의미합니다.

유지 관리 및 품질

잘 관리된 자산은 시간이 지남에 따라 계속 사용할 수 있으며 기술 부채를 줄일 수 있습니다. 실용적인 단계는 다음과 같습니다.

  • 사용하지 않는 자산을 정기적으로 제거합니다. 더 이상 참조되지 않는 자산을 지우면 컬렉션이 희미해지고 관리가 쉬워집니다.
  • 최적화된 자산을 유지합니다. 적절한 크기의 에셋과 형식이 지정된 에셋을 사용하면 성능이 향상되고 불필요한 오버헤드가 줄어듭니다.
  • 중요 정보를 문서화합니다. 에셋의 목적, 소스 또는 사용 메모를 기록하는 것은 현재 및 향후 팀원이 각 에셋을 사용하는 방법과 위치를 이해하는 데 도움이 됩니다.

이러한 일반적인 방법에 따라 모든 특정 에셋 유형으로 전달되는 안정적인 기준선을 설정하여 개별 에셋을 보다 쉽게 생성하고, 업데이트하고, 유지 관리할 수 있습니다.

에셋 동기화 상태 속성 asset-synchronization-status-properties

Adobe Experience Manager(AEM)​에서 Dynamic Media(으)로 에셋의 성공적인 동기화를 확인하는 에셋 속성은 dam:scene7ID, dam:scene7FileStatus, dam:scene7File 및 dam:lastSyncStatus입니다. JCR(AEM 콘텐츠 저장소) 노드 구조를 검사하는 데 사용되는 브라우저 기반 개발 환경인 CRXDE Lite​에서 이러한 속성을 직접 검토하십시오. 각 속성은 Dynamic Media에 연결된 에셋의 상태에 대한 특정 신호를 제공합니다.

CRXDE Lite에서 동기화를 확인하는 방법

CRXDE Lite에서 다음 에셋 속성을 검토하여 Adobe Experience Manager에서 Dynamic Media로의 에셋의 성공적인 동기화를 확인합니다.

속성
예
설명
<object_node>/jcr:content/metadata/dam:scene7ID
a|364266
노드가 Dynamic Media에 연결되어 있다는 일반 표시기입니다. 이 값이 있으면 AEM이 자산 노드와 해당 Dynamic Media(Scene7) 대응 항목 간의 연결을 설정했음을 확인할 수 있습니다.
<object_node>/jcr:content/metadata/dam:scene7FileStatus
PublishComplete 또는 오류 텍스트
Dynamic Media에 대한 에셋 업로드의 상태입니다. PublishComplete 값은 업로드가 성공적으로 완료되었음을 나타냅니다. 이 필드의 오류 텍스트는 업로드가 완료되지 않았음을 나타냅니다.
<object_node>/jcr:content/metadata/dam:scene7File
myCompany/myAssetID
Dynamic Media에서 원격 자산에 대한 URL을 생성하려면 를 채워야 합니다. 게재 URL은 이 값에서 생성되므로 빈 dam:scene7File 속성은 에셋에 대해 Dynamic Media URL을 생성할 수 없음을 의미합니다.
<object_node>/jcr:content/dam:lastSyncStatus
성공 또는 실패:<error text>
에셋에 대한 세트(스핀 세트, 이미지 세트 등), 이미지 사전 설정, 뷰어 사전 설정, 이미지 맵 업데이트 또는 편집된 이미지의 동기화 상태입니다. 성공 값은 마지막 동기화 작업이 완료되었음을 확인하지만 실패:<error text>​은(는) 동기화를 방해하는 특정 오류를 식별합니다.

이러한 속성이 중요한 이유

각 속성은 에셋 전달 파이프라인에서 개별 체크포인트 역할을 하므로 네 가지를 모두 함께 검토하면 에셋의 동기화 상태에 대한 전체 그림을 제공합니다. dam:scene7ID 및 dam:scene7File 속성은 링크 및 파일 참조가 있는지 확인하고, dam:scene7FileStatus​은(는) 업로드 자체를 확인하고, dam:lastSyncStatus​은(는) 스핀 세트, 이미지 세트, 이미지 사전 설정, 뷰어 사전 설정 및 이미지 맵 업데이트와 같은 종속 아티팩트가 올바르게 동기화되었는지 확인합니다. 자산이 Dynamic Media에서 예상대로 전달되지 않을 때 CRXDE Lite에서 이러한 속성을 검사하면 연결, 업로드 또는 동기화 설정 등 프로세스의 어느 단계가 완료되지 않았는지를 직접 파악할 수 있습니다.

동기화 로깅 synchronization-logging

동기화 오류 및 문제는 Experience Manager 서버 디렉터리 /crx-quickstart/logs/​에 있는 error.log 파일에 기록됩니다. 이 로그는 자산 동기화 문제를 진단하기 위한 기본 참조 지점입니다.

기본 로깅 수준은 대부분의 동기화 문제의 근본 원인을 파악하는 데 충분한 세부 정보를 제공합니다. 재현하기 어려운 문제를 더 깊이 조사하기 위해 관리자는 com.adobe.cq.dam.ips 패키지의 DEBUG(으)로 로깅 세부 정보를 올릴 수 있습니다. 디버그 수준 로깅은 더 세분화된 진단 이벤트를 발생시켜 기본 수준에서 작성되지 않은 동기화 프로세스 관련 추가 컨텍스트를 캡처합니다.

동기화 로깅을 DEBUG로 늘리려면:

  1. https://localhost:4502/system/console/slinglog에서 Sling 콘솔을 엽니다.
  2. com.adobe.cq.dam.ips 패키지에 대한 로거 구성을 찾거나 추가합니다.
  3. 로그 수준을 DEBUG(으)로 설정합니다.
  4. 동기화 문제를 재현한 다음 /crx-quickstart/logs/​의 error.log​에 기록된 추가 세부 정보를 검토하십시오.

이러한 방식으로 로그 수준을 높이면 동기화 워크플로우에 대한 자세한 정보가 수집되므로 기본 로깅에서 충분한 세부 정보를 제공하지 않을 때 기본 원인을 더 쉽게 격리할 수 있습니다.

버전 제어 version-control

동일한 이름 및 위치​를 공유하는 기존 Dynamic Media 자산을 바꿀 때 Adobe Experience Manager에서는 두 가지 개별적인 처리 옵션을 제공합니다. 두 자산을 모두 유지 또는 기존 자산을 바꾸기. 버전 제어는 업로드 시 적용되는 이러한 동작을 결정합니다.

  • 두 에셋 모두 유지: 새로 업로드한 파일은 고유 이름 아래에 저장되므로 게시된 에셋 URL은 고유합니다. 예를 들어 image.jpg은(는) 원본 자산이고 image1.jpg은(는) 새로 업로드한 자산입니다. 각 파일의 이름은 그대로 유지되므로 두 에셋은 독립적으로 주소 지정 가능 및 제공 가능한 상태로 유지되므로 새로 업로드한 에셋이 원본을 덮어쓰지 못합니다.

  • 버전을 만드는 중: Dynamic Media에서 버전을 만드는 것이 지원되지 않음. 따라서 새 업로드는 버전 기록에 추가되지 않습니다. 대신 새 자산이 게재의 기존 자산을 바꿉니다. 즉, 이전에 게시된 파일이 대체되고 업데이트된 콘텐츠가 대신 제공됩니다. 이전 버전은 게재에 유지되지 않으므로 게재된 에셋에 대해 대체 기능이 영구적으로 유지됩니다.

이미지 및 집합 images-and-sets

아래 문제 해결 지침을 사용하여 이미지 및 세트와 관련된 일반적인 문제를 해결하십시오. 이미지 및 세트 오류는 일반적으로 지원되지 않는 형식, 불완전한 업로드, 잘못된 이름 지정, 캐시 충돌 또는 구성 불일치에서 비롯됩니다. 문제의 범주를 먼저 식별하는 것은 대부분의 이미지 및 세트 오류가 적은 수의 반복 패턴에 포함되기 때문에 빠른 수정 시 가장 안정적인 경로입니다.

일반적인 이미지 및 세트 문제

이미지 및 세트에서 가장 자주 발생하는 문제는 다음과 같습니다.

  • 이미지가 표시되지 않음 — 끊겼거나, 비어 있거나, 누락된 이미지는 종종 잘못된 파일 경로, 지원되지 않는 파일 형식 또는 업로드 실패를 나타냅니다.
  • 잘못되거나 오래된 이미지 — 업데이트 후 이전 버전이 나타나면 일반적으로 새로 고쳐지지 않은 캐시된 콘텐츠가 원인입니다.
  • 집합이 완전히 로드되지 않음 — 부분 집합이나 불완전한 집합은 일반적으로 멤버 항목 누락, 참조 끊김 또는 동기화 중단으로 인해 발생합니다.
  • 서식 지정 또는 해상도 문제 — 왜곡되거나, 늘어나거나, 품질이 낮은 이미지는 일반적으로 요구 사항과 일치하지 않는 크기, 종횡비 또는 해상도 설정을 가리킵니다.
  • 권한 또는 액세스 오류 — 로드에 실패한 이미지 또는 집합은 액세스 권한 또는 만료된 링크에 의해 제한될 수 있습니다.

단계별 문제 해결

각 단계는 더 연관성이 높은 솔루션으로 이동하기 전에 일반적인 원인을 배제하므로 다음 단계를 순서대로 수행하십시오.

  1. 파일 형식 및 크기를 확인합니다. 이미지가 지원되는 형식을 사용하고 허용된 크기 제한 내에 있는지 확인합니다. 이렇게 하면 시스템에서 변환 오류 없이 파일을 렌더링할 수 있습니다.
  2. 업로드가 완료되었는지 확인합니다. 업로드가 중단되면 이미지가 손상될 수 있으므로 누락되거나 손상된 것으로 보이는 이미지를 다시 업로드하십시오.
  3. 캐시를 지우고 새로 고칩니다. 브라우저 또는 애플리케이션 캐시를 지우면 최신 버전이 로드되어 오래된 이미지가 표시되는 경우가 해결됩니다.
  4. 파일 경로 및 참조를 확인하십시오. 끊어진 경로로 인해 이미지가 로드되지 않으므로 각 이미지를 확인하고 참조점을 기존의 유효한 위치로 설정하십시오.
  5. 권한 및 액세스 설정을 검토합니다. 이미지 또는 세트에 액세스할 수 있으며 공유 링크가 만료되지 않았는지 확인합니다.
  6. 대체 환경에서 테스트합니다. 이미지 또는 세트를 다른 브라우저, 장치 또는 세션에 로드하여 문제가 시스템이 아닌 로컬인지 확인합니다.

이미지 및 설정 오류 방지

반복되는 문제를 줄이려면 다음과 같은 예방 수칙을 적용합니다.

  • 모든 이미지 및 세트에서 일관되고 지원되는 파일 형식 및 이름 지정 규칙을 사용합니다.
  • 계속하기 전에 각 업로드가 완전히 종료되는지 확인하십시오. 이렇게 하면 일부 또는 손상된 파일이 방지됩니다.
  • 멤버 항목이 누락되거나 분리되지 않도록 이미지 참조를 계속 동기화하고 멤버를 설정합니다.
  • 업데이트를 수행한 후 캐시된 콘텐츠를 새로 고쳐 현재 버전이 항상 제공되도록 합니다.
문제
디버깅하는 방법
솔루션
자산 세부 사항 보기의 URL/포함 복사 단추에 액세스할 수 없음

  1. CRX/DE로 이동:

    • JCR /etc/dam/presets/viewer/<preset> has lastReplicationAction의 사전 설정이 정의되어 있는지 확인합니다. 이 위치는 Experience Manager 6.x에서 6.4로 업그레이드하고 마이그레이션을 옵트아웃한 경우에 적용됩니다. 그렇지 않으면 위치는 /conf/global/settings/dam/dm/presets/viewer입니다.
    • JCR의 에셋에 dam:scene7FileStatus 이(가) 있는지 확인하십시오.PublishComplete

페이지 새로 고침/다른 페이지로 이동한 다음 돌아가기(사이드 레일 JSP를 다시 컴파일해야 함)

작동하지 않는 경우:

  • 자산을 게시합니다.
  • 에셋을 다시 업로드하고 게시합니다.
슬라이드 간을 전환한 후 슬라이드 핫스팟이 이동합니다.
모든 슬라이드의 크기가 같은지 확인합니다.
회전판에 대해 크기가 같은 이미지만 사용하십시오.
이미지가 Dynamic Media 뷰어로 미리 표시되지 않음
메타데이터 속성(CRXDE Lite)에서 에셋에 dam:scene7File이(가) 포함되어 있는지 확인
모든 에셋이 처리를 완료했는지 확인합니다.
업로드된 에셋이 에셋 선택기에 표시되지 않음
자산에 속성 jcr:content > dam:assetState = processed(CRXDE Lite)이 있는지 확인
모든 에셋이 처리를 완료했는지 확인합니다.
자산 처리를 시작하지 않은 경우 카드 보기의 배너에 새로 만들기가 표시됩니다.
에셋 jcr:content > dam:assetState = unprocessed이(가) 워크플로에서 선택되지 않은 경우 확인.
워크플로우에서 에셋을 가져올 때까지 기다립니다.
이미지 또는 집합은 뷰어 URL 또는 포함 코드를 표시하지 않습니다
뷰어 사전 설정이 게시되었는지 확인합니다.
도구 > Assets > 뷰어 사전 설정(으)로 이동하여 뷰어 사전 설정을 게시합니다.

이 문제 해결 단계를 완료한 후에도 문제가 지속되면 특정 이미지나 영향을 받는 세트에 대한 세부 정보, 이미 시도한 단계 및 관찰된 오류 메시지를 지원하도록 문제를 에스컬레이션하십시오. 이러한 정보를 제공하면 근본 원인을 보다 효율적으로 식별하는 데 도움이 됩니다.

비디오 video

비디오 재생 문제는 가장 일반적인 기술 문제 중 하나이며 대부분의 문제는 몇 가지 표준 문제 해결 단계를 통해 해결됩니다. 비디오가 로드되지 않거나 고정된 것처럼 보이거나 소리 없이 재생되거나 화면이 까맣게 표시되는 경우 아래 지침을 사용하여 문제를 식별하고 해결하십시오.

비디오 문제의 일반적인 원인

대부분의 비디오 문제는 예측 가능한 몇 가지 원인으로 인해 발생합니다. 원인을 이해하면 올바른 수정 사항을 적용하는 데 도움이 됩니다.

  • 네트워크 연결이 부족하거나 불안정한 경우 — 스트리밍 비디오를 사용하려면 일관된 대역폭이 필요합니다. 약한 연결 또는 변동하는 연결은 버퍼링, 지연 또는 품질 자동 다운그레이드를 유발합니다.
  • 오래된 브라우저나 응용 프로그램 — 이전 소프트웨어가 현재 비디오 형식이나 재생 표준을 지원하지 않아 오류가 발생하거나 화면이 비어 있을 수 있습니다.
  • 손상된 캐시 또는 쿠키 - 저장된 임시 데이터가 새 비디오 콘텐츠와 충돌하여 올바르게 로드되지 않을 수 있습니다.
  • 브라우저 확장 프로그램 또는 광고 차단기 — 특정 확장 프로그램은 재생에 필요한 스크립트를 차단하여 비디오 플레이어를 방해합니다.
  • 오래된 그래픽 드라이버 또는 하드웨어 가속 충돌 — 검은색 화면, 재생 불량 또는 충돌이 자주 발생합니다.
  • 오디오 또는 코덱 비호환성 — 누락되었거나 지원되지 않는 코덱으로 인해 비디오가 사운드 없이 재생되거나 완전히 렌더링되지 않을 수 있습니다.

단계별 비디오 문제 해결

다음 단계를 순서대로 수행합니다. 각 단계에서는 가장 가능성이 높은 원인을 먼저 해결하므로 이후 단계에 도달하기 전에 문제가 해결되는 경우가 많습니다.

  1. 인터넷 연결을 확인하세요. 다른 웹 사이트 및 서비스가 정상적으로 로드되는지 확인합니다. 느린 연결 또는 끊기는 버퍼링 및 재생 실패의 주요 원인입니다. 가능한 경우 유선 연결로 전환하거나 무선 라우터에 가깝게 이동합니다.
  2. 페이지를 새로 고치고 재생을 다시 시작합니다. 다시 로드하면 일시적인 로드 오류가 지워지고 비디오 소스에 대한 연결이 다시 설정됩니다.
  3. 브라우저 또는 응용 프로그램을 업데이트합니다. 최신 버전을 실행하면 현재 비디오 형식 및 재생 기능과의 호환성이 보장됩니다.
  4. 캐시와 쿠키를 지웁니다. 저장된 임시 데이터를 제거하면 충돌이 발생하여 비디오가 로드되지 않습니다. 이후에 브라우저를 다시 시작합니다.
  5. 확장 및 광고 차단기를 사용하지 않도록 설정합니다. 이러한 기능을 일시적으로 해제하여 둘 중 하나가 비디오 플레이어를 차단하는지 확인합니다. 비디오가 작동하는 경우 한 번에 하나씩 확장을 다시 활성화하여 소스를 식별합니다.
  6. 비디오 품질을 낮춥니다. 비디오가 반복해서 재생되지만 중지되는 경우 낮은 해상도를 선택하면 필요한 대역폭이 줄어들어 더 원활한 재생이 가능합니다.
  7. 그래픽 드라이버를 업데이트하거나 하드웨어 가속을 전환합니다. 오래된 드라이버는 시각적 결함 및 검은색 화면을 유발합니다. 문제가 지속되면 브라우저 설정에서 하드웨어 가속을 비활성화하면 렌더링 문제가 해결되는 경우가 많습니다.
  8. 다른 브라우저나 장치를 사용해 보세요. 비디오가 다른 곳에서 재생되는 경우 문제는 비디오 소스 자체보다는 원래 브라우저나 장치에 따라 다릅니다.

추가 지원을 요청할 때

위의 모든 단계를 완료한 후에도 비디오 문제가 계속되면 비디오 소스 또는 보다 심층적인 시스템 구성에서 문제가 발생할 수 있습니다. 이 경우 진단 속도를 높이기 때문에 지원팀에 문의하기 전에 다음 세부 사항을 알아 두십시오.

  • 화면에 표시되는 내용에 대한 정확한 오류 메시지 또는 설명
  • 브라우저 또는 애플리케이션 이름 및 버전
  • 운영 체제 및 장치 유형
  • 모든 비디오에서 문제가 발생하는지 아니면 특정 비디오에서만 문제가 발생하는지 여부
문제
디버깅하는 방법
솔루션
비디오를 미리 볼 수 없음
  • 폴더에 비디오 프로필이 할당되었는지 확인합니다(지원되지 않는 파일 형식인 경우). 지원되지 않는 경우 이미지만 표시됩니다.
  • 비디오 프로필에는 AVS 세트를 생성하기 위해 인코딩 사전 설정이 두 개 이상 포함되어야 합니다(단일 인코딩은 MP4 파일에 대한 비디오 콘텐츠로 처리됨. 지원되지 않는 파일의 경우 처리되지 않은 것과 동일하게 처리됨).
  • 메타데이터에서 dam:scene7FileAvs/dam:scene7File을(를) 확인하여 비디오가 처리를 완료했는지 확인하십시오.
  1. 폴더에 비디오 프로필을 할당합니다.
  2. 인코딩 사전 설정을 두 개 이상 포함하도록 비디오 프로필을 편집합니다.
  3. 비디오가 처리를 완료할 때까지 기다립니다.
  4. 비디오를 다시 로드하기 전에 Dynamic Media 인코딩 비디오 워크플로우가 실행되고 있지 않은지 확인하십시오.
  5. 비디오를 다시 업로드합니다.
비디오가 인코딩되지 않음
  • Dynamic Media Cloud Service이 구성되어 있는지 확인합니다.
  • 비디오 프로필이 업로드 폴더와 연결되어 있는지 확인합니다.
  1. 클라우드 서비스 아래의 다이내믹 미디어 구성이 제대로 설정되어 있는지 확인하십시오.
  2. 폴더에 비디오 프로필이 있는지 확인합니다. 또한 비디오 프로필을 확인합니다.
비디오 처리 시간이 너무 오래 걸림

비디오 인코딩이 계속 진행 중인지 또는 실패 상태에 들어왔는지 확인하려면 다음을 수행하십시오.

  • 비디오 상태 https://localhost:4502/crx/de/index.jsp#/content/dam/folder/videomp4/jcr%3Acontent 확인 > dam:assetState
비디오 렌디션 누락

비디오가 업로드되지만 인코딩된 변환은 없습니다.

  • 폴더에 할당된 비디오 프로필이 있는지 확인합니다.
  • 메타데이터에서 dam:scene7FileAvs을(를) 확인하여 비디오가 처리를 완료했는지 확인하십시오.
  1. 폴더에 비디오 프로필을 할당합니다.
  2. 비디오가 처리를 완료할 때까지 기다립니다.

이 정보를 제공하면 문제를 재현하고 원인이 장치에 로컬인지 또는 비디오 서비스 자체에 영향을 주는지 여부를 식별할 수 있습니다.

Viewers viewers

뷰어에는 콘텐츠가 올바르게 렌더링되지 않는 재생, 로드, 표시 및 호환성 문제가 발생할 수 있습니다. 아래 문제 해결 지침은 가장 일반적인 뷰어 문제를 해결하고 이를 해결하기 위한 단계별 경로를 제공합니다.

일반적인 뷰어 문제

뷰어 문제는 일반적으로 몇 가지 인식 가능한 범주에 속합니다.

  • 컨텐츠 로드 실패 — 뷰어가 열리지만 예상 컨텐츠 대신 빈 화면, 회전기 또는 오류 메시지가 표시됩니다.
  • 재생 또는 렌더링 오류 - 콘텐츠가 부분적으로 로드되거나, 고정되거나, 잘못 표시됩니다.
  • 호환성 문제 — 뷰어가 특정 브라우저, 장치 또는 운영 체제에서 예상대로 작동하지 않습니다.
  • 성능 문제 — 사용 중 로드 속도가 느려지거나 지연되거나 응답이 없습니다.

대부분의 뷰어 문제는 오래된 소프트웨어, 브라우저 캐시 충돌, 차단된 스크립트, 불안정한 네트워크 연결 또는 지원되지 않는 파일 형식 등 사소한 기본 원인에서 기인합니다. 어떤 카테고리가 적용되는지 파악하는 것이 빠른 해상도를 위한 첫 단계입니다.

문제 해결 단계

이전 단계에서 가장 자주 발생하는 문제를 해결하므로 다음 단계를 순서대로 수행하십시오.

  1. 뷰어를 새로 고치고 다시 로드합니다. 페이지를 다시 로드하거나 뷰어를 다시 열어 일시적인 로딩 문제가 해결되는 경우가 많습니다.
  2. 브라우저 캐시와 쿠키를 지웁니다. 오래된 캐시된 데이터는 빈 화면과 오래된 콘텐츠의 일반적인 원인이므로 이 데이터를 지우면 뷰어가 새로운 리소스를 다시 로드해야 합니다.
  3. 브라우저 또는 응용 프로그램을 업데이트합니다. 최신 버전을 실행하면 뷰어의 렌더링 요구 사항과 호환됩니다.
  4. 다른 브라우저나 장치를 사용해 보세요. 이 경우 문제가 한 환경에 한정되는지 또는 콘텐츠 자체에 영향을 주는지 여부가 격리됩니다.
  5. 네트워크 연결을 확인하십시오. 불안정한 연결 또는 제한된 연결은 뷰어가 컨텐츠를 검색할 수 없도록 하므로 안정적인 연결을 확인하면 많은 로드 오류가 해결됩니다.
  6. 충돌하는 확장 또는 차단기를 사용하지 않도록 설정합니다. 광고 차단기, 스크립트 차단기 및 개인 정보 보호 확장은 뷰어 기능을 방해할 수 있습니다. 일시적으로 비활성화하면 원인이 무엇인지 확인하는 데 도움이 됩니다.

이 단계를 완료한 후에도 문제가 지속되면 로컬 환경이 아닌 콘텐츠 소스 또는 뷰어 구성에서 문제가 발생할 수 있으므로 추가 진단 지원이 필요할 수 있습니다.

문제: 뷰어 사전 설정이 게시되지 않음 viewers-not-published

증상: 뷰어 사전 설정이 게시(활성화)되지 않았으므로 Dynamic Media 뷰어가 전달된 에셋에 대해 올바르게 렌더링되지 않습니다. 이 문제를 해결하려면 활성화 상태를 확인하고 활성화되지 않은 사전 설정을 게시해야 합니다.

디버깅하는 방법: 뷰어 사전 설정 활성화 상태 확인

다음 단계에 따라 뷰어 사전 설정이 게시되지 않는 이유를 식별합니다.

  1. 샘플 관리자 진단 페이지 https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html(으)로 진행합니다.

  2. 진단 페이지에서 보고한 계산된 값을 확인합니다. 시스템이 올바르게 작동하면 진단 페이지에서 다음을 보고합니다. _DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets. 여기서 DMSAMPLE 상태는 Dynamic Media 샘플 자산을 참조하고 OOTB 상태는 기본 뷰어 자산을 참조합니다. 0개의 동기화되지 않은 자산 및 0개의 활성화되지 않은 자산​의 카운트에서 모든 항목이 예상대로 동기화되고 활성화되었음을 확인합니다.

    note
    NOTE
    뷰어 자산을 동기화할 Dynamic Media 클라우드 설정을 구성한 후 10분​정도 걸릴 수 있습니다. 카운트가 아직 0이 아니면 이 동기화 창이 완료될 때까지 기다렸다가 문제를 계속 해결하십시오.

  3. 활성화되지 않은 에셋이 남아 있는 경우 하나 이상의 뷰어 사전 설정이 게시되지 않았음을 나타냅니다. 활성화되지 않은 모든 Assets 나열 단추 중 하나를 선택하여 활성화가 필요한 에셋에 대한 세부 정보를 확인합니다.

솔루션: 뷰어 사전 설정을 게시합니다

활성화되지 않은 자산은 게시되지 않은 사전 설정에서 비롯되므로 이를 명시적으로 게시하는 것이 해결되었습니다.

  1. 관리 도구의 뷰어 사전 설정 목록으로 이동합니다. https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html.
  2. 모든 뷰어 사전 설정을 선택한 다음 게시​를 선택합니다. 게시 는 사전 설정을 활성화하여 관련된 에셋을 동기화하여 게재할 수 있도록 함으로써 활성화되지 않은 상태를 지웁니다.
  3. 다시 샘플 관리자로 이동하여 활성화되지 않은 자산 수가 현재 0​인지 확인하십시오. 제로 카운트는 뷰어 사전 설정이 성공적으로 게시되었고 문제가 해결되었는지 확인합니다.

문제: 뷰어 사전 설정 아트워크가 자산 세부 사항의 미리보기 또는 URL/포함 코드 복사에서 404를 반환함 viewer-preset-404

디버깅하는 방법: 동기화 상태를 확인하고 아트웍을 직접 요청

CRXDE Lite(Adobe Experience Manager 저장소용 개발자 콘솔)에서 다음 단계를 수행합니다.

  1. Dynamic Media 동기화 폴더(예: /content/dam/_CSS/_OOTB) 내의 <sync-folder>/_CSS/_OOTB 폴더로 이동합니다.

  2. 문제가 있는 자산의 메타데이터 노드를 찾습니다(예: <sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/).

  3. dam:scene7* 속성이 있는지 확인하십시오. 에셋이 동기화되어 게시되면 dam:scene7FileStatus 속성이 PublishComplete(으)로 설정되어 에셋이 동기화되어 게시되었음을 확인합니다. 이 dam:scene7* 속성이 없으면 에셋이 동기화 및 게시 워크플로우를 완료하지 못했습니다. 이 워크플로우는 404의 근본 원인입니다.

  4. 다음 속성 및 문자열 리터럴 값을 연결하여 Dynamic Media에서 직접 아트워크를 요청합니다. 성공적인 직접 요청은 아트워크가 Dynamic Media 서버에 존재하는지 확인하고 404 는 아트워크가 게시된 적이 없음을 확인합니다.

    • dam:scene7Domain
    • "is/content"
    • dam:scene7Folder
    • <asset-name>
      예: https://<server>/is/content/myfolder/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png

해결 방법: 복사 및 동기화 프로세스 다시 시작

직접 요청이 실패하거나 dam:scene7* 속성이 누락된 경우 샘플 에셋 또는 뷰어 사전 설정 아트워크가 동기화되거나 게시되지 않았습니다. 따라서 전체 복제/동기화 프로세스를 다시 시작합니다.

  1. CRXDE Lite으로 이동합니다.
  2. <sync-folder>/_CSS/_OOTB 삭제. 이렇게 하면 오래된 동기화되지 않은 아트웍 폴더가 제거되어 깔끔하게 다시 생성될 수 있습니다.
  3. CRX 패키지 관리자(저장소 패키지 설치 도구)로 이동합니다. https://localhost:4502/crx/packmgr/.
  4. 목록에서 뷰어 패키지를 검색합니다. 해당 패키지는 cq-dam-scene7-viewers-content(으)로 시작합니다.
  5. 다시 설치​를 선택합니다. 이 패키지를 다시 설치하면 기본 뷰어 사전 설정 콘텐츠가 복원됩니다.
  6. 클라우드 서비스에서 Dynamic Media 구성 페이지로 이동한 다음 Dynamic Media - S7 구성에 대한 구성 대화 상자를 엽니다.
  7. 변경하지 않고 저장​을 선택합니다.
    이 저장 작업은 구성 논리를 다시 트리거합니다. Dynamic Media - S7 구성을 다시 저장하면 Experience Manager에서 샘플 자산, 뷰어 사전 설정 CSS 및 아트워크를 다시 만들고 다시 동기화하여 404 오류를 해결할 수 있기 때문입니다.

문제: 대역폭 및 저장소 탭을 열 때 오류 #2046 발생 error-2046-bandwidth-storage

원인: 캐시된 RSL의 서명 인증서가 만료되었습니다

Dynamic Media Classic의 대역폭 및 저장소 탭에 오류가 #2046

사용자가 리치 미디어를 호스팅, 관리 및 전달하는 데 사용되는 Adobe 자산 관리 도구인 Dynamic Media Classic(Scene7) 데스크톱 응용 프로그램에서 대역폭 및 저장소 탭을 열면 오류 #2046​이(가) 나타납니다. 이 오류는 Adobe AIR(Adobe Integrated Runtime) 프레임워크에서 사용하는 캐시된 RSL(Runtime Shared Library)​에 포함된 만료된 디지털 서명 인증서​로 인해 발생합니다.

로컬 인증서를 다시 확인하는 동안 오류가 트리거됩니다: 응용 프로그램에서 캐시된 RSL을 로드하면 서명 인증서를 확인하려고 시도하며, 캐시된 인증서가 만료되었으므로 유효성 검사가 실패하고 오류 #2046이 발생합니다. 문제는 애플리케이션 자체가 아니라 로컬에 저장된 라이브러리에 있으므로 수정 사항은 오래된 캐시된 파일을 제거하여 현재 유효하게 서명된 RSL을 검색할 수 있도록 하는 것입니다.

해결 방법: 로컬 Adobe AIR 캐시 지우기

Adobe AIR​에서 업데이트된 RSL(런타임 공유 라이브러리)​을(를) 강제로 다운로드하려면 로컬 캐시를 지우십시오. 오래된 캐시된 파일을 삭제하면 만료된 인증서가 제거되고, 다음 번에 Adobe AIR에서 로컬 인증서 유효성 재검사를 통과하는 새로 서명된 RSL을 다운로드하여 오류를 해결합니다.

macOS

  1. 다음으로 이동합니다.
    ~/Library/Caches/Adobe/Flash Player/AssetCache/<folder>/
  2. .swz 및 .heu 파일을 모두 삭제합니다.

Windows

  1. 다음으로 이동합니다.
    %APPDATA%\Adobe\Flash Player\AssetCache\<folder>\
  2. 폴더 내의 모든 파일을 삭제합니다.

캐시를 지운 후 응용 프로그램을 다시 시작합니다. 다시 시작할 때 대역폭 및 저장소 탭을 다시 열어 업데이트된 RSL이 다운로드되고 유효성이 검사되었음을 나타내는 오류 #2046이 더 이상 나타나지 않는지 확인합니다.

문제: 뷰어 사전 설정 작성에서 이미지 미리 보기를 로드할 수 없음 image-preview-not-loading

솔루션

부실 샘플 콘텐츠 및 캐시된 뷰어 사전 설정 아티팩트가 미리 보기를 렌더링하지 못하는 경우 뷰어 사전 설정 작성에서 이미지 미리 보기​를 로드할 수 없습니다. 이러한 아티팩트를 지우고 Dynamic Media 구성을 다시 만들어 미리보기를 복원합니다.

  1. Experience Manager에서 Experience Manager 로고를 선택하여 전역 탐색 콘솔에 액세스한 다음 도구 > 일반 > CRXDE Lite(으)로 이동합니다.

  2. 왼쪽 레일에서 다음 위치의 샘플 콘텐츠 폴더로 이동합니다.

    /content/dam/_DMSAMPLE

  3. _DMSAMPLE 폴더를 삭제합니다. 이렇게 하면 미리 보기가 올바르게 렌더링되지 않도록 차단할 수 있는 오래된 샘플 콘텐츠가 제거됩니다.

  4. 왼쪽 레일에서 다음 위치의 presets 폴더로 이동합니다.

    /conf/global/settings/dam/dm/presets/viewer

  5. viewer 폴더를 삭제합니다. 이 폴더를 제거하면 캐시된 뷰어 사전 설정 설정이 지워지므로 깔끔하게 다시 생성됩니다.

  6. CRXDE Lite 페이지의 왼쪽 상단 모서리 근처에서 모두 저장​을 선택하여 저장소에 삭제 내용을 커밋합니다.

  7. CRXDE Lite 페이지의 왼쪽 상단 모서리에서 홈으로 돌아가기 아이콘을 선택합니다.

  8. 클라우드 서비스에서 Dynamic Media 구성을 다시 만듭니다. 이 단계에서는 제거된 샘플 콘텐츠 및 뷰어 사전 설정을 다시 생성하여 뷰어 사전 설정 작성에서 이미지 미리 보기​를 복원합니다.

recommendation-more-help
experience-manager-cloud-service-help-main-toc