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.