Iniziare a utilizzare l'interfaccia utente basata sulle visualizzazioni

Aggiungi la dipendenza

Kotlin

implementation("androidx.media3:media3-ui:1.11.1")

Alla moda

implementation "androidx.media3:media3-ui:1.11.1"

PlayerView

Il componente più importante è PlayerView, una visualizzazione per la riproduzione di contenuti multimediali. PlayerView mostra video, immagini, sottotitoli e copertine degli album durante la riproduzione, oltre ai controlli di riproduzione.

PlayerView ha un metodo setPlayer() per collegare e scollegare (passando null) le istanze Player.

PlayerView può essere utilizzato per la riproduzione di video, immagini e audio. Esegue il rendering di video e sottotitoli nel caso della riproduzione di video, bitmap per la riproduzione di immagini e può visualizzare l'artwork incluso come metadati nei file audio. Puoi includerlo nei file di layout come qualsiasi altro componente dell'interfaccia utente. Ad esempio, un PlayerView può essere incluso con il seguente XML:

<androidx.media3.ui.PlayerView
    android:id="@+id/player_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:show_buffering="when_playing"
    app:show_shuffle_button="true"/>

Lo snippet riportato sopra mostra che PlayerView fornisce diversi attributi. Questi attributi possono essere utilizzati per personalizzare il comportamento della visualizzazione, nonché il suo aspetto. La maggior parte di questi attributi ha metodi setter corrispondenti, che possono essere utilizzati per personalizzare la visualizzazione in fase di runtime. La documentazione di PlayerView elenca questi attributi e metodi setter in modo più dettagliato.

Per un'esperienza utente più confortevole, valuta la possibilità di aggiungere l'attributo Android keepScreenOn o di impostare un wakelock, se utilizzi ExoPlayer. Puoi esaminare altre azioni che mantengono attivo il dispositivo nelle pagine relative al lavoro in background.

android:keepScreenOn="true"

Una volta dichiarata la visualizzazione nel file di layout, è possibile cercarla nel metodo onCreate dell'attività:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  // ...
  playerView = findViewById(R.id.player_view)
}
PlayerView.kt

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  // ...
  playerView = findViewById(R.id.player_view);
}
PlayerView.java

Una volta inizializzato, un player può essere collegato alla visualizzazione chiamando setPlayer:

Kotlin

// Instantiate the player.
val player = ExoPlayer.Builder(context).build()
// Attach player to the view.
playerView.player = player
// Set the media item to be played.
player.setMediaItem(mediaItem)
// Prepare the player.
player.prepare()
PlayerView.kt

Java

// Instantiate the player.
player = new ExoPlayer.Builder(context).build();
// Attach player to the view.
playerView.setPlayer(player);
// Set the media item to be played.
player.setMediaItem(mediaItem);
// Prepare the player.
player.prepare();
PlayerView.java

PlayerControlView

PlayerControlView è una delle PlayerView visualizzazioni secondarie che contiene la barra di avanzamento e i pulsanti per controllare la riproduzione. Tieni presente che PlayerControlView non è destinato a essere utilizzato come componente autonomo al di fuori di PlayerView. Può essere personalizzato impostando gli attributi su PlayerView (che verranno passati a PlayerControlView) o fornendo un controller personalizzato con android:id="@id/exo_controller.

Scegli un tipo di superficie

L'attributo surface_type di PlayerView ti consente di impostare il tipo di superficie utilizzata per la riproduzione dei video. I valori consentiti sono surface_view, texture_view, spherical_gl_surface_view (che è un valore speciale per la riproduzione di video sferici), video_decoder_gl_surface_view (per il rendering di video utilizzando renderer di estensione) e none (solo per la riproduzione audio). Per saperne di più su quale tipo di superficie scegliere, consulta la pagina Superficie.