Formati supportati

Per un'introduzione generale ai formati multimediali, consulta la pagina Formati supportati di ExoPlayer. Con Transformer si applicano le stesse limitazioni al caricamento, all'estrazione e alla decodifica degli stream, anche se Transformer non supporta i moduli del decoder software in bundle di ExoPlayer.

Transformer si basa anche su MediaCodec per la codifica, il che limita i formati di output supportati. Per saperne di più sulle limitazioni della codifica, consulta la pagina Codec video MediaCodec.

Per impostazione predefinita, Transformer genera file MP4 standard utilizzando InAppMp4Muxer. Se la tua app richiede MP4 frammentato, puoi passare un InAppFragmentedMp4Muxer.Factory durante l'inizializzazione dell'istanza di Transformer. Media3 supporta anche altri formati come WebM, AAC, Ogg e WAV utilizzando muxer dedicati come WebmMuxer, AacMuxer, OggMuxer e WavMuxer. Questi devono essere racchiusi in un Muxer.Factory personalizzato per essere inseriti, ma le versioni future includeranno implementazioni di factory pronte all'uso per semplificare questa procedura.

Supporto delle immagini

Transformer utilizza BitmapFactory per caricare e decodificare tutti gli asset immagine, pertanto supporta tutti i formati supportati da BitmapFactory. Per i tipi di immagine supportati, consulta la pagina Supporto delle immagini. Per i formati con più immagini (ad es. GIF), viene visualizzato un singolo frame dell'immagine dal contenitore se viene utilizzato DefaultAssetLoaderFactory.

Formati speciali

Transformer supporta la gestione dell'input nei formati multimediali più recenti che forniscono funzionalità speciali rispetto ai formati convenzionali.

Gestire i video HDR

Sempre più dispositivi supportano l'acquisizione di video HDR capture, che offre colori più vivaci e accurati e una gamma di luminosità più ampia.

Transformer supporta la modifica dei video HDR a partire da Android 13 (livello API 33) sui dispositivi con il supporto di codifica richiesto. Quando si modificano i video HDR, tutti gli effetti video GL devono gestire i componenti di colore a virgola mobile a 16 bit e lo spazio colore BT.2020. HDR_MODE_KEEP_HDR è la modalità predefinita quando si crea la Composition. Se la modifica HDR non è supportata, Transformer torna a utilizzare HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL.

La conversione da HDR a SDR, nota anche come tone mapping, è supportata a partire da Android 10 (livello API 29) sui dispositivi con il supporto di decodifica e OpenGL richiesto. Questa funzionalità è utile quando si condividono contenuti multimediali HDR con altre app o servizi che non supportano l'inserimento di contenuti HDR. Per attivare il tone mapping utilizzando OpenGL, chiama setHdrMode(HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL) durante la creazione della Composition. A partire da Android 12 (livello API 31), MediaCodec supporta anche il tone mapping su alcuni dispositivi, inclusi tutti i dispositivi con Android 13 o versioni successive in grado di acquisire video HDR. Per attivare il tone mapping utilizzando MediaCodec, chiama setHdrMode(HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC).

Transformer supporta anche scenari di transcodifica avanzati, ad esempio:

  • Video Ultra HDR in HDR: puoi convertire gli input di immagini Ultra HDR in video HDR, mantenendo la gamma dinamica e la gamma di colori ampia dell'immagine in modo che le foto corrispondano alla luminosità di picco e alla vivacità dei video HDR nelle sequenze temporali miste.
  • Transcodifica e transmuxing Dolby Vision: Transformer supporta il transmuxing del livello di base compatibile con le versioni precedenti (ad es. HEVC) dai contenuti multimediali Dolby Vision (profilo 8) senza ricodifica o la transcodifica con tone mapping in formati SDR standard.

Gestire i contenuti multimediali in slow motion

I video in slow motion includono metadati che indicano la velocità con cui deve essere riprodotta ogni sezione dello stream. La compressione è il processo di produzione di un nuovo stream video basato sul video in slow motion, ma in cui le sezioni vengono accelerate o rallentate in base ai metadati, in modo che vengano riprodotte correttamente anche sui player che non applicano i metadati in slow motion.

Per appiattire gli stream in slow motion, utilizza il metodo del builder setFlattenForSlowMotion su EditedMediaItem.

Kotlin

val editedMediaItem =
  EditedMediaItem.Builder(inputMediaItem).setFlattenForSlowMotion(true).build()
val transformer = Transformer.Builder(context).addListener(transformerListener).build()
transformer.start(editedMediaItem, outputPath)

Java

EditedMediaItem editedMediaItem =
    new EditedMediaItem.Builder(inputMediaItem).setFlattenForSlowMotion(true).build();
Transformer transformer =
    new Transformer.Builder(context).addListener(transformerListener).build();
transformer.start(editedMediaItem, outputPath);

In questo modo, puoi supportare i video in slow motion senza doverti preoccupare della gestione di questi formati speciali. Tutto ciò che devi fare è archiviare e riprodurre la versione compressa del video anziché quella originale.