[AEM Assets]{class="badge positive" title="適用於AEM Assets)。"}
Dynamic Media 疑難排解 troubleshooting-dynamic-media-scene-mode
此主題提供 Dynamic Media 的疑難排解指南，涵蓋常見問題、其可能原因以及解決這些問題的一般方法。 Dynamic Media是一項用於大規模建立、管理和提供豐富媒體資產（例如影像、視訊和互動式體驗）的功能，可讓內容適應不同的裝置、熒幕大小和檢視條件。 因為它橫跨許多環境的資產處理、傳送和轉譯，疑難排解通常需要隔離問題是否源自資產擷取、啟動或傳送期間。
常見Dynamic Media問題類別
大部分的Dynamic Media問題都屬於少數幾個可識別的類別。 識別類別會先縮小調查範圍並加快解決速度：
- 資產上傳與處理失敗 — 未匯入、無法產生轉譯或停滯在處理狀態的資產。
- 啟用和發佈問題 — 已成功處理但未在傳遞層上可用的資產。
- 傳遞和轉譯問題 — 無法載入、顯示不正確，或提供的尺寸或品質錯誤的影像或視訊。
- 檢視器和內嵌問題 — 互動式檢視器、視訊播放器或內嵌體驗，無法初始化或如預期般運作。
- 設定和連線問題 — 服務設定、認證或網路條件不正確，中斷編寫環境與傳遞服務之間的通訊。
一般疑難排解方法
結構化方法比試錯更可靠地解決大多數Dynamic Media問題。 依序完成下列步驟：
- 確認資產已正確處理。 確認來源資產已完全上傳並產生預期的轉譯，因為傳送和轉譯失敗通常會追溯到處理不完整。
- 驗證啟用狀態。 請確認資產已發佈或已啟動至傳送服務，因為若啟動未完成，一般使用者可能無法使用在製作中顯示的正確資產。
- 檢查傳遞URL與轉譯引數。 確認傳遞URL正確，且任何大小、格式或品質引數均符合預期輸出。
- 隔離環境。 判斷問題是否發生在編寫、傳遞服務或使用者端瀏覽器中，以此指出引進失敗的位置。
- 檢閱組態和連線能力。 驗證編寫環境與Dynamic Media傳送服務之間的服務設定、憑證和網路連線。
問題通常發生的位置
瞭解常見的失敗點有助於鎖定調查目標：
- 在內嵌期間，不支援的檔案格式、損毀的來源檔案或中斷的上傳通常會導致無法成功處理。
- 在啟用期間，發佈不完整或延遲會導致傳遞層遺失資產，即使資產存在於編寫環境中亦然。
- 在傳遞期間，快取、不正確URL或引數設定錯誤會導致資產載入緩慢、載入不正確，或完全不載入。
透過確認順序的每個階段（處理、啟動和傳遞），您能夠有效地隔離Dynamic Media問題的根本原因，並套用適當的解決方案。
新增Dynamic Media設定 new-dm-config
新的Dynamic Media (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。 直接在CRXDE Lite (用來檢查AEM內容存放庫(JCR)節點結構的瀏覽器式開發環境)中檢閱這些屬性。 每個屬性都會提供有關資產與Dynamic Media連結狀態的特定訊號。
如何驗證CRXDE Lite中的同步化
CRXDE Lite會檢閱下列資產屬性，以確認資產成功從Adobe Experience Manager同步至Dynamic Media：
<object_node>/jcr:content/metadata/dam:scene7IDa|364266<object_node>/jcr:content/metadata/dam:scene7FileStatus<object_node>/jcr:content/metadata/dam:scene7Filedam:scene7File屬性表示無法為該資產產生動態媒體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層級的記錄會顯示更細微的診斷事件，擷取同步化處理作業周圍並非以預設層級寫入的其他前後關聯。
若要增加同步記錄至DEBUG：
- 在https://localhost:4502/system/console/slinglog開啟Sling主控台。
- 尋找或新增
com.adobe.cq.dam.ips封裝的記錄器組態。 - 將記錄層級設定為
DEBUG。 - 重新產生同步處理問題，然後檢閱在
/crx-quickstart/logs/中寫入error.log的其他詳細資料。
以這種方式增加記錄層級可收集更多關於同步工作流程的資訊，當預設記錄未提供足夠的詳細資訊時，可讓您更容易隔離根本原因。
版本控制 version-control
取代共用 相同名稱和位置 的現有Dynamic Media資產時，Adobe Experience Manager提供兩種不同的處理選項： 保留兩個資產或取代現有資產。 版本控制會決定在上傳時套用哪些行為。
-
保留兩個資產：新上傳的檔案儲存在 唯一名稱 下，因此已發佈的資產URL仍保持不同。 例如，
image.jpg是原始資產，image1.jpg是新上傳的資產。 由於每個檔案都保留其專屬名稱，因此兩個資產都維持可獨立定址及交付狀態，避免新上傳檔案覆寫原始檔案。 -
建立版本：在Dynamic Media中建立版本不支援。 因此，新的上傳不會附加至版本記錄。 相反地，新資產會取代傳遞中的現有資產，這表示先前發佈的檔案會被取代，而更新的內容會在其位置上提供。 由於沒有保留先前版本以供傳遞，因此已傳遞資產的取代實際上會永久存在。
影像和集合 images-and-sets
使用下列疑難排解指南，解決影像和影像集的常見問題。 影像和設定錯誤通常是因為不支援的格式、不完整的上傳、不正確的命名、快取衝突或設定不相符。 識別問題的類別是快速修正的最可靠途徑，因為大多數影像和設定失敗都屬於少數週期性模式。
常見影像和設定問題
影像和集最常遇到的問題包括：
- 影像未顯示 — 損毀、空白或遺失的影像通常表示檔案路徑無效、檔案格式不受支援，或上傳失敗。
- 不正確或過時的影像 — 當更新後出現舊版本時，原因通常是尚未重新整理的快取內容。
- 集未完全載入 — 部分或不完整的集通常是由成員專案遺失、參照中斷或同步中斷所造成。
- 格式設定或解析度問題 — 扭曲、延伸或低品質的影像通常指向不符合要求的尺寸、外觀比例或解析度設定。
- 許可權或存取錯誤 — 無法載入的影像或集可能受到存取許可權或過期連結的限制。
逐步疑難排解
請依序完成下列步驟，因為每個步驟都會在改用更複雜的解決方案前，先排除共同的原因：
- 驗證檔案格式與大小。 確認影像使用支援的格式且落在接受的大小限制內。 這可確保系統可呈現檔案而不會發生轉換錯誤。
- 確認上載已完成。 重新上傳任何看似遺失或損毀的影像，因為中斷的上傳是影像損毀的主要原因。
- 清除快取並重新整理。 清除瀏覽器或應用程式快取會強制載入最新版本，解決顯示過期影像的情況。
- 檢查檔案路徑和參考。 請確認每個影像，並將參考點設定為有效的現有位置，因為路徑中斷會導致影像無法載入。
- 檢閱許可權與存取設定。 確認影像或集可存取，且任何共用連結尚未過期。
- 在替代環境中測試。 載入影像或設定在不同瀏覽器、裝置或工作階段中，以判斷問題為本機而非系統性。
防止影像並設定錯誤
若要減少重複發生的問題，請套用以下預防作法：
- 對所有影像和集使用一致、支援的檔案格式和命名慣例。
- 在繼續之前，請確認每個上載已完全完成，這樣可避免檔案不完整或損毀。
- 保持影像參照與設定成員同步，以免成員專案遺失或孤立。
- 進行更新後重新整理快取內容，以確保始終提供最新版本。
完成這些疑難排解步驟後，如果問題仍然存在，請升級問題以支援特定影像或受影響影像集的詳細資訊、已嘗試的步驟以及觀察到的任何錯誤訊息。 提供這項資訊有助於更有效率地找出根本原因。
影片 video
視訊播放問題是最常見的技術問題之一，大部分問題都可透過幾個標準疑難排解步驟解決。 如果視訊未載入、顯示凍結狀態、播放時沒有聲音，或顯示黑熒幕，請依照下列指引找出問題並加以解決。
視訊問題的常見原因
大部分的視訊問題都起因於一小部分可預測的原因。 瞭解原因有助於您套用正確的修正：
- 網路連線不足或不穩定 — 串流視訊需要一致的頻寬。 連線強度弱或波動會導致緩衝、停滯或品質自動降低。
- 過時的瀏覽器或應用程式 — 較舊的軟體可能不支援目前的視訊格式或播放標準，導致錯誤或熒幕空白。
- 損毀的快取或Cookie — 儲存的暫存資料可能會與新的視訊內容衝突，導致無法正確載入。
- 瀏覽器擴充功能或廣告封鎖程式 — 某些擴充功能會封鎖播放所需的指令碼，進而干擾視訊播放器。
- 過時的圖形驅動程式或硬體加速衝突 — 這些是黑熒幕、斷斷續續的播放或當機的常見來源。
- 音訊或轉碼器不相容 — 遺失或不支援的轉碼器可能會導致視訊無音訊播放，或無法完全轉譯。
逐步視訊疑難排解
請依序按照下列步驟操作。 每個步驟都會先解決最可能的原因，因此在後續步驟之前通常會先解決問題：
- 檢查您的網際網路連線。 確認其他網站和服務已正常載入。 連線速度緩慢或中斷是緩衝和播放失敗的主要原因。 如果可能的話，請切換到有線連線，或靠近您的無線路由器。
- 重新整理頁面並重新啟動播放。 重新載入會清除暫時載入錯誤，並重新建立與視訊來源的連線。
- 更新您的瀏覽器或應用程式。 執行最新版本可確保與目前視訊格式和播放功能的相容性。
- 清除快取和Cookie。 移除儲存的暫時資料可消除導致視訊無法載入的衝突。 之後重新啟動瀏覽器。
- 停用擴充功能和廣告封鎖程式。 暫時關閉這些專案，以判斷其中之一是否封鎖視訊播放器。 如果影片運作正常，請一次重新啟用一個擴充功能，以識別來源。
- 降低視訊品質。 如果視訊播放但重複停頓，選取較低的解析度會減少所需的頻寬，並產生更流暢的播放。
- 更新圖形驅動程式或切換硬體加速。 過時的驅動程式會造成視覺問題和黑熒幕。 如果問題仍然存在，在瀏覽器設定中停用硬體加速功能通常可以解決轉譯問題。
- 嘗試不同的瀏覽器或裝置。 如果視訊在其他地方播放，問題會特定於原始瀏覽器或裝置，而不是視訊來源本身。
何時尋求進一步支援
如果完成上述每個步驟後視訊問題仍持續存在，則問題可能源自視訊來源或較深入的系統設定。 在此情況下，在連絡支援人員之前請注意下列詳細資料，因為它們可加快診斷速度：
- 精確的錯誤訊息或熒幕上所顯示內容的說明
- 瀏覽器或應用程式的名稱和版本
- 作業系統和裝置型別
- 問題發生於所有視訊或僅特定視訊
提供此資訊可讓支援人員重現問題，並找出是裝置本機的原因，還是影響視訊服務本身。
檢視器 viewers
檢視器可能會遇到播放、載入、顯示和相容性問題，導致內容無法正確呈現。 下列的疑難排解指南會說明最常見的檢視器問題，並提供解決問題的逐步解決方式。
檢視器常見問題
檢視器問題通常屬於幾個可識別的類別：
- 內容無法載入 — 檢視器會開啟，但顯示空白熒幕、旋轉圖或錯誤訊息，而非預期的內容。
- 播放或演算錯誤 — 內容已部分載入、凍結或顯示不正確。
- 相容性問題 — 檢視器在特定的瀏覽器、裝置或作業系統中無法如預期運作。
- 效能問題 — 載入緩慢、延遲或在使用期間無回應。
大部分的檢視器問題源自於一小部分根本原因，包括過時的軟體、瀏覽器快取衝突、封鎖的指令碼、不穩定的網路連線或不支援的檔案格式。 識別要套用的類別是邁向快速解決的第一步。
疑難排解步驟
請依序按照下列步驟進行，因為先前的步驟可以解決最常見的問題：
- 重新整理並重新載入檢視器。 臨時載入問題通常可透過重新載入頁面或重新開啟檢視器來清除。
- 清除瀏覽器快取和Cookie。 過時的快取資料是空白畫面和過時內容的常見原因，因此清除該資料會強制檢視器重新載入新資源。
- 更新您的瀏覽器或應用程式。 執行最新版本可確保與檢視器的轉譯需求相容。
- 嘗試不同的瀏覽器或裝置。 如此可隔離問題是否專屬於一個環境，或是否影響內容本身。
- 檢查網路連線。 不穩定的或受限的連線會阻止檢視器擷取內容，因此確認穩定連線可解決許多載入失敗。
- 停用衝突的擴充功能或封鎖程式。 廣告封鎖程式、指令碼封鎖程式和隱私權擴充功能可能會干擾檢視器功能；暫時停用這些程式碼有助於確認是否為原因。
如果完成這些步驟後問題仍然存在，問題可能源自內容來源或檢視器設定，而不是本機環境，而且可能需要進一步的診斷支援。
問題：檢視器預設集未發佈 viewers-not-published
症狀：檢視器預設集尚未發佈（啟動），導致Dynamic Media檢視器無法正確呈現已傳送的資產。 解決此問題需要確認啟用狀態並發佈任何未啟用的預設集。
如何偵錯：驗證檢視器預設集啟用狀態
請依照下列步驟，識別未發佈檢視器預設集的原因：
-
繼續範例管理員診斷頁面：
https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html。 -
觀察診斷頁面所報告的計算值。 當系統正確運作時，診斷頁面會報告下列專案：
_DMSAMPLE status: 0 unsyced assets - activation not necessary _OOTB status: 0 unsyced assets - 0 unactivated assets。 此處，DMSAMPLE狀態是指Dynamic Media範例資產，OOTB狀態是指’b2’7b成的檢視器資產。 0個未同步資產和 0個未啟動資產 的計數，可確認所有專案皆已按預期同步和啟動。note NOTE 設定Dynamic Media雲端設定後，檢視器資產可能需要約 10分鐘 才能同步。 如果計數尚未為零，請等待此同步化視窗完成，再繼續疑難排解。 -
如果仍有未啟用的資產，表示有一或多個檢視器預設集未曾發佈。 選取 列出所有未啟用的Assets 按鈕之一，以檢視仍需要啟用的資產的詳細資訊。
解決方案：發佈檢視器預設集
由於未啟用的資產來自尚未發佈的預設集，因此修正方法是明確發佈：
- 瀏覽至管理工具中的檢視器預設集清單：
https://localhost:4502/libs/dam/gui/content/s7dam/samplemanager/samplemanager.html。 - 選取所有檢視器預設集，然後選取發佈。 發佈會啟用預設集，以便同步其相關資產並使其可用於傳送，進而清除未啟用狀態。
- 導覽回範例管理員，並確認未啟用的資產計數現在為零。 零計數會驗證檢視器預設集是否成功發佈且問題是否已解決。
問題：檢視器預設集圖稿從資產詳細資料中的預覽或複製URL/內嵌程式碼中返回404 viewer-preset-404
如何偵錯：驗證同步處理狀態並直接要求圖稿
在CRXDE Lite （Adobe Experience Manager存放庫的開發人員主控台）中，執行下列步驟：
-
導覽至Dynamic Media同步處理資料夾中的
<sync-folder>/_CSS/_OOTB資料夾（例如/content/dam/_CSS/_OOTB）。 -
尋找有問題的資產的中繼資料節點（例如，
<sync-folder>/_CSS/_OOTB/CarouselDotsLeftButton_dark_sprite.png/jcr:content/metadata/）。 -
檢查
dam:scene7*屬性是否存在。 如果資產同步並發佈成功，dam:scene7FileStatus屬性會設為PublishComplete，確認資產同步並發佈成功。 如果這些dam:scene7*屬性不存在，則資產永遠不會完成同步和發佈工作流程，這是404的根本原因。 -
串連下列屬性和字串常值的值，嘗試直接向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*屬性，範例資產或檢視器預設集圖稿尚未同步或發佈。 因此，請重新啟動整個複製/同步程式：
- 導覽至CRXDE Lite。
- 刪除
<sync-folder>/_CSS/_OOTB。 這樣會移除過時的、未同步的圖稿資料夾，以便可以完全重新產生。 - 導覽至CRX封裝管理員（存放庫封裝安裝工具）：
https://localhost:4502/crx/packmgr/。 - 在清單中搜尋檢視器套件；它從
cq-dam-scene7-viewers-content開始。 - 選取重新安裝。 重新安裝此套件可還原現成可用的檢視器預設集內容。
- 在雲端服務底下，導覽至Dynamic Media設定頁面，然後開啟Dynamic Media - S7設定的設定對話方塊。
- 不做任何變更，然後選取儲存。
這個儲存動作會再次觸發設定邏輯，因為重新儲存Dynamic Media - S7設定會強制Experience Manager重新建立並重新同步範例資產、檢視器預設集CSS和圖稿，進而解決404錯誤。
問題：開啟頻寬與儲存空間索引標籤時發#2046錯誤 error-2046-bandwidth-storage
原因：快取RSL中的簽署憑證已過期
使用者在 Dynamic Media Classic (Scene7)案頭應用程式中開啟頻寬和儲存空間 索引標籤時，就會出現#2046 錯誤，這是一種Adobe資產管理工具，用來託管、管理和傳遞多媒體。 此錯誤是由於 Adobe AIR (Adobe Integrated Runtime) 架構所使用的快取 RSL （執行階段共用程式庫） 中包含的 過期數位簽署憑證 所造成。
在 本機憑證重新驗證 期間會觸發失敗：當應用程式載入快取的RSL時，它會嘗試驗證簽署憑證，而且因為快取的憑證已過期，所以驗證會失敗並擲回錯誤#2046。 由於問題存在於本機儲存的程式庫中，而不是應用程式本身，因此修正方法是移除過時的快取檔案，以便擷取目前有效的已簽署RSL。
解決方案：清除本機Adobe AIR快取
清除本機快取以強制 Adobe AIR 下載更新的RSL （執行階段共用程式庫）。 刪除過時的快取檔案會移除過期的憑證，而在下次啟動Adobe AIR時，會下載最新簽署的RSL （通過本機憑證重新驗證），解決錯誤。
macOS
- 瀏覽到:
~/Library/Caches/Adobe/Flash Player/AssetCache/<folder>/ - 刪除所有
.swz和.heu檔案。
Windows
- 瀏覽到:
%APPDATA%\Adobe\Flash Player\AssetCache\<folder>\ - 刪除資料夾中的所有檔案。
在清除快取之後重新啟動應用程式。 重新啟動時，請再次開啟 頻寬和儲存空間 索引標籤，以確認錯誤#2046不再出現，這表示更新的RSL已成功下載並驗證。
問題：檢視器預設集製作中未載入影像預覽 image-preview-not-loading
解決方案
當過時的範例內容和快取的檢視器預設集人工因素導致預覽無法呈現時，影像預覽無法載入檢視器預設集製作。 清除這些成品並重新建立Dynamic Media設定以還原預覽。
-
在Experience Manager中，選取Experience Manager標誌以存取全域導覽主控台，然後導覽至工具 > 一般 > CRXDE Lite。
-
在左側邊欄中，導覽至下列位置的範例內容資料夾：
/content/dam/_DMSAMPLE -
刪除
_DMSAMPLE資料夾。 這將會移除可能妨礙預覽正確呈現的過時範例內容。 -
在左側邊欄中，導覽至下列位置的預設集資料夾：
/conf/global/settings/dam/dm/presets/viewer -
刪除
viewer資料夾。 移除此資料夾會清除快取的檢視器預設集設定，以便將其重新產生。 -
在CRXDE Lite頁面的左上角附近，選取「儲存全部」以將刪除作業提交至存放庫。
-
在CRXDE Lite頁面的左上角，選取 首頁 圖示。
-
在雲端服務🔗中重新建立Dynamic Media設定。 此步驟會重新產生已移除的範例內容和檢視器預設集，還原檢視器預設集製作中的影像預覽。