Framework Cast menyediakan class antrean yang mendukung pembuatan daftar
instance MediaQueueItem
, yang dapat dibuat dari instance MediaInfo
seperti streaming video atau
audio, untuk diputar secara berurutan di penerima. Antrean item konten ini dapat diedit, diurutkan ulang, diperbarui, dan sebagainya.
SDK Penerima mempertahankan antrean dan merespons operasi pada antrean selama antrean memiliki setidaknya satu item yang saat ini aktif (diputar atau dijeda). Pengirim dapat bergabung dalam sesi dan menambahkan item ke antrean. Penerima mempertahankan sesi untuk item antrean hingga item terakhir selesai diputar atau pengirim menghentikan pemutaran dan mengakhiri sesi, atau hingga pengirim memuat antrean baru di penerima. Secara default, penerima tidak menyimpan informasi apa pun tentang antrean yang dihentikan. Setelah item terakhir dalam antrean selesai, sesi media akan berakhir dan antrean akan menghilang.
Membuat dan memuat item antrean media
Item antrean media direpresentasikan dalam framework Cast sebagai
instance
MediaQueueItem
.
Saat membuat item antrean media, jika menggunakan Library
Media Player dengan konten adaptif, Anda dapat menyetel
waktu pramuat agar pemutar dapat mulai me-buffer item antrean media sebelum
item di depannya dalam antrean selesai diputar. Menyetel atribut putar otomatis
item ke benar (true) akan memungkinkan penerima memutarnya secara otomatis. Misalnya,
Anda dapat menggunakan pola builder untuk membuat item antrean media sebagai berikut:
val queueItem: MediaQueueItem = MediaQueueItem.Builder(mediaInfo) .setAutoplay(true) .setPreloadTime(20.0) .build()
MediaQueueItem queueItem = new MediaQueueItem.Builder(mediaInfo) .setAutoplay(true) .setPreloadTime(20) .build();
Muat array item antrean media dalam antrean menggunakan metode
queueLoad
yang sesuai dari RemoteMediaClient
.
Menerima pembaruan status antrean media
Saat penerima memuat item antrean media, penerima akan menetapkan ID unik ke item tersebut
yang akan tetap ada selama durasi sesi (dan masa aktif antrean). Aplikasi
Anda dapat mempelajari status antrean terkait item mana yang sedang dimuat
(mungkin tidak diputar), dimuat, atau dipramuat. Class
MediaStatus
memberikan informasi status berikut:
- Metode
getPreloadedItemId()
- Jika item berikutnya telah dipramuat, tampilkan ID item pramuat. - Metode
getLoadingItemId()
- Menampilkan ID item item yang sedang dimuat (tetapi tidak aktif dalam antrean) di penerima. getCurrentItemId()
- Menampilkan ID item item yang aktif dalam antrean (mungkin tidak diputar) pada saat perubahan status media terjadi.getQueueItems()
(Tidak digunakan lagi, gunakanMediaQueue
sebagai gantinya) - Menampilkan daftar instanceMediaQueueItem
sebagai daftar yang tidak dapat diubah.
Aplikasi Anda juga bisa mendapatkan daftar item menggunakan
class
MediaQueue
. Class adalah model data sparse dari antrean media. Metode ini menyimpan daftar
ID item dalam antrean, yang disinkronkan secara otomatis dengan penerima.
MediaQueue
tidak menyimpan semua
MediaQueueItem
karena akan memakan terlalu banyak memori jika antrean sangat panjang. Sebagai gantinya, alat ini mengambil item sesuai permintaan dan menyimpan LruCache
item yang baru diakses. Anda dapat menggunakan metode berikut untuk mengakses antrean media:
getItemIds()
- Menampilkan daftar semua ID item secara berurutan.getItemAtIndex()
- Menampilkan item yang di-cache pada indeks tertentu. Jika item tidak di-cache,MediaQueue
akan menampilkannull
dan menjadwalkan untuk mengambil item tersebut. Saat item diambil,MediaQueue.Callback#itemsUpdatedAtIndexes()
akan dipanggil, dan memanggilgetItemAtIndex()
dengan ID yang sama lagi akan menampilkan item tersebut.fetchMoteItemsRelativeToIndex()
digunakan saat pengguna men-scroll UI antrean ke atas atau bawah, dan aplikasi Anda ingin mengambil lebih banyak item dari cloud.
Gunakan metode ini bersama dengan metode status media lainnya untuk memberi tahu
aplikasi Anda tentang status antrean dan item dalam antrean. Selain
update status media dari penerima, aplikasi Anda dapat memproses perubahan pada
antrean dengan menerapkan
RemoteMediaClient.Callback
dan
MediaQueue.Callback
.
Selain itu, SDK Cast menyediakan dua class utilitas untuk membuat UI untuk antrean.
MediaQueueRecyclerViewAdapter
, untuk mencadangkan dataRecyclerView
MediaQueueListAdapter
, untuk mendukung dataListAdapter
.
Misalnya, untuk membuat RecyclerView
menggunakan 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); }
Edit antrean
Untuk mengoperasikan item dalam antrean, gunakan metode antrean class RemoteMediaClient
. Fungsi ini memungkinkan Anda memuat array item ke dalam antrean baru, menyisipkan item ke dalam antrean yang ada, mengupdate properti item dalam antrean, membuat item melompat maju atau mundur dalam antrean, menetapkan properti antrean itu sendiri (misalnya, mengubah algoritma repeatMode
yang memilih item berikutnya), menghapus item dari antrean, dan menyusun ulang item dalam antrean.