Framework Cast menyediakan API antrean yang mendukung pembuatan daftar item konten, seperti streaming video atau audio, untuk diputar secara berurutan di Penerima Web. Antrean item konten dapat diedit, disusun ulang, diperbarui, dan seterusnya.
Web Receiver SDK 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 menyelesaikan pemutaran atau pengirim menghentikan pemutaran dan menghentikan 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 hilang.
Membuat dan memuat item antrean media
Di iOS, item antrean media direpresentasikan dalam framework Cast sebagai
instance GCKMediaQueueItem
.
Saat membuat item antrean media dengan konten adaptif, Anda dapat menyetel
waktu pramuat agar pemutar dapat mulai melakukan buffering item antrean media sebelum
item di depannya dalam antrean selesai diputar. Lihat selengkapnya tentang pramuat di
panduan pramuat Penerima Web.
Menyetel atribut putar otomatis item ke benar (true) memungkinkan Penerima Web memutarnya secara otomatis. Misalnya, Anda dapat menggunakan pola builder untuk membuat item antrean media seperti berikut:
let builder = GCKMediaQueueItemBuilder.init() builder.mediaInformation = mediaInformation builder.autoplay = true builder.preloadTime = 8.0 let newItem = builder.build()
GCKMediaQueueItemBuilder *builder = [[GCKMediaQueueItemBuilder alloc] init]; builder.mediaInformation = self.mediaInformation; builder.autoplay = YES; builder.preloadTime = 8.0; GCKMediaQueueItem *newItem = [builder build];
Muat array item antrean media dalam antrean menggunakan metode
queueLoadItems
dari
class
GCKRemoteMediaClient
yang sesuai.
Menerima pembaruan status antrean media
Saat Penerima Web memuat item antrean media, ID unik akan ditetapkan ke item yang tetap ada selama durasi sesi (dan masa aktif antrean).
Anda dapat mempelajari status antrean yang menunjukkan item mana yang sedang dimuat (mungkin tidak diputar), dimuat, atau dipramuat. Anda juga bisa mendapatkan daftar urut
dari semua item dalam antrean. Class
GCKMediaStatus
memberikan informasi status berikut:
- Properti
preloadedItemID
- ID item yang saat ini dipramuat, jika ada. - Properti
loadingItemID
- ID item yang sedang dimuat, - Properti
currentItemID
- ID item antrean saat ini, jika ada. queueItemCount
- Menampilkan jumlah item dalam antrean pemutaran.queueItemAtIndex
- Menampilkan item pada indeks yang ditentukan dalam antrean pemutaran.
Gunakan anggota ini bersama anggota status media lainnya untuk memberi tahu
aplikasi Anda tentang status antrean dan item dalam antrean. Selain
pembaruan status media dari Penerima Web, Anda dapat memproses perubahan
pada antrean dengan menerapkan -[remoteMediaClientDidUpdateQueue:]
dari
GCKRemoteMediaClientListener
.
Edit antrean
Untuk menangani item dalam antrean, gunakan metode antrean GCKRemoteMediaClient
.
Anda memiliki beberapa API. Fungsi ini memungkinkan Anda memuat array item ke antrean baru, menyisipkan item ke dalam antrean yang ada, memperbarui properti item dalam antrean, membuat item melompat maju atau mundur dalam antrean, menetapkan properti antrean itu sendiri (misalnya, mengubah repeatMode
yang memilih item berikutnya), menghapus item dari antrean, dan mengubah urutan item dalam antrean.