Lớp GCKMediaQueue

Mô hình dữ liệu thể hiện một hàng đợi nội dung đa phương tiện có độ dài tuỳ ý.

Bạn có thể dùng lớp này làm cơ sở triển khai UITableViewDataSource để điều khiển giao diện người dùng hàng đợi nội dung nghe nhìn.

GCKMediaQueue theo dõi các sự kiện GCKSessionManager và tự động đính kèm vào GCKRemoteMediaClient khi phiên Truyền bắt đầu. Trình thu thập thông tin theo dõi các thông báo về thay đổi hàng đợi từ GCKRemoteMediaClient và cập nhật mô hình dữ liệu nội bộ cho phù hợp. Tương tự, mã này sử dụng GCKRemoteMediaClient để tìm nạp thông tin trong hàng đợi theo yêu cầu.

Mô hình này duy trì một danh sách mã mục trong hàng đợi cho toàn bộ hàng đợi; tự động tìm nạp danh sách này mỗi khi đính kèm vào một phiên Truyền. Lớp này cũng duy trì một bộ nhớ đệm LRU (có kích thước có thể định cấu hình) của GCKMediaQueueItems, được khoá theo mã mục trong hàng đợi.

Phương thức itemAtIndex: (GCKMediaQueue) được dùng để tìm nạp một mục trong hàng đợi tại một chỉ mục nhất định. Nếu GCKMediaQueueItem hiện không có trong bộ nhớ đệm, thì một yêu cầu không đồng bộ sẽ được thực hiện để tìm nạp mục đó từ trình thu nhận và cuối cùng, người được uỷ quyền sẽ nhận được thông báo khi nhận được các mục được yêu cầu.

Nếu bạn thực hiện nhiều lệnh gọi đến phương thức này trong thời gian rất ngắn, thì mã mục được yêu cầu sẽ được phân lô nội bộ để giảm số lượng yêu cầu mạng được thực hiện. Vì có giới hạn trên về số lượng mục trong hàng đợi có thể tìm nạp được qua trình nhận tại một thời điểm, nên GCKMediaQueue sẽ áp dụng một cửa sổ luân phiên để tìm nạp N mã mục cuối cùng. Do đó, nếu người dùng yêu cầu quá nhiều mục trong một khoảng thời gian ngắn, thì hệ thống chỉ thực sự tìm nạp được N mục cuối cùng. Hành vi này giúp quản lý hiệu quả một hàng đợi rất dài trong giao diện người dùng của ứng dụng mà người dùng có thể cuộn qua một cách nhanh chóng và/hoặc thường xuyên.

GCKMediaQueue không cung cấp bất kỳ phương thức nào để sửa đổi trực tiếp hàng đợi, vì mọi thay đổi như vậy đều liên quan đến yêu cầu mạng không đồng bộ đến trình thu nhận (thông qua các phương thức trên GCKRemoteMediaClient), và có thể không thực hiện được do lỗi. GCKMediaQueue phải đảm bảo sự thể hiện nhất quán của hàng đợi như tồn tại trên trình thu nhận. Vì vậy, việc thực hiện các thay đổi cục bộ đối với mô hình dữ liệu chưa được cam kết trên trình thu nhận có thể dẫn đến hành vi không chính xác trên giao diện người dùng.

Xem GCKMediaQueueDelegate để biết giao thức uỷ quyền.

Năm thành lập

4.3.4