AEM Dynamic Media:在以WebP形式交付图像时强制PNG输出

如果为PNG输出配置的Dynamic Media预设中的图像仍以WebP形式交付,请将fmt=png和bfc=off添加到预设。 仅添加bfc=off不会强制PNG输出。

描述 description

环境

Adobe Experience Manager Dynamic Media(所有版本)

症状

  • Dynamic Media预设配置为将图像输出为PNG。
  • 在浏览器中下载或查看图像时,文件以WebP格式而不是PNG格式交付。
  • 在预设配置中仅添加bfc=off参数并不能解决此问题;图像将继续作为WebP提供。
  • 将bfc=off直接添加到图像URL会导致图像按预期以PNG形式交付。

原因

智能成像的浏览器格式转换(BFC)功能会自动以WebP等现代格式交付图像,除非明确禁用。 仅添加bfc=off可禁用浏览器格式转换,但不会强制PNG输出。 显式设置输出格式还需要fmt=png修饰符。

解决方法 resolution

请尝试执行以下步骤来解决问题。

  1. 在Scene7配置中编辑受影响的Dynamic Media预设。

  2. 在预设的URL修饰符中,添加fmt=png(如果需要透明度,则添加fmt=png-alpha)和bfc=off以明确设置输出格式并禁用浏览器格式转换:

    • 对于PNG: fmt=png&bfc=off
    • 对于具有透明度的PNG: fmt=png-alpha&bfc=off
  3. 保存并发布更新的预设。

  4. 清除CDN缓存,或在重新测试下载之前等待缓存过期的时间。

  5. 要验证,请使用更新的预设下载或查看图像,并检查HTTP响应中的Content-Type标头;它应为image/png。

  6. 请确保未将其他fmt或bfc参数附加到最终图像URL,因为这些参数可能会覆盖预设值。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles