Danh sách chờ

Khung Truyền cung cấp các API xếp hàng hỗ trợ tạo danh sách các mục nội dung, chẳng hạn như luồng video hoặc âm thanh, để phát tuần tự trên Trình nhận web. Bạn có thể chỉnh sửa, sắp xếp lại, cập nhật hàng đợi của các mục nội dung, v.v.

Web receiver SDK duy trì hàng đợi và phản hồi các thao tác trong hàng đợi, miễn là hàng đợi có ít nhất một mục hiện đang hoạt động (phát hoặc tạm dừng). Người gửi có thể tham gia phiên họp và thêm các mục vào hàng đợi. Trình nhận duy trì phiên cho các mục trong hàng đợi cho đến khi mục cuối cùng phát xong hoặc người gửi dừng phát và kết thúc phiên, hoặc cho đến khi người gửi tải một hàng đợi mới trên trình nhận. Theo mặc định, trình thu nhận không duy trì bất kỳ thông tin nào về hàng đợi đã chấm dứt. Khi mục cuối cùng trong hàng đợi hoàn tất, phiên phát nội dung đa phương tiện sẽ kết thúc và hàng đợi sẽ biến mất.

Tạo và tải các mục trong hàng đợi nội dung nghe nhìn

Trong iOS, một mục trong hàng đợi nội dung nghe nhìn được biểu thị trong khung Truyền dưới dạng thực thể GCKMediaQueueItem. Khi tạo một mục hàng đợi nội dung đa phương tiện có nội dung thích ứng, bạn có thể đặt thời gian tải trước để trình phát có thể bắt đầu lưu vào bộ đệm mục hàng đợi nội dung đa phương tiện trước khi mục trước nó trong hàng đợi kết thúc quá trình phát. Xem thêm về cách tải trước trong Hướng dẫn tải trước Trình thu thập dữ liệu web.

Việc đặt thuộc tính tự động phát của mục thành true sẽ cho phép Bộ nhận web tự động phát nội dung đó. Ví dụ: bạn có thể sử dụng mẫu trình tạo để tạo mục hàng đợi nội dung đa phương tiện như sau:

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];

Tải một mảng các mục trong hàng đợi nội dung nghe nhìn bằng cách sử dụng phương thức queueLoadItems thích hợp của lớp GCKRemoteMediaClient.

Nhận thông tin cập nhật về trạng thái hàng đợi nội dung nghe nhìn

Khi tải một mục trong hàng đợi nội dung đa phương tiện, Trình thu nhận web sẽ gán một mã nhận dạng duy nhất cho mục tồn tại trong thời gian diễn ra phiên (và thời gian tồn tại của hàng đợi). Bạn có thể tìm hiểu trạng thái của hàng đợi cho biết mục nào hiện đang được tải (mục này có thể không phát), đang tải hay đã tải trước. Bạn cũng có thể lấy danh sách theo thứ tự của tất cả các mục trong hàng đợi. Lớp GCKMediaStatus cung cấp thông tin trạng thái sau:

  • Thuộc tính preloadedItemID – Mã nhận dạng của mục hiện đang được tải trước, nếu có.
  • Thuộc tính loadingItemID – Mã nhận dạng của mục hiện đang tải,
  • Thuộc tính currentItemID – Mã nhận dạng của mục trong hàng đợi hiện tại, nếu có.
  • Phương thức queueItemCount – Trả về số lượng mục trong hàng đợi phát.
  • Phương thức queueItemAtIndex – Trả về mục tại chỉ mục đã chỉ định trong hàng đợi phát.

Sử dụng các thành phần này cùng với các thành phần khác của trạng thái nội dung đa phương tiện để thông báo cho ứng dụng của bạn về trạng thái của hàng đợi và các mục trong hàng đợi. Ngoài thông tin cập nhật về trạng thái nội dung nghe nhìn từ Trình thu nhận web, bạn có thể theo dõi các thay đổi đối với hàng đợi này bằng cách triển khai -[remoteMediaClientDidUpdateQueue:] của GCKRemoteMediaClientListener.

Chỉnh sửa danh sách chờ

Để xử lý các mục trong hàng đợi, hãy sử dụng các phương thức hàng đợi của GCKRemoteMediaClient. bạn có một số API. Các tính năng này cho phép bạn tải một mảng các mục vào hàng đợi mới, chèn các mục vào hàng đợi hiện có, cập nhật thuộc tính của các mục trong hàng đợi, thực hiện việc tiến hoặc lùi trong hàng đợi, đặt thuộc tính của chính hàng đợi (ví dụ: thay đổi repeatMode để chọn mục tiếp theo), xoá các mục khỏi hàng đợi và sắp xếp lại các mục trong hàng đợi.