Dynamic Media中的新视频查看器 new-video-viewer-dynamic-media
新的Dynamic Media视频查看器在Adobe Experience Manager (AEM)中提供了现代化的视频播放体验。 它在创作、预览和站点环境中提供一致且可扩展的查看体验，同时继续使用现有Dynamic Media工作流。
Dynamic Media中的现有视频查看器支持核心播放要求，但为现代分析和集成方案提供了有限的可扩展性和事件级集成
新的视频查看器通过以下方式解决这些限制：
- 提供更一致的播放体验
- 允许显式选择查看器
- 发送用于程序化消耗的结构化回放事件
- 支持与外部分析和外部系统的集成
查看器是作为附加选项提供的，在支持的地方需要明确选择。 它不会自动替换现有的视频查看器。
新的视频查看器适用于需要增强的可扩展视频体验且不会中断现有实施的组织。
注释
新的视频查看器是有限的可用性功能。 您可以通过创建支持票证来启用它。
新视频查看器的工作方式 how-it-works
新视频查看器的工作方式如下：
- 视频资产将摄取到与Dynamic Media同步的文件夹中。
- 可使用 视频（新） 从资产详细信息页面预览视频。
- 在创作Sites页面时，可以在 Dynamic Media 组件中选择新的视频查看器。
- 在播放期间，查看器向父窗口发送结构化事件。
- 可选的查看器修饰符可用于控制播放行为。
与现有Video Viewer的主要区别 key-differences
先决条件 prerequisites
在使用新的视频查看器之前，请确保满足以下先决条件：
新的视频查看器从 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 组件。
- 单击组件以打开资产选择器。
- 选择视频资产。
配置查看器
执行以下步骤可配置查看器预设：
-
在页面上选择 Dynamic Media 组件。
-
单击组件工具栏中的配置。
-
在 Dynamic Media设置对话框 中，从 查看器预设 下拉列表中选择视频（新）。
-
在 查看器修饰符 字段中输入任何必需的修饰符（例如，
autoplay=true&muted=true）。
-
保存更改。
使用新的视频查看器在页面上加载视频。
注意：新的视频查看器不会自动替换现有视频。 使用Dynamic Media组件时，用户必须在 查看器预设 中手动选择视频（新），或者在需要时更新指向新视频查看器的直接URL。
使用直接URL迁移视频
如果通过直接URL而不是Dynamic Media组件访问您的视频，则可以通过更新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
新的视频查看器会在视频交互期间向父页面发送与播放相关的消息。
要处理这些事件，父应用程序必须侦听浏览器消息事件并在处理数据之前验证消息来源。
事件有效负载包括事件类型、播放状态、当前播放时间和其他元数据等信息。 这些事件可用于支持Analytics跟踪、自定义交互或与外部系统的集成。
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