AEM Screens常見問題集 aem-screens-faqs

以下章節提供與AEM Screens專案相關之常見問答集的解答。

空白畫面問題 blank-screen

NOTE
列出的強制檢查,在引發問題之前應由主要支援或客戶端支援嘗試。

1.面對黑熒幕或未播放內容的客戶,其急救疑難排解步驟是什麼? troubleshooting-blank-screen

  • 檢查頻道預覽是否正常運作。
  • 檢查顯示預覽是否正常運作
  • 請嘗試將播放器註冊為系統上的瀏覽器擴充功能,以顯示在相同的顯示器上,並檢查此功能是否運作。
  • 在系統上執行播放器時,導覽至 http://localhost:24502. 檢查是否已正確下載所有內容。
  • 檢查資產是否已建立適當的轉譯,且正在播放正確的轉譯。
  • 檢查是否有任何排程內容,以及時間是否正確。 檢查播放器中設定的時間是否正確。
  • Inspect播放器主控台會記錄並檢查是否有任何錯誤。 按一下滑鼠右鍵並檢查以檢視主控台記錄。 如果使用Windows Player,請按 CTRL + ALT +I 開啟dev console以檢視記錄。

2.如何建立預設頻道或排程,以解決AEM Screens中的灰幕問題?

為避免欄位中出現空白或灰色畫面,請建立預設的全域頻道或排程,指派給優先順序最低為1的每個顯示器。 萬一內容更新發生問題(由於網路、播放器、伺服器或復寫),因為播放器已在光碟上快取此內容,播放應該可以正常並避免灰屏。

所有其他內容(例如頻道或排程)的優先順序將大於1,因此其他內容具有優先順序,並且全域頻道或排程內容(具有優先順序1)將僅作為回退選項播放。

頻道管理 channel-management

1.線上和離線管道之間有何差異? what-is-the-difference-between-an-online-and-an-offline-channel

一個 線上頻道,會在即時環境中顯示更新的內容,而 離線頻道,會顯示快取的內容。

2.如何線上建立管道? how-do-i-make-a-channel-online

選取頻道,然後從動作列導覽至頻道屬性。 Check 開發人員模式(強制頻道上線)頻道 索引標籤讓頻道上線。

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離線設定?

使用內建自訂使用者端代碼時 clientlib 在AEM Screens管道中,若要確保 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.是否有方法可透過某種形式的驗證將HTTPGET要求轉換為HTTPPOST? 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播放器顯示空白熒幕,該如何進行疑難排解? how-do-i-troubleshoot-if-my-aem-screens-player-shows-blank-screen

請檢查下列是否可能疑難排解空白熒幕問題:

  • AEM無法推送離線內容
  • 頻道沒有任何內容
  • 沒有任何資產排程為目前時間顯示

2.如果AEM Screens播放器無法註冊且其狀態顯示為「失敗」,我該怎麼做? what-do-i-do-if-aem-screens-player-cannot-register-and-its-state-is-displayed-as-failure

您需要啟用Apache Sling反向連結篩選允許空白。 這是在AEM Screens Player和AEM Screens伺服器之間最佳化控制通訊協定運作的必要專案。

  1. 導覽至 Adobe Experience Manager Web主控台設定
  2. 檢查 allow.empty 選項。
  3. 按一下「儲存」。

3.如果在註冊AEM Screens播放器時,裝置顯示失敗且主控台記錄顯示ENAME_NOT_FOUND錯誤,該如何進行疑難排解? how-to-troubleshoot-if-while-registering-an-aem-screens-player-device-shows-failure-and-the-console-logs-display-ename-not-found-error

如果播放器找不到AEM Screens伺服器DNS,就可能會發生此問題。 您可以嘗試使用IP位址進行連線。 若要取得伺服器的IP,請使用: arp <server_dns_name>.

4. AMS是否建議在所有裝置上實作Android Watchdog? APK是否包含Watchdog (Cordova)外掛程式? does-ams-recommend-implementing-an-android-watchdog-on-all-devices-is-the-watchdog-cordova-plugin-included-as-part-of-the-apk

使用純Android API的跨平台Android看門狗已經是計畫的一部分。 不需要其他軟體,但視您使用的裝置而定,您可能需要放棄此要求,才能取得完整電源週期(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 Notifications服務會通知您。 協力廠商工具取決於您的作業系統(OS)、其功能及客戶的特定需求。

有關您可在何處監控裝置活動的詳細資訊,請參閱 AEM Screens通知服務.

AEM Screens 播放器 aem-screens-player

1.如何將ChromeOS播放器安裝為Chrome瀏覽器外掛程式? how-to-install-chromeos-player-as-chrome-browser-plugin

ChromeOS播放器可在開發人員模式下安裝為Chrome瀏覽器外掛程式,而不需要實際的Chrome播放器裝置。 若要進行安裝,請遵循下列步驟:

  1. 按一下 此處 以下載最新的Chrome Player。
  2. 解壓縮並儲存在磁碟上。
  3. 開啟Chrome瀏覽器並選取 擴充功能 或直接導覽至「 」 chrome://extensions.
  4. 切換至 開發人員模式 從右上角。
  5. 按一下 載入已解壓縮 從左上角,並載入解壓縮的Chrome Player。
  6. Check AEM Screens Chrome Player 外掛程式(如果可在擴充功能清單中取得)。
  7. 開啟新標籤,然後按一下 應用程式 圖示瀏覽,或直接導覽至 chrome://apps.
  8. 按一下 AEM Screens 啟動Chrome Player的外掛程式。 依預設,播放器會以全熒幕模式啟動。 按下 esc 以結束全熒幕模式。

2.如果Screens播放器無法透過具有自訂錯誤處理常式的發佈執行個體進行驗證,該如何進行疑難排解? how-to-troubleshoot-if-screens-player-is-unable-to-authenticate-through-publish-instance-with-custom-error-handler

AEM Screens播放器啟動時,會要求 /content/screens/svc.ping.json,播放器收到404錯誤時。 播放器會起始驗證請求,以針對發佈執行個體進行驗證。 如果發佈執行個體中有自訂錯誤處理常式,請確定您在上為匿名使用者傳回404狀態碼 /content/screens/svc.ping.json.

3.如何在Android Player中設定裝置熒幕持續開啟? how-to-set-the-device-screen-stay-on-in-an-android-player

請依照下列步驟,在任何Android播放器上開啟「保持清醒」:

  1. 導覽至Android播放器設定 — > 關於
  2. 在組建編號上點選7次以啟用 開發人員選項設定
  3. 導覽至 開發人員選項
  4. 啟用 保持清醒

4.如何啟用Windows播放器的視窗模式? enable-player

Windows Player中沒有視窗模式。 永遠是全熒幕模式。

5.如果AEM Screens播放器持續傳送登入要求,該如何進行疑難排解? requests-login

請依照下列步驟,疑難排解持續傳送請求的AEM Screens播放器 /content/screens/svc.json/libs/granite/core/content/login.validate/j_security_check

  1. AEM Screens播放器啟動時,會要求 /content/screens/svc.json. 當播放器收到回應中的404狀態碼時,它會使用起始驗證請求 /libs/granite/core/content/login.validate/j_security_check 針對 發佈 執行個體。 如果中有自訂錯誤處理常式 發佈 執行個體,請確定傳回匿名使用者的404狀態碼 /content/screens/svc.json/content/screens/svc.ping.json.

  2. 檢查您的Dispatcher設定是否允許在 /filters.

    另請參閱 設定畫面篩選器 以取得更多詳細資料。

  3. 檢查您的Dispatcher重寫規則是否正在將任何Screens路徑重寫為其他路徑。

  4. 檢查您是否擁有 /etc/map 上的規則 作者發佈 執行個體和畫面路徑符合 sling:match 並在內部重新導向至不同的路徑。 解析中的確切url /system/console/jcrresolver 有助於識別 發佈 執行個體正在將這些URL重寫為任何其他路徑。

  5. 檢查Apache Sling Resource Resolver Factory設定是否造成內部重寫。

6.如何從播放器API取得顯示器和裝置的詳細資料?

您可以透過以下方式取得顯示器和裝置的詳細資訊:

  • 內部JS API

  • ContextHub存放區:三個ContextHub存放區定義於 /libs/screens/clientlibs/contexthub 以公開頻道、裝置和顯示資訊。

    請依照下列步驟,使用這些ContentHub存放區值:

    • 編輯管道屬性,並將「個人化」標籤中的ContextHub路徑設定為值(如上所述)

    • 在管道JS中,您可以使用:

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

一般疑難排解提示 general-troubleshooting-tips

1.如何停用Livefyre以避免A/P Screens錯誤? how-to-disable-livefyre-to-avoid-a-p-screens-error

若要停用Livefyre以避免記錄錯誤:

  1. 停用Livefyre套裝:

    • 瀏覽到 https://&lt;host&gt;:&lt;port&gt;/system/console/bundles
    • 搜尋AEM Livefyre套件組合: com.adobe.cq.social.cq-social-livefyre
    • 按一下 停止
  2. 停用Livefyre輪詢程式:

    • 在CRXDE Lite中,導覽至 /etc/importers/polling/livefyre-poller/jcr:content
    • 新增屬性 已啟用 type 布林值
    • 設定 啟用屬性false

2.如何新增Oak索引資訊? add-oak-index-info

AEM Screens會為產品使用的查詢建立索引定義。
如果有的話 查詢周遊警告error.log,為您的查詢建立自訂索引。 請參閱 設定索引 以取得更多詳細資料。

您也可以參閱上的其他資源 Oak檔案.

3.設定v3資訊清單需要什麼? configure-v3

若要啟用v3資訊清單,您必須:

  • 更新Dispatcher。
    另請參閱 為資訊清單版本v3設定Dispatcher 以取得更多詳細資料。

  • 更新自訂元件。
    另請參閱 自訂處理常式的範本 以取得更多詳細資料。

  • 在中停用ContentSync /system/console/configMgr/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag.

  • 在中啟用SmartSync /system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.OfflineContentServiceImpl.

  • 編輯 channel/experience fragment/page components.

  • 導覽至 離線設定 標籤。

  • 輸入 clientlibs 以及需要新增至資訊清單的靜態檔案資料夾。

4.如果在套件screens-cloud-ams-pkg-0.0.20、screens-cloud-ams-pkg-0.0.16和screens核心套件已安裝但未啟用,您應該怎麼做?

您必須安裝AEM 6.5 Feature Pack 8的最低版本,AMS聯結器才能運作。 請參閱 可用性 以取得Screens Feature Pack的最低版本。

此服務可用來定義製作和發佈執行個體的公用主機名稱,然後使用值來更新裝置伺服器URL及用於ContextHub目標定位。

Screens中的CQ Link Externalizer服務可透過以下方式設定:

  1. 瀏覽到 http://localhost:4502/system/console/configMgr
  2. Day CQ連結外部化器
  3. 變更的主機名稱 author/publish 視需要輸入
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053