Dynamic Media中的新視訊檢視器 new-video-viewer-dynamic-media
適用於Dynamic Media的全新視訊檢視器提供Adobe Experience Manager (AEM)現代化視訊播放體驗。 它可在編寫、預覽和Sites環境中提供一致且可擴充的檢視體驗，同時繼續搭配現有Dynamic Media工作流程使用。
Dynamic Media中的現有視訊檢視器支援核心播放需求，但針對現代分析和整合情境提供有限的擴充性和事件層級整合
新的視訊檢視器可透過以下方式解決這些限制：
- 提供更一致的播放體驗
- 允許明確的檢視器選擇
- 發出結構化播放事件以供程式化使用
- 支援與外部分析和外部系統的整合
此檢視器可作為其他選項使用，若有支援，則需要明確選取檢視器。 它不會自動取代現有的視訊檢視器。
新的視訊檢視器適用於需要增強且可擴充視訊體驗，又不會中斷現有實作的組織。
附註
新的視訊檢視器是可用性受限的功能。 您可以建立支援票證來啟用它。
新視訊檢視器的運作方式 how-it-works
新視訊檢視器的運作方式如下：
- 視訊資產會擷取至與Dynamic Media同步的資料夾。
- 可使用影片（新），從資產詳細資訊頁面預覽影片。
- 編寫Sites頁面時，可以在 Dynamic Media 元件中選取新的視訊檢視器。
- 在播放期間，檢視器會向父視窗傳送結構化事件。
- 選用的檢視器修飾元可用於控制播放行為。
與現有Video Viewer的主要差異 key-differences
先決條件 prerequisites
在使用新的Video Viewer之前，請確定符合下列必要條件：
新視訊檢視器從 AEM as a Cloud Service 2025.7.0 版開始提供。
若要啟用或停用新視訊檢視器，請聯絡Adobe客戶服務。
預覽新視訊檢視器 preview
執行以下步驟，從資產詳細資訊頁面預覽新視訊檢視器：
- 導覽至Assets > 檔案，然後開啟包含視訊資產的資料夾。
- 按一下視訊資產，開啟資產詳細資訊頁面。
- 在左側面板中，按一下檢視器。
- 在 檢視器 面板中，選取視訊（新增）。
- 按一下 URL 以複製預覽連結。
在網站中使用新的視訊檢視器 use-in-sites
新視訊檢視器可透過AEM Sites中的現有 Dynamic Media 元件使用。
新增Dynamic Media元件
執行以下步驟，使用動態媒體元件新增視訊：
- 在 網站編輯器 中開啟頁面。
- 將 Dynamic Media 元件拖曳至頁面上的必要位置。
- 選取頁面上的 Dynamic Media 元件。
- 按一下元件以開啟資產選擇器。
- 選取視訊資產。
設定檢視器
執行以下步驟來設定檢視器預設集：
-
選取頁面上的 Dynamic Media 元件。
-
按一下元件工具列中的設定。
-
在 動態媒體設定對話方塊 中，從 檢視器預設集 下拉式清單中選取視訊（新增）。
-
在 檢視器修飾元 欄位中輸入任何必要的修飾元（例如，
autoplay=true&muted=true）。
-
儲存變更。
視訊會使用新的視訊檢視器在頁面上載入。
注意：新的視訊檢視器不會自動取代現有的視訊。 使用動態媒體元件時，使用者必須在 檢視器預設集 中手動選取視訊（新），或更新直接URL以視需要指向新視訊檢視器。
使用直接URL移轉視訊
如果視訊是透過直接URL存取，而非透過動態媒體元件存取，您可以更新URL以將其切換為新的視訊檢視器。 例如：https://s7d1.scene7.com/dmviewers/html5/VideoViewer.html?asset=<video-asset>
檢視器修飾元 viewer-modifiers
檢視器修飾元可讓您控制資產載入、播放行為、串流格式選擇和檢視器簡報。
assetposterimageserverurlcontenturlvideoserverurlsources.dashsources.hlsautoplay=truecontrols=true/falseloop=truemuted=trueplaybackratesplaybackprogressivebitrateinitialbitrateisletterboxed=true/falsecustomcsstransition修飾元在 檢視器修飾元 欄位中指定為查詢引數。
支援的事件 supported-events
新的視訊檢視器在播放期間會發出下列事件：
處理父視窗中的事件 handling-events
新的視訊檢視器會在視訊互動期間，將與播放相關的訊息傳送至上層頁面。
若要處理這些事件，父應用程式必須先接聽瀏覽器訊息事件並驗證訊息來源，才能處理資料。
事件裝載包含事件型別、播放狀態、目前播放時間和其他中繼資料等資訊。 這些事件可用於支援分析追蹤、自訂互動或與外部系統的整合。
Adobe建議驗證訊息來源，以確保系統只會處理來自受信任Dynamic Media網域的事件。
新視訊檢視器的視訊參與報告 video-engagement-report
「視訊參與報表」提供在Dynamic Media中使用新視訊檢視器播放之視訊的分析量度。 報表會提供指定月份的彙總效能資料，並支援每月報表。
報表是根據要求而產生。 若要請求報告，請建立支援票證並提供下列詳細資料：
- 報告月份 — 指定需要報告的月份（例如，2026年1月）。
- 傳送電子郵件地址 — 傳送報表的群組（建議）或個人的電子郵件地址
此報表提供每個視訊的參與量度，包括檢視次數、曝光數、觀看時間、完成率和參與分數。
報表格式
- 報表會以CSV格式傳送。
- 每一列代表單一視訊。
- 系統會彙總所選報告期間的量度。
- 報表中會排除已刪除的資產。
- 支援
tenant_name的篩選。
報告欄位
視訊參與報表包含下列欄位：
video_idvideo_namevideo_created_dateduration_in_secondsvideo_viewsvideo_impressionsvideo_watched_secondsplay_ratevideo_views ÷ video_impressions) × 100avg_time_watched_in_secondsvideo_watched_seconds ÷ video_viewsavg_completion_ratevideo_views） × 100engagement_scorevideo_views）tenant_name