DocumentazioneExperience Cloud KCS

Dynamic Media di AEM: forzare l’output PNG quando le immagini vengono distribuite come WebP

Ultimo aggiornamento: 23 ottobre 2026

Se le immagini dei predefiniti di Dynamic Media configurati per l’output PNG vengono comunque distribuite come WebP, aggiungere fmt=png e bfc=off al predefinito. L’aggiunta di solo bfc=off non forza l’output PNG.

Descrizione description

Ambiente

Adobe Experience Manager Dynamic Media (tutte le versioni)

Sintomi

  • I predefiniti di Dynamic Media sono configurati per restituire immagini come PNG.
  • Quando si scaricano o si visualizzano immagini in un browser, i file vengono consegnati come WebP anziché come PNG.
  • L’aggiunta del solo parametro bfc=off nella configurazione del predefinito non risolve il problema; le immagini continuano a essere utilizzate come WebP.
  • L’aggiunta diretta di bfc=off all’URL dell’immagine fa sì che l’immagine venga distribuita come file PNG come previsto.

Causa

La funzione BFC (Browser Format Conversion) di Smart Imaging fornisce automaticamente immagini in formati moderni come WebP, a meno che non sia esplicitamente disabilitata. L’aggiunta di solo bfc=off disattiva la conversione del formato del browser, ma non forza l’output PNG. Il modificatore fmt=png è necessario anche per impostare esplicitamente il formato di output.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito.

  1. Modifica il predefinito Dynamic Media interessato nella configurazione Scene7.

  2. Nei modificatori URL del predefinito, aggiungi fmt=png (o fmt=png-alpha se è richiesta la trasparenza) e bfc=off per impostare in modo esplicito il formato di output e disabilitare la conversione del formato browser:

    • Per PNG: fmt=png&bfc=off
    • Per PNG con trasparenza: fmt=png-alpha&bfc=off

  3. Salva e pubblica il predefinito aggiornato.

  4. Cancella la cache CDN o lascia scadere il tempo per la scadenza della cache prima di ripetere il test del download.

  5. Per verificare, scaricare o visualizzare un’immagine utilizzando il predefinito aggiornato e controllare l’intestazione Content-Type nella risposta HTTP; dovrebbe essere image/png.

  6. Accertarsi che nessun parametro aggiuntivo di fmt o bfc sia aggiunto all’URL dell’immagine finale, in quanto potrebbero ignorare i valori predefiniti.

Lettura correlata

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