Kolejkowanie

Platforma Cast udostępnia klasy kolejkowania, które obsługują tworzenie list instancji MediaQueueItem, które można tworzyć z instancji MediaInfo, takich jak strumienie wideo lub audio, aby odtwarzać je sekwencyjnie na odbiorniku. Kolejkę elementów treści można edytować, zmieniać jej kolejność, aktualizować itp.

Odbiornik SDK utrzymuje kolejkę i odpowiada na operacje na niej, dopóki zawiera ona co najmniej 1 aktywny element (odtwarzany lub wstrzymany). Nadawcy mogą dołączyć do sesji i dodawać elementy do kolejki. Odbiornik utrzymuje sesję dla elementów kolejki, dopóki ostatni element nie zostanie odtworzony lub nadawca nie zatrzyma odtwarzania i nie zakończy sesji, albo dopóki nadawca nie wczyta nowej kolejki na odbiorniku. Odbiorca domyślnie nie przechowuje żadnych informacji o zakończonych kolejkach. Po zakończeniu odtwarzania ostatniego elementu w kolejce sesja multimedialna kończy się, a kolejka znika.

Tworzenie i wczytywanie elementów kolejki multimediów

Element kolejki multimediów jest reprezentowany w platformie Cast jako instancja MediaQueueItem. Podczas tworzenia elementu kolejki multimediów, jeśli używasz biblioteki odtwarzacza multimediów z treściami adaptacyjnymi, możesz ustawić czas wstępnego buforowania, aby odtwarzacz mógł rozpocząć buforowanie elementu kolejki multimediów, zanim skończy się odtwarzanie elementu znajdującego się przed nim w kolejce. Ustawienie atrybutu autoodtwarzania elementu na wartość „true” umożliwia automatyczne odtwarzanie go na urządzeniu odbierającym. Możesz na przykład użyć wzorca konstruktora, aby utworzyć element kolejki multimediów w ten sposób:

val queueItem: MediaQueueItem = MediaQueueItem.Builder(mediaInfo)
    .setAutoplay(true)
    .setPreloadTime(20.0)
    .build()

MediaQueueItem queueItem = new MediaQueueItem.Builder(mediaInfo)
  .setAutoplay(true)
  .setPreloadTime(20)
  .build();

Załaduj do kolejki tablicę elementów kolejki multimediów, korzystając z odpowiedniej metody queueLoad interfejsu RemoteMediaClient.

Otrzymywanie aktualizacji stanu kolejki multimediów

Gdy odbiornik wczytuje element kolejki multimediów, przypisuje mu unikalny identyfikator, który jest zachowywany przez cały czas trwania sesji (i kolejki). Twoja aplikacja może sprawdzać stan kolejki, czyli który element jest obecnie załadowany (może nie być odtwarzany), ładowany lub wstępnie załadowany. Klasa MediaStatus zawiera te informacje o stanie:

• getPreloadedItemId() method – jeśli następny element został wstępnie wczytany, zwraca identyfikator produktu.
• getLoadingItemId() method – zwraca identyfikator produktu, który jest obecnie wczytywany (ale nie jest aktywny w kolejce) na odbiorniku.
• getCurrentItemId() method – zwraca identyfikator produktu elementu, który był aktywny w kolejce (może nie być odtwarzany) w momencie zmiany stanu multimediów.
• getQueueItems() (Metoda wycofana, używaj MediaQueue) – zwraca listę instancji MediaQueueItem jako listę niemodyfikowalną.

Aplikacja może też pobrać listę elementów za pomocą klasy MediaQueue. Klasa jest modelem danych rzadkich kolejki multimediów. Przechowuje listę identyfikatorów elementów w kolejce, która jest automatycznie synchronizowana z odbiornikiem. MediaQueue nie przechowuje wszystkich MediaQueueItem, ponieważ przy bardzo długiej kolejce zajmowałoby to zbyt dużo pamięci. Zamiast tego pobiera elementy na żądanie i przechowuje LruCache ostatnio używanych elementów. Aby uzyskać dostęp do kolejki multimediów, możesz użyć tych metod:

• getItemIds() metoda – zwraca listę wszystkich identyfikatorów elementów w kolejności.
• getItemAtIndex() method – zwraca element z pamięci podręcznej o danym indeksie. Jeśli element nie jest w pamięci podręcznej, funkcja MediaQueue zwróci wartość null i zaplanuje pobranie elementu. Gdy element zostanie pobrany, zostanie wywołana funkcja MediaQueue.Callback#itemsUpdatedAtIndexes(), a ponowne wywołanie funkcji getItemAtIndex() z tym samym identyfikatorem zwróci element.
• fetchMoteItemsRelativeToIndex() jest używane, gdy użytkownik przewija interfejs kolejki do góry lub do dołu, a aplikacja chce pobrać więcej elementów z chmury.

Używaj tych metod razem z innymi metodami stanu multimediów, aby informować aplikację o stanie kolejki i elementów w niej. Oprócz aktualizacji stanu multimediów z odbiornika aplikacja może monitorować zmiany w kolejce, implementując RemoteMediaClient.Callback i MediaQueue.Callback.

Pakiet Cast SDK udostępnia też 2 klasy narzędziowe do tworzenia interfejsu kolejkowania.

• MediaQueueRecyclerViewAdapter, aby utworzyć kopię zapasową danych z RecyclerView
• MediaQueueListAdapter, do tworzenia kopii zapasowej danych ListAdapter.

Aby na przykład utworzyć RecyclerView za pomocą MediaQueueRecyclerViewAdapter:

class MyRecyclerViewAdapter(mediaQueue: MediaQueue?) :
    MediaQueueRecyclerViewAdapter<MyViewHolder?>(mediaQueue) {
    override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
        val item = getItem(position)

        // Update the view using `item`.
        ...
    }
}

class MyViewHolder : RecyclerView.ViewHolder {
    // Implement your own ViewHolder.
    ...
}

fun someMethod() {
    val adapter = MyRecyclerViewAdapter(
        mCastSession.remoteMediaClient.getMediaQueue())
    val recyclerView =
        activity.findViewById(R.id.my_recycler_view_id) as RecyclerView
    recyclerView.adapter = adapter
}

public class MyRecyclerViewAdapter extends MediaQueueRecyclerViewAdapter<MyViewHolder> {
    public MyRecyclerViewAdapter(MediaQueue mediaQueue) {
        super(mediaQueue);
    }

    @Override
    public void onBindViewHolder(MyViewHolder holder, int position) {
      MediaQueueItem item = getItem(position);

      // Update the view using `item`.
      ...
    }
}

public class MyViewHolder implements RecyclerView.ViewHolder {
  // Implement your own ViewHolder.
  ...
}

public void someMethod() {
    RecyclerView.Adapter adapter = new MyRecyclerViewAdapter(
        mCastSession.getRemoteMediaClient().getMediaQueue());
    RecyclerView recyclerView =
        (RecyclerView) getActivity().findViewById(R.id.my_recycler_view_id);
    recyclerView.setAdapter(adapter);
}

Edytowanie kolejki

Aby wykonywać operacje na elementach w kolejce, użyj metod kolejki klasy RemoteMediaClient. Umożliwiają one wczytywanie tablicy elementów do nowej kolejki, wstawianie elementów do istniejącej kolejki, aktualizowanie właściwości elementów w kolejce, przesuwanie elementu do przodu lub do tyłu w kolejce, ustawianie właściwości samej kolejki (np. zmiana repeatModealgorytmu, który wybiera następny element), usuwanie elementów z kolejki i zmiana kolejności elementów w kolejce.