Aplikacja odtwarzająca multimedia wymaga elementów interfejsu użytkownika do wyświetlania multimediów i sterowania odtwarzaniem. Biblioteka Media3 zawiera moduł interfejsu użytkownika, który zawiera wiele komponentów interfejsu. Aby utworzyć zależność od modułu interfejsu, dodaj tę zależność:
Kotlin
implementation("androidx.media3:media3-ui:1.5.1")
Groovy
implementation "androidx.media3:media3-ui:1.5.1"
Najważniejszym elementem jest PlayerView, czyli widok odtwarzania multimediów.
PlayerView wyświetla film, obrazy, napisy i okładkę albumu podczas odtwarzania, a także elementy sterujące odtwarzaniem.
PlayerView ma metodę setPlayer() dołączania i odłączania (poprzez przekazywanie null) instancji odtwarzacza.
PlayerView
PlayerView może służyć do odtwarzania filmów, obrazów i dźwięku. Renderuje on filmy i napisy w przypadku odtwarzania wideo, bitmapy w przypadku odtwarzania obrazu oraz może wyświetlać elementy graficzne zawarte w metadanych w plikach audio. Możesz go umieścić w plikach układu tak samo jak każdy inny komponent UI. Na przykład pole PlayerView może być uwzględnione w tym pliku 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"/>
Wycinek powyżej 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 wygody. Większość z tych atrybutów ma odpowiednie metody settera, które można wykorzystać do dostosowywania widoku w czasie wykonywania. W dokumentacji PlayerView znajdziesz więcej informacji o tych atrybutach i metodach ustawiania.
Gdy widok zostanie zadeklarowany w pliku układu, można go wyszukać w metodie 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 funkcję 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();
Wybieranie typu powierzchni
Atrybut surface_type elementu PlayerView pozwala określić typ powierzchni, na której wyświetlany jest film. Oprócz wartości spherical_gl_surface_view (która jest wartością specjalną dla odtwarzania filmów sferycznych) i video_decoder_gl_surface_view (która służy do renderowania filmów za pomocą rendererów rozszerzeń), dozwolone wartości to surface_view, texture_view i none. Jeśli widok służy tylko do odtwarzania dźwięku, należy użyć none, aby uniknąć tworzenia powierzchni, ponieważ może to być kosztowne.
Jeśli widok służy do odtwarzania zwykłego filmu, należy użyć parametru surface_view lub texture_view. SurfaceView ma szereg zalet w porównaniu z TextureView w przypadku odtwarzania filmów:
- znacznie obniżyć zużycie energii na wielu urządzeniach;
- Dokładniejsze ustalanie czasu wyświetlania klatek, co zapewnia płynniejsze odtwarzanie filmów.
- Obsługa wyjścia wideo HDR o wyższej jakości na urządzeniach, które obsługują tę funkcję.
- Obsługa bezpiecznego wyjścia podczas odtwarzania treści chronionych przez DRM.
- Możliwość renderowania treści wideo w pełnej rozdzielczości wyświetlacza na urządzeniach z Androidem TV, które powiększają warstwę interfejsu użytkownika.
Dlatego, jeśli to możliwe, preferuj SurfaceView zamiast TextureView.
TextureView należy stosować tylko wtedy, gdy SurfaceView nie spełnia Twoich potrzeb. Przykładem jest płynne wyświetlanie animacji lub przewijanie powierzchni wideo w wersjach Androida 7.0 (interfejs API 24) i starszych, jak opisano w uwagach poniżej. W tym przypadku lepiej jest użyć TextureView tylko wtedy, gdy SDK_INT jest mniejsza niż 24 (Android 7.0), a w przeciwnym razie SurfaceView.
Nawigacja za pomocą panelu kierunkowego na Androidzie TV
Pilot Android TV ma panel sterujący, który wysyła polecenia jako zdarzenia klawisza w urządzeniu dispatchKeyEvent(KeyEvent).Activity Te zadania muszą zostać przydzielone do widoku odtwarzacza:
Kotlin
override fun dispatchKeyEvent(event: KeyEvent?): Boolean{ return playerView.dispatchKeyEvent(event!!) || super.dispatchKeyEvent(event) }
Java
@Override public boolean dispatchKeyEvent(KeyEvent event) { return playerView.dispatchKeyEvent(event) || super.dispatchKeyEvent(event); }
Żądanie skupienia na widoku odtwarzacza jest ważne dla nawigacji po elementach sterujących odtwarzaniem i pomijania reklam. Zastanów się, czy chcesz skupić się na onCreate w ramach Activity:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // ... playerView.requestFocus() // ... }
Java
@Override public void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); // ... playerView.requestFocus(); // ... }
Jeśli używasz Compose na Androidzie TV, musisz umożliwić skupienie na elemencie AndroidView i przekazać zdarzenie, przekazując parametr modyfikatora do elementu AndroidView:
AndroidView(
modifier = modifier
.focusable()
.onKeyEvent { playerView.dispatchKeyEvent(it.nativeKeyEvent) },
factory = { playerView }
)