Jetpack Media3 è la nuova sede delle raccolte multimediali che consente alle app per Android di mostrare esperienze audio e visive complete. Media3 offre un'architettura semplice con potenti funzionalità di personalizzazione, affidabilità e ottimizzazioni basate sulle funzionalità del dispositivo per astrarre la complessità derivante dalla frammentazione.
Questo documento fornisce un'introduzione alle API principali per l'implementazione di casi d'uso di riproduzione e modifica con Media3.
Componenti di riproduzione
Media3 offre diversi componenti chiave per i casi d'uso di riproduzione. Le classi che compongono questi componenti ti saranno familiari se hai lavorato con le raccolte multimediali Android precedenti.
Il seguente diagramma mostra come questi componenti si uniscono in un'app tipica.
Il media player
Un media player è un componente della tua app che consente la riproduzione di file multimediali. In Media3 troverai:
| Classe | Descrizione | Nota sull'implementazione |
|---|---|---|
Player |
Player è un'interfaccia che definisce le funzionalità tradizionali di alto livello per un media player, come la possibilità di riprodurre, mettere in pausa e cercare.
|
In Media3, l'interfaccia Player è un'API comune implementata o utilizzata da diversi componenti, tra cui MediaSession e MediaController, ad esempio.
|
ExoPlayer |
ExoPlayer è l'implementazione predefinita dell'interfaccia Player in Media3.
|
Scopri di più su Media3 ExoPlayer
La sessione multimediale
Una sessione multimediale fornisce un modo universale per interagire con un media player. In questo modo, un'app può pubblicizzare la riproduzione di contenuti multimediali a fonti esterne e ricevere richieste di controlli di riproduzione da fonti esterne. In Media3 troverai:
| Classe | Descrizione | Nota sull'implementazione |
|---|---|---|
MediaSession |
Le sessioni multimediali consentono alla tua app di interagire con un video player o un audio player. Pubblicizzano la riproduzione di contenuti multimediali esternamente e ricevono comandi di riproduzione da fonti esterne. |
In Media3, un MediaSession richiede un Player per eseguire i comandi e ottenere lo stato corrente.
|
MediaSessionService |
MediaSessionService contiene una sessione multimediale e il relativo player associato in un servizio separato dall'Activity principale dell'app per facilitare la riproduzione in background.
|
|
MediaController |
La classe MediaController viene generalmente utilizzata per inviare comandi dall'esterno dell'app, ad esempio da altre app o dal sistema stesso.
I comandi vengono inviati al Player sottostante del MediaSession associato.
|
La classe MediaController implementa l'interfaccia Player, ma quando viene chiamato un metodo, MediaController invia il comando inviato al MediaSession connesso. Le app client come l'Assistente Google possono utilizzare MediaController per controllare la riproduzione in una sessione connessa.
|
MediaLibraryService |
Un MediaLibraryService è simile a un MediaSessionService, ma include API aggiuntive per consentirti di pubblicare la tua raccolta di contenuti nelle app client.
|
|
MediaBrowser |
La classe MediaBrowser consente all'utente di navigare nella raccolta di contenuti di un'app multimediale e selezionare gli elementi da riprodurre.
|
La classe MediaBrowser implementa sia l'interfaccia MediaController sia l'interfaccia Player. Analogamente a MediaController, le app client come Android Auto in genere implementano MediaBrowser.
|
Scopri di più su Media3 MediaSession
I componenti UI
Media3 fornisce componenti UI predefiniti per la visualizzazione di video e il controllo della riproduzione.
| Classe | Descrizione | Nota sull'implementazione |
|---|---|---|
PlayerView |
Un elemento View predefinito per mostrare i controlli di riproduzione e del video.
|
Si connette a ExoPlayer, MediaController o a qualsiasi altro Player personalizzato.
|
PlayerSurface |
Un Composable che rappresenta un disegno dedicato
Surface
per mostrare il video.
|
Si connette a qualsiasi Player, ma non contiene controlli di riproduzione.
Utilizzato solo per il rendering dei frame e può essere ridimensionato in base ai vari tipi di
ContentScale. Questo e molti altri elementi componibili sono disponibili nelle utilità di Compose UI.
|
Scopri di più sulla UI di Media3
Modifica dei componenti
Media3 include le API Transformer per i casi d'uso di editing multimediale, tra cui:
- Elaborazione di audio e video, ad esempio l'aggiunta di filtri ed effetti
- Gestione di formati speciali, come video HDR e video in slow motion
- Composizione, ad esempio la combinazione di più file di input
- Esportazione dell'output finale in un file
| Classe | Descrizione | Nota sull'implementazione |
|---|---|---|
Transformer |
Utilizza la classe Transformer per avviare e interrompere le trasformazioni e per verificare la presenza di aggiornamenti sullo stato di avanzamento di una trasformazione in esecuzione.
|
|
Effects |
Un oggetto Effects è una raccolta di effetti audio e video da applicare a un elemento multimediale.
|
Puoi utilizzare ExoPlayer per visualizzare l'anteprima degli effetti aggiunti a un elemento multimediale prima di avviare il processo di esportazione.
|
EditedMediaItem |
Un EditedMediaItem rappresenta un elemento multimediale da elaborare e le modifiche da applicare.
|
Scopri di più su Media3 Transformer
Video introduttivo
Guarda questo video per un'introduzione a Media3 da parte degli ingegneri che l'hanno creato:
Link utili
- Media Developer Center
ExoPlayerdocumenti- Guida alla migrazione
- AndroidX Media3 su GitHub
- App di esempio di sessione multimediale Media3
- App di esempio Universal Android Music Player