Mengantre

Framework Cast menyediakan API antrean yang mendukung pembuatan daftar item konten, seperti streaming video atau audio, untuk diputar secara berurutan di Web Penerima. Antrean item konten dapat diedit, diurutkan ulang, diperbarui, dan sebagainya dan seterusnya.

Catatan: Tinjau Putar Otomatis Google Cast untuk audio terbaik saat mendesain pengalaman putar otomatis atau antrean untuk Cast.

Web Receiver SDK mengelola antrean dan merespons operasi pada dalam antrean selama antrean memiliki setidaknya satu item yang sedang aktif (sedang 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 mengakhiri sesi, atau hingga pengirim memuat antrean baru di penerima. Penerima tidak mempertahankan informasi tentang antrean yang dihentikan secara {i>default<i}. Setelah item terakhir dalam antrean selesai, sesi media berakhir dan antrean menghilang.

Catatan: Bergaya dan Penerima 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 ditampilkan dalam framework Cast sebagai Instance GCKMediaQueueItem. Saat membuat item antrean media dengan konten adaptif, Anda dapat menyetel waktu pramuat sehingga pemutar dapat mulai menyangga item antrean media sebelum item di depannya dalam antrean selesai diputar. Lihat selengkapnya tentang pramuat di tindakan Panduan pramuat Penerima Web.

Menyetel putar otomatis item ke true (benar) 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 dengan menggunakan Metode queueLoadItems dari GCKRemoteMediaClient .

Menerima pembaruan status antrean media

Saat Penerima Web memuat item antrean media, penerima web menetapkan ID unik ke item yang bertahan selama durasi sesi (dan masa aktif antrean). Anda dapat mempelajari status antrean yang menunjukkan item mana yang saat ini dimuat (mungkin tidak sedang diputar), memuat, atau dipramuat. Anda juga bisa mendapatkan pesanan daftar semua item dalam antrean. Tujuan GCKMediaStatus memberikan informasi status berikut:

• preloadedItemID properti - ID item yang saat ini dipramuat, jika ada.
• loadingItemID - ID item yang sedang dimuat,
• currentItemID properti - ID item antrean saat ini, jika ada.
• queueItemCount - Menampilkan jumlah item dalam antrean pemutaran.
• queueItemAtIndex - Menampilkan item di indeks yang ditetapkan dalam antrean pemutaran.

Gunakan anggota ini bersama dengan anggota status media lainnya untuk memberi tahu tentang status antrean dan item dalam antrean. Selain pembaruan status media dari Penerima Web, Anda dapat mendengarkan perubahan pada antrean dengan mengimplementasikan -[remoteMediaClientDidUpdateQueue:] GCKRemoteMediaClientListener.

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

Edit antrean

Untuk bekerja dengan item dalam antrean, gunakan metode antrean GCKRemoteMediaClient Anda memiliki beberapa API. Ini memungkinkan Anda memuat array item ke dalam antrean baru, memasukkan item ke antrean yang ada, memperbarui properti item antrian, membuat item melompat maju atau mundur dalam antrian, mengatur properti antrean itu sendiri (misalnya, ubah repeatMode yang memilih antrean item), hapus item dari antrean, dan susun ulang item dalam antrean.