설명서AEMAEM Screens 안내서

AEM SCREENS FAQ aem-screens-faqs

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 중간
  • 개발자

이 주제에서는 AEM Screens 프로젝트와 관련하여 자주 묻는 FAQ에 대한 답변을 제공합니다.

빈 화면 문제 blank-screen

NOTE
나열된 필수 검사는 문제를 제기하기 전에 기본 지원 또는 고객 측 지원에서 시도해야 합니다.

1. 검은색 화면이나 재생되지 않는 콘텐츠가 있는 고객을 위한 응급 처치 문제 해결 단계는 무엇입니까? troubleshooting-blank-screen

  • 채널 미리 보기가 작동하는지 확인합니다.
  • 디스플레이 미리 보기가 작동하는지 확인
  • 플레이어를 동일한 디스플레이에 시스템의 브라우저 확장으로 등록하고 작동하는지 확인하십시오.
  • 시스템에서 실행 중인 플레이어를 사용하여 http://localhost:24502(으)로 이동합니다. 모든 콘텐츠가 올바르게 다운로드되었는지 확인합니다.
  • 에셋을 검사하여 적절한 렌디션이 만들어지고 올바른 렌디션이 재생되는지 확인합니다.
  • 예약된 컨텐츠가 있는지 확인하고 시간이 올바른지 확인합니다. 플레이어에서 설정한 시간이 올바른지 확인합니다.
  • Inspect 플레이어 콘솔이 로그인하여 오류가 있는지 확인합니다. 마우스 오른쪽 버튼을 클릭하고 을 검사하여 콘솔 로그를 확인합니다. Windows Player를 사용하는 경우 CTRL + ALT +I을(를) 눌러 로그를 볼 수 있는 개발 콘솔을 표시합니다.

2. 기본 채널 또는 일정을 만들어 AEM Screens의 회색 화면 문제를 해결하는 방법

필드에 빈 화면이나 회색 화면을 표시하지 않으려면 우선 순위가 가장 낮은 모든 디스플레이에 할당된 기본 전역 채널 또는 일정을 만듭니다. 플레이어에서 이 콘텐츠를 디스크에 이미 캐시했기 때문에 콘텐츠 업데이트에 문제가 발생하는 경우. 그것은 잘 연주하고 회색 화면을 피해야 합니다.

채널 또는 일정과 같은 다른 모든 콘텐츠는 우선 순위가 1보다 크므로 다른 콘텐츠는 우선 순위를 취하고 전역 채널 또는 일정 콘텐츠(우선 순위 1을 가진)는 폴백 옵션으로만 재생됩니다.

채널 관리 channel-management

1. 온라인 채널과 오프라인 채널의 차이점은 무엇입니까? what-is-the-difference-between-an-online-and-an-offline-channel

온라인 채널 ​은 실시간 환경에서 업데이트된 콘텐츠를 표시하지만 오프라인 채널 ​은 캐시된 콘텐츠를 표시합니다.

2. 온라인으로 채널을 만들려면 어떻게 해야 합니까? how-do-i-make-a-channel-online

채널을 클릭하고 작업 표시줄에서 채널 속성으로 이동합니다. 채널을 온라인 상태로 설정하려면 채널 탭에서 개발자 모드(온라인 상태로 강제 설정) ​를 확인하십시오.

3. 채널 역할 필드의 용도는 무엇입니까? what-is-the-use-of-the-channel-role-field

채널 역할은 작성자가 일반 경험에 직접 집중할 수 있도록 실행되는 실제 채널의 추상화입니다. 컨텍스트에서 채널을 고유하게 식별하는 일종의 태그(표시 또는 예약)로 생각할 수 있습니다.

4. 실제 채널 확인은 어떻게 수행됩니까? how-does-actual-channel-resolution-happen

정적 참조 ​의 경우 확인은 지정된 경로를 따릅니다.

동적 참조 ​의 경우 채널이 디스플레이에 할당되면(일정이 아님) 해결이 발생합니다. 표시 경로는 채널의 컨텍스트가 되며 해상도는 다음과 같이 발생합니다(최고 우선 순위에서 최저 우선 순위).

  1. 디스플레이에는 참조된 채널 이름과 일치하는 하위 노드가 있습니다
  2. 디스플레이에는 참조된 채널 이름과 일치하는 형제 노드가 있습니다
  3. 디스플레이의 상위 위치에는 참조된 채널 이름과 일치하는 하위 노드가 있습니다
  4. 디스플레이의 부모 위치에 참조된 채널 이름과 일치하는 자식 노드가 있습니다.

위치 폴더에 도달할 때까지 계속됩니다. 지금은 중지합니다(예를 들어 채널 폴더에 있는 채널은 참조할 수 없으며 위치 하위 트리의 채널만).

5. AEM Screens 채널에서 사용자 지정 clientlib 오프라인 구성을 설정하는 방법

AEM Screens 채널에서 빌드된 사용자 지정 클라이언트측 코드 clientlib을(를) 사용하는 경우 다음 단계가 필요합니다. clientlib 파일이 채널(manifest.json)에 성공적으로 로드되었고 clientlib의 경로가 포함되어 있는지 확인합니다.

채널 편집기에서 아래 단계를 수행합니다.

  1. 채널을 클릭한 다음 작업 표시줄에서 편집 ​을 클릭합니다.
  2. 사용자 지정 clientlib을(를) 추가할 구성 요소를 클릭합니다.
  3. 구성 단추(렌치 아이콘)를 클릭합니다.
  4. 오프라인 구성 탭으로 이동하여 클라이언트측 라이브러리 ​에서 사용자 지정 clientlib에 경로를 추가합니다.

장치 등록 device-registration

1. 장치 온보딩 및 등록 요청과 같은 끝점을 찾으면 많은 장치를 스크립팅하고 이러한 장치를 등록할 수 있습니다. 분기 Wi-Fi에 잠그는 것 외에 이러한 요청을 보호할 수 있습니까? if-i-discover-endpoints-such-as-requests-for-device-onboarding-and-registration-i-can-script-a-large-number-of-devices-and-register-these-devices-besides-locking-this-to-a-branch-wi-fi-is-it-possible-to-secure-these-requests

현재 등록은 작성자 인스턴스에서만 가능합니다. 등록 서비스는 인증되지 않지만 AEM에서 보류 중인 장치만 만들고 실제로 장치를 등록하거나 디스플레이를 할당하지 않습니다.

장치를 등록하려면(AEM에서 장치에 대한 사용자 만들기) AEM에 인증하고 등록 마법사에 따라 수동으로 등록을 완료합니다. 이론적으로 악의적인 사용자는 여러 개의 보류 중인 장치를 만들 수 있지만 AEM 로그인이 없는 경우에는 어떤 장치도 등록할 수 없습니다.

2. 일부 인증 형식을 사용하여 HTTP GET 요청을 HTTP POST으로 변환하는 방법이 있습니까? is-there-a-way-to-transform-http-get-requests-into-http-post-with-some-form-of-authentication

등록 요청은 POST 요청입니다.

매개 변수로 전달되지 않고 세션에서 장치 ID를 가져오는 것이 좋습니다. 이렇게 하면 서버 로그, 브라우저 캐시 등이 정리됩니다. 보안 문제가 아닙니다. 의미상. GET은 서버에서 상태 변경이 없을 때 사용되고 POST은 상태 변경이 있을 때 사용됩니다.

3. 디바이스 등록 요청을 거절할 방법이 있습니까? is-there-a-way-to-decline-a-device-registration-request

등록 요청을 거부할 수 없습니다. 대신 등록 요청은 Adobe Experience Manager Web Console에 구성된 시간 제한 후에 만료되어야 합니다. 기본적으로 이 값은 하루로 설정되고 메모리 캐시에 저장됩니다.

장치 모니터링 및 상태 보고서 device-monitoring-and-health-reports

1. AEM Screens 플레이어에서 빈 화면이 표시되는 경우 어떻게 문제를 해결합니까?

빈 화면 문제를 해결하기 위해 다음 가능성을 확인하십시오.

  • AEM에서 오프라인 콘텐츠를 푸시할 수 없음
  • 채널에 콘텐츠가 없습니다.
  • 현재 예약된 에셋이 없습니다.

2. AEM Screens Player가 등록할 수 없고 상태가 실패로 표시되면 어떻게 해야 합니까?

Apache Sling Referrer 필터 허용 을 활성화합니다. AEM Screens Player와 AEM Screens 서버 간 제어 프로토콜의 최적 작동에 필요합니다.

  1. Adobe Experience Manager 웹 콘솔 구성(으)로 이동
  2. allow.empty 옵션을 선택하십시오.
  3. 저장 ​을 클릭합니다.

3. AEM Screens 플레이어를 등록하는 동안 장치에 FAILURE가 표시되고 콘솔 로그에 ENAME_NOT_FOUND 오류가 표시되는 경우 문제를 해결하는 방법

플레이어가 AEM Screens 서버 DNS를 찾을 수 없는 경우 이 문제가 발생할 수 있습니다. IP 주소를 사용하여 연결을 시도할 수 있습니다. 서버의 IP를 가져오려면 arp <server_dns_name> ​을(를) 사용합니다.

4. AMS는 모든 장치에서 Android™ Watchdog를 구현하는 것을 권장합니까? Watchdog (Cordova) 플러그인이 APK의 일부로 포함됩니까? does-ams-recommend-implementing-an-android-watchdog-on-all-devices-is-the-watchdog-cordova-plugin-included-as-part-of-the-apk

순수 Android™ API를 사용하는 교차 플랫폼 Android™ 감시자는 이미 APK의 일부입니다. 추가 소프트웨어가 필요하지 않습니다. 그러나 사용하는 장치에 따라 필요한 경우 APK를 종료하여 전체 전원 주기(Powermanager api)에 대한 시스템 권한을 얻을 수 있습니다. 제조업체 키를 사용하여 종료하지 않으면 애플리케이션이 종료되고 다시 시작되지만 전원 사이클은 켜지지 않습니다.

Android™ Player 구현 방법에 대한 자세한 내용은 Android™ Player 구현 ​을 참조하십시오.

5. Adobe/AMS는 각 장치를 모니터링하기 위해 권장하는 타사 원격 모니터링 및 경고 도구(소프트웨어)를 선택하십시오. what-third-party-remote-monitoring-and-alerting-tools-software-does-adobe-ams-recommend-for-monitoring-each-device

모니터링 및 경고에서 원하는 내용에 따라 새로운 기능 AEM Screens 알림 서비스는 장치가 잠시 동안 핑되지 않았을 때 알려줍니다. 타사 도구는 운영 체제(OS), 해당 기능 및 고객의 특정 요구 사항에 따라 다릅니다.

장치 활동을 모니터링할 수 있는 위치에 대한 자세한 내용은 AEM 화면 ns 알림 서비스 ​를 참조하십시오.

AEM 스크린 플레이어

1. Chrome 브라우저 플러그인으로 ChromeOS 플레이어를 설치하는 방법? how-to-install-chromeos-player-as-chrome-browser-plugin

ChromeOS 플레이어는 실제 Chrome 플레이어 장치 없이 개발자 모드에서 Chrome 브라우저 플러그인으로 설치할 수 있습니다. 설치하려면 아래 단계를 따르십시오.

  1. 최신 Chrome 플레이어를 다운로드하려면 여기를 클릭하십시오.
  2. 압축을 풀고 디스크에 저장합니다.
  3. Chrome 브라우저를 열고 메뉴에서 확장 ​을 클릭하거나 직접 chrome://extensions(으)로 이동합니다.
  4. 오른쪽 상단에서 개발자 모드 ​를 켭니다.
  5. 왼쪽 상단 모서리에서 압축을 푼 항목 로드 ​를 클릭하고 압축을 푼 Chrome Player를 로드합니다.
  6. 확장 목록에 있는 경우 AEM Screens Chrome 플레이어 플러그인을 확인하십시오.
  7. 새 탭을 열고 왼쪽 상단 모서리에서 앱 아이콘을 클릭하거나 직접 chrome://apps(으)로 이동합니다.
  8. AEM Screens 플러그 인을 클릭합니다. 기본적으로 플레이어는 전체 화면 모드로 실행됩니다. 전체 화면 모드를 종료하려면 Esc ​을 누르십시오.

2. Screens 플레이어가 사용자 지정 오류 핸들러로 게시 인스턴스를 통해 인증할 수 없는 경우 문제를 해결하는 방법

AEM Screens 플레이어가 시작되면 플레이어에 404 오류가 발생하면 /content/screens/svc.ping.json ​에 요청합니다. 플레이어는 게시 인스턴스에 대해 인증하기 위한 인증 요청을 시작합니다. 게시 인스턴스에 사용자 지정 오류 처리기가 있는 경우 /content/screens/svc.ping.json ​에서 익명 사용자에 대한 404 상태 코드를 반환해야 합니다.

3. Android™ Player에서 장치 화면 유지 기능을 설정하는 방법 how-to-set-the-device-screen-stay-on-in-an-android-player

모든 Android™ 플레이어에서 Stay Awake를 켜려면 아래 단계를 따르십시오.

  1. Android™ 플레이어 설정 > 정보(으)로 이동합니다.
  2. 빌드 번호를 7번 탭하여 설정 ​에서 개발자 옵션 ​을 사용하도록 설정합니다.
  3. 개발자 옵션(으)로 이동합니다.
  4. 절전 모드 해제 ​을 사용하도록 설정하십시오.

4. Windows Player의 창 모드를 활성화하는 방법 enable-player

Windows Player에는 창 모드가 없습니다. 항상 전체 화면 모드입니다.

5. AEM Screens Player에서 로그인 요청을 계속 보내는 경우 문제를 해결하는 방법

/content/screens/svc.json 및 /libs/granite/core/content/login.validate/j_security_check에 요청을 지속적으로 보내는 AEM Screens 플레이어의 문제를 해결하려면 아래 단계를 따르십시오.

  1. AEM Screens 플레이어가 시작되면 /content/screens/svc.json에 요청합니다. 플레이어가 응답에서 404 상태 코드를 받으면 publish 인스턴스에 대해 /libs/granite/core/content/login.validate/j_security_check을(를) 사용하여 인증 요청을 시작합니다. publish 인스턴스에 사용자 지정 오류 처리기가 있는 경우 /content/screens/svc.json 또는 /content/screens/svc.ping.json에서 익명 사용자에 대한 404 상태 코드를 반환해야 합니다.

  2. Dispatcher 구성이 /filters에서 이러한 요청을 허용하는지 확인하십시오.

    자세한 내용은 Screens 필터 구성을 참조하십시오.

  3. Dispatcher 재작성 규칙이 화면 경로를 다른 경로로 재작성하고 있는지 확인합니다.

  4. 작성자 또는 게시 인스턴스에 /etc/map 규칙이 있는지 확인하고 화면 경로가 sling:match과(와) 일치하며 내부적으로 다른 경로로 리디렉션됩니다. /system/console/jcrresolver에서 정확한 URL을 확인하는 것은 publish 인스턴스가 이러한 URL을 다른 경로에 다시 쓰고 있는지 확인하는 데 도움이 됩니다.

  5. Apache Sling Resource Resolver Factory 구성으로 인해 내부 재쓰기가 발생하는지 확인하십시오.

6. 플레이어 API에서 디스플레이 및 장치의 세부 정보를 가져오는 방법

다음을 통해 디스플레이 및 장치의 세부 정보를 가져올 수 있습니다.

  • 내부 JS API

  • ContextHub 저장소: 채널, 장치 및 디스플레이 정보를 노출하기 위해 /libs/screens/clientlibs/contexthub에 3개의 ContextHub 저장소가 정의되어 있습니다.

    다음 ContentHub 저장소 값을 사용하려면 아래 단계를 따르십시오.

    • 채널 속성을 편집하고 개인화 탭의 ContextHub 경로를 값으로 설정합니다(위에 언급).

    • 채널 JS에서 다음을 사용할 수 있습니다.

      code language-shell 
         ContextHub.getStore('screens-device');
   ContextHub.getStore('screens-display');
   ContextHub.getStore('screens-channels');

일반 문제 해결 팁 general-troubleshooting-tips

1. A/P Screens 오류를 방지하기 위해 Livefyre를 비활성화하는 방법

다음을 수행하여 로그 오류가 발생하지 않도록 Livefyre를 비활성화합니다.

  1. Livefyre 번들 사용 안 함:

    • 다음으로 이동 https://<host>:<port>/system/console/bundles.
    • AEM Livefyre 번들 검색: com.adobe.cq.social.cq-social-livefyre.
    • 중지 ​를 클릭합니다.

  2. Livefyre Poller 사용 안 함:

    • CRXDE Lite에서 /etc/importers/polling/livefyre-poller/jcr:content(으)로 이동합니다.
    • 속성 enabled 유형 Boolean ​을(를) 추가합니다.
    • Enabled 속성 ​을(를) false(으)로 설정합니다.

2. Oak 색인 정보를 추가하는 방법 add-oak-index-info

AEM Screens은 제품에서 사용하는 쿼리에 대한 색인 정의를 만듭니다.
error.log에 쿼리 순회 경고 ​가 있는 경우 쿼리에 대한 사용자 지정 인덱스를 만드십시오. 자세한 내용은 인덱스 구성을 참조하십시오.

Oak 설명서에서도 추가 리소스를 볼 수 있습니다.

3. v3 매니페스트를 구성하는 데 필요한 사항 configure-v3

v3 Manifest를 활성화하려면 다음을 수행하십시오.

  • Dispatcher 업데이트.
    자세한 내용은 매니페스트 버전 v3에 대한 Dispatcher 구성을 참조하세요.

  • 사용자 지정 구성 요소를 업데이트합니다.
    자세한 내용은 사용자 지정 처리기용 템플릿을 참조하십시오.

  • /system/console/configMgr/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag에서 ContentSync를 사용하지 않도록 설정합니다.

  • /system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.OfflineContentServiceImpl에서 SmartSync를 사용하도록 설정합니다.

  • channel/experience fragment/page components 편집

  • 오프라인 구성 탭으로 이동합니다.

  • 매니페스트에 추가해야 하는 정적 파일에 대한 clientlibs 및 폴더를 입력하십시오.

4. 패키지 screens-cloud-ams-pkg-0.0.20, screens-cloud-ams-pkg-0.0.16 및 screens 코어 번들이 설치되어 있지만 활성화되어 있지 않은 경우 어떻게 해야 합니까?

AMS 커넥터가 작동할 AEM 6.5 기능 팩 8 의 최소 버전을 설치합니다. AEM Screens 기능 팩의 최소 버전을 가져올 수 있도록 가용성을 참조하세요.

5. Screens에서 CQ 링크 외부화 서비스를 구성하는 방법

이 서비스는 작성자 및 게시 인스턴스에 대한 공개 호스트 이름을 정의하는 데 사용되며 값은 장치 서버 URL을 업데이트하고 ContextHub 타겟팅에도 사용됩니다.

Screens의 CQ 링크 외부화 서비스는 다음 방식으로 구성할 수 있습니다.

  1. http://localhost:4502/system/console/configMgr(으)로 이동
  2. 일별 CQ 링크 외부화
  3. 필요에 따라 author/publish 항목의 호스트 이름을 변경합니다.
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053