[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属性为空表示无法为资产生成Dynamic Media 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 — 存储的临时数据可能会与新的视频内容冲突,并阻止其正确加载。
- 浏览器扩展或广告拦截器 — 某些扩展通过阻止播放所需的脚本来干扰视频播放器。
- 图形驱动程序过时或硬件加速冲突 — 这些是黑屏、断断续续播放或崩溃的常见来源。
- 音频或编解码器不兼容 — 缺少或不支持的编解码器可能会导致视频无声音播放或无法完全呈现。
逐步视频疑难解答
请按照顺序执行以下步骤。 每个步骤首先解决最可能的原因,因此问题通常会在进入后续步骤之前得到解决:
- 检查你的Internet连接。 确认其他网站和服务加载正常。 连接缓慢或断开是缓冲和播放失败的主要原因。 如果可能,请切换到有线连接或靠近无线路由器。
- 刷新页面并重新启动播放。 重新加载会清除临时加载错误并重新建立与视频源的连接。
- 更新您的浏览器或应用程序。 运行最新版本可确保与当前视频格式和播放功能的兼容性。
- 清除缓存和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)桌面应用程序(一种用于托管、管理和交付富媒体的Adobe资产管理工具)中打开带宽和存储 选项卡时,出现#2046 错误。 该错误是由于 Adobe AIR (Adobe Integrated Runtime) 框架使用的缓存 RSL (运行时共享库) 中包含的 过期数字签名证书 导致的。
在 本地证书重新验证 期间触发了失败:当应用程序加载缓存的RSL时,它会尝试验证签名证书,并且由于该缓存的证书已过期,验证失败并引发错误#2046。 由于问题存在于本地存储的库中,而不是应用程序本身,因此修复方法是删除过时的缓存文件,以便可以检索当前经过有效签名的RSL。
解决方案:清除本地Adobe AIR缓存
清除本地缓存以强制 Adobe AIR 下载更新的RSL(运行时共享库)。 删除过时的缓存文件会删除过期的证书,并在下次启动Adobe AIR时下载经过新签名的RSL,该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配置。 此步骤重新生成已删除的示例内容和查看器预设,还原查看器预设创作中的图像预览。