Interfejs odtwarzacza

Odtwarzacz to komponent aplikacji, który umożliwia odtwarzanie elementów multimedialnych. Interfejs Media3 Player zawiera zarys funkcji obsługiwanych zwykle przez odtwarzacz. Obejmuje to:

• wpływają na elementy sterujące odtwarzaniem, takie jak odtwarzanie, wstrzymywanie i przewijanie;
• właściwości odtwarzanych obecnie multimediów, takie jak pozycja odtwarzania;
• zarządzanie playlistą lub kolejką multimediów,
• konfigurować właściwości odtwarzania, takie jak losowanie, powtarzanie, szybkość i głośność;
• Renderowanie filmu na ekranie

Media3 udostępnia też implementację interfejsu Player o nazwie ExoPlayer.

wspólny interfejs między komponentami,

Interfejs odtwarzacza jest implementowany w kilku komponentach Media3, na przykład:

Chociaż MediaSession nie implementuje interfejsu Player, wymaga utworzenia Player. Jego zadaniem jest zapewnienie dostępu do obiektu Player z innych procesów lub wątków.

Architektura odtwarzania Media3

Jeśli masz dostęp do Player, aby wydawać polecenia odtwarzania, wywołuj bezpośrednio jego metody. Możesz reklamować odtwarzanie i przyznać zewnętrznym źródłom kontrolę nad odtwarzaniem, wdrażając MediaSession. Te zewnętrzne źródła implementują interfejs MediaController, który ułatwia łączenie się z sesją multimediów oraz wysyłanie żądań odtwarzania.

Podczas odtwarzania multimediów w tle musisz umieścić sesję multimediów i odtwarzacz w ramach MediaSessionService lub MediaLibraryService, który działa jako usługa na pierwszym planie. Jeśli to zrobisz, możesz oddzielić odtwarzacz od sekcji Aktywność w aplikacji, która zawiera interfejs sterowania odtwarzaniem. Może to wymagać użycia kontrolera multimediów.

Stan gracza

Stan odtwarzacza multimediów implementującego interfejs Player składa się głównie z 4 kategorii informacji:

1. Stan odtwarzania
   • Odbierz za pomocą: getPlaybackState().
   • Wartości stanu zdefiniowane przez interfejs to: STATE_IDLE, STATE_BUFFERING, STATE_READY i STATE_ENDED.
2. Playlista z elementami multimedialnymi
   • Sekwencja MediaItem instancji do odtworzenia.
   • Odzyskaj za pomocą getCurrentTimeline()
   • Player może zawierać metody operacji na playlistach, takie jak dodawanie lub usuwanieMediaItem, a także metody ułatwiające pracę, takie jak getCurrentMediaItem().
3. Właściwości odtwarzania/wstrzymywania, takie jak:
   • playWhenReady: wskazanie, czy użytkownik chce, aby multimedia były odtwarzane, gdy to możliwe, czy mają pozostać wstrzymane.
   • Przyczyna wstrzymania odtwarzania: informacja o przyczynach wstrzymania odtwarzania (jeśli ma to zastosowanie), nawet jeśli parametr playWhenReady ma wartość true.
   • isPlaying: informacja o tym, czy odtwarzacz obecnie odtwarza. Ta wartość będzie mieć wartość true tylko wtedy, gdy stan odtwarzania to STATE_READY, playWhenReady ma wartość true, a odtwarzanie nie jest wstrzymane
4. pozycja odtwarzania, w tym:
   • Bieżący indeks elementu multimedialnego: indeks bieżącego MediaItem na playliście.
   • isPlayingAd: Wskazanie, czy wstawiona reklama jest odtwarzana.
   • Obecna pozycja odtwarzania: obecna pozycja odtwarzania w bieżącym MediaItem lub w osadzonej reklamie.

Dodatkowo interfejs Player umożliwia dostęp do dostępnych ścieżek, metadanych multimediów, szybkości odtwarzania, głośności i innych właściwości pomocniczych odtwarzania.

Nasłuchiwanie zmian

Użyj Player.Listener, aby nasłuchiwać zmian w Player. Szczegółowe informacje o tym, jak utworzyć detektor i jak używać detektora, znajdziesz w dokumentacji ExoPlayer dotyczącej zdarzeń odtwarzacza.

Pamiętaj, że interfejs listenera nie zawiera żadnych wywołań zwrotnych do śledzenia normalnego odtwarzania. Aby stale monitorować postęp odtwarzania, np. skonfigurować interfejs paska postępu, wysyłaj zapytania dotyczące bieżącej pozycji w odpowiednich odstępach czasu.

val handler = Handler(Looper.getMainLooper())
fun checkPlaybackPosition(delayMs: Long): Boolean =
  handler.postDelayed(
    {
      val currentPosition = player.currentPosition
      // Update UI based on currentPosition
      checkPlaybackPosition(delayMs)
    },
    delayMs)

Handler handler = new Handler(Looper.getMainLooper());
boolean checkPlaybackPosition(long delayMs) {
    return handler.postDelayed(() -> {
        long currentPosition = player.getCurrentPosition();
        // Update UI based on currentPosition
        checkPlaybackPosition(delayMs);
    }, delayMs);
}

Sterowanie odtwarzaniem

Interfejs Player oferuje wiele sposobów na manipulowanie stanem i sterowanie odtwarzaniem:

• Podstawowe elementy sterujące odtwarzaniem, takie jak play(), pause(), prepare() i stop().
• Operacje na playlistach, takie jak addMediaItem() lub removeMediaItem().
• Seeking (przeszukiwanie) – służy do zmiany bieżącego elementu lub pozycji.
• Ustaw tryby powtarzania i tryb odtwarzania losowego.
• Zaktualizuj preferencje wyboru ścieżki.
• Ustaw szybkość odtwarzania.

Implementacje niestandardowe Player

Aby utworzyć odtwarzacz niestandardowy, możesz rozszerzyć zasób SimpleBasePlayer zawarty w Media3. Ta klasa stanowi podstawową implementację interfejsu Player, aby ograniczyć do minimum liczbę metod, które trzeba wdrożyć.

Zacznij od zastąpienia metody getState(). Ta metoda po wywołaniu powinna wypełniać bieżący stan odtwarzacza, w tym:

• zestaw dostępnych poleceń;
• właściwości odtwarzania, takie jak to, czy odtwarzacz powinien rozpocząć odtwarzanie, gdy stan odtwarzania to STATE_READY, indeks aktualnie odtwarzanego elementu multimedialnego oraz pozycja odtwarzania w bieżącym elemencie;

class CustomPlayer : SimpleBasePlayer(looper) {
  override fun getState(): State {
    return State.Builder()
      .setAvailableCommands(...) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build()
  }
}

public class CustomPlayer extends SimpleBasePlayer {
  public CustomPlayer(Looper looper) {
    super(looper);
  }

  @Override
  protected State getState() {
    return new State.Builder()
      .setAvailableCommands(...) // Set which playback commands the player can handle
      // Configure additional playback properties
      .setPlayWhenReady(true, PLAY_WHEN_READY_CHANGE_REASON_USER_REQUEST)
      .setCurrentMediaItemIndex(0)
      .setContentPositionMs(0)
      .build();
  }
}

SimpleBasePlayer spowoduje, że State zostanie utworzony z poprawną kombinacją wartości stanu. Będzie on również obsługiwać detektory i informować słuchaczy o zmianach stanu. Jeśli chcesz ręcznie zaktualizować stan, zadzwoń pod numer invalidateState().

Oprócz metody getState() musisz zaimplementować tylko te metody, które są używane do poleceń, które Twój odtwarzacz deklaruje jako dostępne. Znajdź metodę obsługi, którą można zastąpić, odpowiadającą funkcji, którą chcesz zaimplementować. Na przykład: zastąpić metodę handleSeek(), aby obsługiwać operacje takie jak COMMAND_SEEK_IN_CURRENT_MEDIA_ITEMi COMMAND_SEEK_TO_NEXT_MEDIA_ITEM.