Dynamic Media di AEM: immagini distribuite come AVIF invece del formato richiesto

Questo articolo spiega come risolvere un problema in cui Adobe Experience Manager (AEM) Dynamic Media fornisce immagini in formato AVIF anche quando è richiesto JPG o un altro formato.

Descrizione description

Ambiente

  • Dynamic Media (API aperte) di Adobe Experience Manager (AEM)

Sintomi

Quando si pubblicano le risorse tramite AEM Dynamic Media, tutti i file di immagine vengono consegnati in formato AVIF, indipendentemente dal tipo originale (ad esempio JPG o PNG). Ciò si verifica anche quando:

  • L’estensione del file è impostata su JPG nelle impostazioni di AEM Dynamic Media.
  • Il parametro fmt=jpg viene aggiunto all’URL di consegna della risorsa.

Ad esempio, un URL come:

https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?fmt=jpg

il file viene comunque consegnato come AVIF quando viene salvato dal browser. Questo può bloccare i flussi di lavoro che richiedono immagini in formato JPG, ad esempio integrazioni con sistemi di generazione e-mail che non supportano AVIF.

Causa

Per impostazione predefinita, la funzione SmartImaging di AEM Dynamic Media converte automaticamente le immagini in formati moderni come AVIF o WebP per ottimizzare la distribuzione. L’impostazione di auto-format=false disattiva questo comportamento e mantiene il formato immagine richiesto.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esamina l’URL di consegna della risorsa utilizzato per le immagini Dynamic Media.
  2. Per ignorare la conversione automatica del formato, aggiungere il parametro auto-format=false all’URL dell’immagine. Ad esempio:

https://example.com/adobe/assets/urn:aaid:aem:/as/.jpg?auto-format=false

  1. Verifica l’URL aggiornato accedendo a esso in un browser o in un flusso di lavoro di integrazione. L’immagine deve ora essere consegnata nel formato richiesto (ad esempio JPG) anziché AVIF.
  2. Se utilizzi le immagini in un client e-mail o in un sistema esterno, verifica che il file sia riconosciuto come formato corretto.
  3. Per ulteriori dettagli, consulta la documentazione API di consegna risorse Dynamic Media di AEM e cerca il parametro auto-format.

Lettura correlata

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