Formati supportati

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

Transformer si basa anche su MediaCodec per la codifica e deve multiplexare, o mux, i file multimediali di output, il che limita i formati di output supportati. Consulta la sezione Codec video MediaCodec per ulteriori informazioni sulle limitazioni della codifica e MediaMuxer per le limitazioni che si applicano al contenitore multimediale di output. Transformer genera solo file MP4.

Per impostazione predefinita, Transformer utilizza MediaMuxer, ma è disponibile facoltativamente una InAppMuxer in fase di elaborazione per evitare alcune limitazioni di MediaMuxer relative alle strutture dei frame di riferimento e ai formati di esempio supportati. Il muxer predefinito diventerà il muxer in-app in una release futura.

Supporto delle immagini

Transformer utilizza BitmapFactory per caricare e decodificare tutti gli asset immagine, quindi supporta tutti i formati supportati da BitmapFactory. Consulta la sezione Supporto delle immagini per i tipi di immagini supportati. 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 offrono funzionalità speciali rispetto ai formati convenzionali.

Gestione dei video HDR

Sempre più dispositivi ora supportano l'acquisizione di video HDR, offrendo colori più vividi 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 modifichi video HDR, tutti gli effetti video GL devono gestire componenti di colore in virgola mobile a 16 bit e lo spazio colore BT.2020. HDR_MODE_KEEP_HDR è la modalità predefinita durante la creazione di Composition. Se l'editing HDR non è supportato, Transformer torna a utilizzare HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL.

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

Gestione dei contenuti multimediali in slow motion

I video in slow motion includono metadati che indicano la velocità di riproduzione di ogni sezione dello stream. Il flattening è il processo di produzione di un nuovo flusso 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 lettori che non applicano i metadati di slow motion.

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

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

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 di gestire questi formati speciali. Tutto quello che devi fare è archiviare e riprodurre la versione appiattita del video anziché quella originale.