Su Android 12 (livello API 31) e versioni successive, il sistema può convertire automaticamente i video registrati in formati quali HEVC (H.265) in AVC (H.264) quando i video vengono aperti da un'app che non supporta HEVC. Questa funzionalità consente alle app di acquisizione video di utilizzare una codifica più moderna ed efficiente in termini di archiviazione per i video registrati sul dispositivo senza sacrificare la compatibilità con altre app.
I seguenti formati possono essere transcodificati automaticamente per i contenuti creati sul dispositivo:
| Formato multimediale | Attributo XML | Tipo MIME MediaFormat |
|---|---|---|
| HEVC (H.265) | HEVC | MediaFormat.MIMETYPE_VIDEO_HEVC |
| HDR10 | HDR10 | MediaFeature.HdrType.HDR10 |
| HDR10+ | HDR10Plus | MediaFeature.HdrType.HDR10_PLUS |
Android presuppone che le app possano supportare la riproduzione di tutti i formati multimediali, pertanto la transcodifica di contenuti multimediali compatibili è disattivata per impostazione predefinita.
Quando utilizzare la transcodifica
La transcodifica è un'operazione costosa dal punto di vista del calcolo e aggiunge un ritardo significativo all'apertura di un file video. Ad esempio, la transcodifica di un file video HEVC di un minuto richiede circa 20 secondi in AVC su uno smartphone Pixel 3. Per questo motivo, devi transcodificare un file video solo quando lo invii al di fuori del dispositivo. ad esempio quando condividi un file video con altri utenti della stessa app o un server cloud che non supporta i formati video moderni.
Non eseguire la transcodifica quando apri i file video per la riproduzione sul dispositivo o per la creazione di miniature.
Configurazione della transcodifica
Le app possono controllare il comportamento di transcodifica dichiarando le proprie funzionalità multimediali. Ci sono due modi per dichiarare queste funzionalità: nel codice o in una risorsa.
Dichiara le funzionalità nel codice
Puoi dichiarare le funzionalità multimediali nel codice costruendo un'istanza di un oggetto ApplicationMediaCapabilities utilizzando un builder:
Kotlin
val mediaCapabilities = ApplicationMediaCapabilities.Builder()
.addSupportedVideoMimeType(MediaFormat.MIMETYPE_VIDEO_HEVC)
.addUnsupportedHdrType(MediaFeature.HdrType.HDR10)
.addUnsupportedHdrType(MediaFeature.HdrType.HDR10_PLUS)
.build()
Java
ApplicationMediaCapabilities mediaCapabilities = new ApplicationMediaCapabilities.Builder()
.addSupportedVideoMimeType(MediaFormat.MIMETYPE_VIDEO_HEVC)
.addUnsupportedHdrType(MediaFeature.HdrType.HDR10)
.addUnsupportedHdrType(MediaFeature.HdrType.HDR10_PLUS)
.build();
Utilizza questo oggetto quando accedi a contenuti multimediali tramite metodi come
ContentResolver#openTypedAssetFileDescriptor():
Kotlin
val providerOptions = Bundle().apply {
putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES, mediaCapabilities)
}
contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)
.use { fileDescriptor ->
// Content will be transcoded based on values defined in the
// ApplicationMediaCapabilities provided.
}
Java
Bundle providerOptions = new Bundle();
providerOptions.putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES, mediaCapabilities);
try (AssetFileDescriptor fileDescriptor = contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)) {
// Content will be transcoded based on values defined in the
// ApplicationMediaCapabilities provided.
}
Questo metodo consente un controllo granulare per particolari percorsi di codice, ad esempio richiamando la transcodifica solo durante il trasferimento di un file video al di fuori del dispositivo. Ha la precedenza sul metodo descritto di seguito.
Dichiara le funzionalità in una risorsa
La dichiarazione delle funzionalità in una risorsa consente un controllo generale sulla transcodifica. Questo metodo deve essere utilizzato solo in casi molto specifici. Ad esempio, se la tua app riceve file video solo da altre app (anziché aprirli direttamente) e li carica su un server che non supporta i codec video moderni (vedi lo scenario di esempio 1 di seguito).
L'utilizzo di questo metodo quando non è assolutamente necessario potrebbe richiamare la transcodifica in scenari indesiderati, ad esempio durante la riproduzione di miniature, con un conseguente peggioramento dell'esperienza utente.
Per utilizzare questo metodo, crea un file di risorse media_capabilities.xml:
<?xml version="1.0" encoding="utf-8"?>
<media-capabilities xmlns:android="http://schemas.android.com/apk/res/android">
<format android:name="HEVC" supported="true"/>
<format android:name="HDR10" supported="false"/>
<format android:name="HDR10Plus" supported="false"/>
</media-capabilities>
In questo esempio, i video HDR registrati sul dispositivo vengono transcodificati senza problemi in video AVC SDR (Standard Dynamic Range), al contrario dei video HEVC.
Utilizza un tag property all'interno del tag application per aggiungere un riferimento al file delle funzionalità multimediali. Aggiungi queste proprietà al file AndroidManifest.xml:
<property
android:name="android.media.PROPERTY_MEDIA_CAPABILITIES"
android:resource="@xml/media_capabilities" />
Utilizzo delle funzionalità multimediali di un'altra app per aprire un file video
Se la tua app condivide un file video con un'altra app, potrebbe essere necessario transcodificare il file video prima che l'app di destinazione possa aprirlo.
Per gestire questo caso, apri un file video utilizzando openTypedAssetFileDescriptor e specifica l'UID dell'app ricevente, che può essere ottenuto utilizzando Binder.getCallingUid.
La piattaforma utilizza quindi le funzionalità multimediali dell'app di destinazione per determinare se il file video deve essere transcodificato.
Kotlin
val providerOptions = Bundle().apply {
putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES_UID, Binder.getCallingUid())
}
contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)
.use { fileDescriptor ->
// Content will be transcoded based on the media capabilities of the
// calling app.
}
Java
Bundle providerOptions = new Bundle();
providerOptions.putParcelable(MediaStore.EXTRA_MEDIA_CAPABILITIES_UID, Binder.getCallingUid());
try (AssetFileDescriptor fileDescriptor = contentResolver.openTypedAssetFileDescriptor(mediaUri, mediaMimeType, providerOptions)) {
// Content will be transcoded based on the media capabilities of the
// calling app.
}
Scenari di esempio
I seguenti diagrammi mostrano i due casi d'uso comuni. In entrambi i casi, il video originale viene memorizzato in formato HEVC e l'app di condivisione video non supporta questo formato.
Esempio 1. La transcodifica viene avviata dall'app di acquisizione video.
L'app di condivisione video dichiara di non supportare HEVC nel file di risorse delle funzionalità multimediali. Richiede quindi un video dall'app di acquisizione video. L'app di acquisizione video gestisce la richiesta e apre il file utilizzando openTypedAssetFileDescriptor, specificando l'UID dell'app di condivisione. Questo avvia il processo di transcodifica.
Una volta ricevuto, il video transcodificato viene fornito all'app di condivisione, che lo carica su un server nel cloud.
Esempio 2. La transcodifica viene avviata dall'app di condivisione video.
L'app di acquisizione video condivide un video con l'app di condivisione video utilizzando un URI MediaStore. L'app di condivisione video apre il file video utilizzando openTypedAssetFileDescriptor, specificando che non supporta HEVC nelle funzionalità multimediali. Questo avvia il processo di transcodifica e, una volta completato, il file viene caricato su un server nel cloud.
Formati non dichiarati
La transcodifica di contenuti multimediali compatibili è abilitata per tutti i formati dichiarati non supportati ed è disabilitata per tutti i formati dichiarati supportati. Per gli altri formati non dichiarati, è la piattaforma a decidere se eseguire o meno la transcodifica. In Android 12 la transcodifica è disattivata per tutti i formati non dichiarati. Questo comportamento potrebbe cambiare per i nuovi formati in futuro.
Opzioni sviluppatore
Per eseguire l'override del comportamento di transcodifica predefinito di Android, puoi utilizzare le seguenti opzioni sviluppatore:
Sostituisci le impostazioni predefinite di transcodifica Questa impostazione determina se la piattaforma controlla o meno la transcodifica automatica. Quando l'override è abilitato, i valori predefiniti della piattaforma vengono ignorati e l'impostazione Attiva transcodifica controlla la transcodifica automatica. Questa opzione è disabilitata per impostazione predefinita.
Attiva transcodifica Questa impostazione specifica se i formati non dichiarati vengono transcodificati automaticamente. È abilitata per impostazione predefinita, ma ha un effetto solo se è abilitata anche l'opzione Sostituisci valori predefiniti per la transcodifica.
Presupponi che le app supportino i formati moderni. Questa impostazione controlla cosa succede quando l'app tenta di riprodurre un formato non dichiarato. Questo accade quando il manifest non dichiara se l'app supporta o meno un determinato formato oppure quando Google non ha aggiunto l'app all'elenco di transcodifica lato server. Se l'impostazione è attivata, l'app non esegue la transcodifica. Se è disattivata, l'app esegue la transcodifica. Questa opzione è abilitata per impostazione predefinita.
Mostra notifiche di transcodifica Se questa opzione è attiva, l'app visualizza una notifica di avanzamento della transcodifica quando la transcodifica viene attivata dalla lettura di un file multimediale non supportato. Questa opzione è abilitata per impostazione predefinita.
Disattiva cache di transcodifica Se questa opzione è attiva, le app che richiedono la transcodifica non utilizzano la cache di transcodifica. Ciò può essere utile durante lo sviluppo per attivare facilmente la transcodifica su un file multimediale non supportato, ma può causare prestazioni scadenti del dispositivo. Questa opzione è disattivata per impostazione predefinita.