Wprowadzenie do interfejsu użytkownika opartego na widokach

Dodaj zależność

Kotlin

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

Dynamiczny

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

PlayerView

Najważniejszym komponentem jest PlayerView, czyli widok odtwarzania multimediów. PlayerView wyświetla filmy, obrazy, napisy i okładki albumów podczas odtwarzania, a także elementy sterujące odtwarzaniem.

PlayerView ma metodę setPlayer() do dołączania i odłączania (przez przekazywanie null) instancji Player.

PlayerView można używać do odtwarzania filmów, obrazów i plików audio. Renderuje filmy i napisy w przypadku odtwarzania filmów, mapy bitowe w przypadku odtwarzania obrazów i może wyświetlać grafiki dołączone jako metadane w plikach audio. Możesz go uwzględnić w plikach układu tak samo jak każdy inny komponent interfejsu. Na przykład element PlayerView można uwzględnić w tym kodzie 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"/>

Powyższy fragment kodu pokazuje, że PlayerView udostępnia kilka atrybutów. Atrybutów tych można używać do dostosowywania zachowania widoku, a także jego wyglądu i stylu. Większość z tych atrybutów ma odpowiadające im metody ustawiające, których można używać do dostosowywania widoku w czasie działania. Więcej informacji o tych atrybutach i metodach ustawiających znajdziesz w dokumentacji PlayerView.

Aby zwiększyć wygodę użytkowników, rozważ dodanie atrybutu Androida keepScreenOn lub ustawienie blokady uśpienia, jeśli używasz ExoPlayera. Inne działania, które utrzymują urządzenie w stanie aktywności, możesz sprawdzić na stronach dotyczących pracy w tle.

android:keepScreenOn="true"

Po zadeklarowaniu widoku w pliku układu można go wyszukać w metodzie onCreate aktywności:

Kotlin

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

Java

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

Po zainicjowaniu odtwarzacza można go dołączyć do widoku, wywołując metodę 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()

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();

PlayerControlView

PlayerControlView to jeden z PlayerView widoków podrzędnych, który zawiera pasek postępu i przyciski do sterowania odtwarzaniem. Pamiętaj, że komponent PlayerControlView nie jest przeznaczony do używania jako samodzielny komponent poza PlayerView. Można go dostosować, ustawiając atrybuty w PlayerView (które zostaną przekazane do PlayerControlView) lub udostępniając niestandardowy kontroler za pomocą android:id="@id/exo_controller.

Wybieranie typu powierzchni

Atrybut surface_type elementu PlayerView umożliwia ustawienie typu platformy używanej do odtwarzania filmu. Dozwolone wartości to surface_view, texture_view, spherical_gl_surface_view (specjalna wartość do odtwarzania filmów sferycznych), video_decoder_gl_surface_view (do renderowania filmów za pomocą rozszerzeń renderujących) i none (tylko do odtwarzania dźwięku). Więcej informacji o tym, jaki typ powierzchni wybrać, znajdziesz na stronie poświęconej powierzchniom.