Mengantre

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.

Catatan: Tinjau Autoplay Google Cast untuk mengetahui praktik terbaik saat mendesain pengalaman putar otomatis atau antrean untuk Cast.

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.

Catatan: Penerima Bergaya dan Media Default hanya mendukung antrean streaming audio atau video. Untuk menggunakan antrean gambar, Anda harus mengembangkan Penerima Kustom.

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:

Swift

let builder = GCKMediaQueueItemBuilder.init()
builder.mediaInformation = mediaInformation
builder.autoplay = true
builder.preloadTime = 8.0
let newItem = builder.build()

Objective-C

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.

Catatan: Untuk memberikan pengalaman pengguna terbaik, aplikasi pengirim harus menampilkan item putar otomatis berikutnya dalam antrean di UI pengirim.

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.