Danh sách chờ

Khung Cast cung cấp các lớp xếp hàng hỗ trợ việc tạo danh sách thực thể MediaQueueItem. Bạn có thể tạo danh sách thực thể này từ các thực thể MediaInfo, chẳng hạn như luồng video hoặc âm thanh, để phát tuần tự trên receiver. Bạn có thể chỉnh sửa, sắp xếp lại, cập nhật các mục nội dung này, v.v.

SDK receiver 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 đang hoạt động (đang phát hoặc tạm dừng). Người gửi có thể tham gia phiên này và thêm các mục vào hàng đợi. Trình nhận duy trì một phiên cho các mục hàng đợi cho đến khi mục cuối cùng hoàn tất quá trình phát hoặc người gửi dừng phát và chấm dứt phiên, hoặc cho đến khi người gửi tải một hàng đợi mới trên receiver. Theo mặc định, receiver không lưu giữ bất kỳ thông tin nào về hàng đợi đã kết thúc. Khi mục cuối cùng trong hàng đợi kết thúc, phiên phát nội dung đa phương tiện kết thúc và hàng đợi biến mất.

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

Một mục hàng đợi nội dung đa phương tiện được biểu thị trong khung Truyền dưới dạng một phiên bản MediaQueueItem. Khi tạo một mục hàng đợi nội dung nghe nhìn, nếu bạn đang sử dụng Thư viện Media Player có nội dung thích ứng, thì bạn có thể đặt thời gian tải trước để trình phát có thể bắt đầu lưu mục hàng đợi nội dung nghe nhìn vào bộ đệm trước khi mục trước mục đó trong hàng đợi phát xong. Việc đặt thuộc tính tự động phát của mục thành true sẽ cho phép receiver tự động phát mục đó. 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:

Kotlin
val queueItem: MediaQueueItem = MediaQueueItem.Builder(mediaInfo)
    .setAutoplay(true)
    .setPreloadTime(20.0)
    .build()
Java
MediaQueueItem queueItem = new MediaQueueItem.Builder(mediaInfo)
  .setAutoplay(true)
  .setPreloadTime(20)
  .build();

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

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

Khi tải một mục hàng đợi nội dung đa phương tiện, receiver sẽ chỉ định một mã nhận dạng duy nhất cho mục đó duy trì trong suốt thời gian của phiên (và vòng đời của hàng đợi). Ứng dụng của bạn có thể tìm hiểu trạng thái của hàng đợi liên quan đến mục nào đang được tải (có thể không phát), đang tải hoặc đã tải trước. Lớp MediaStatus cung cấp thông tin về trạng thái sau:

  • Phương thức getPreloadedItemId() – Nếu mục tiếp theo đã được tải trước, sẽ trả về mã mục được tải trước.
  • Phương thức getLoadingItemId() – Trả về mã mục của mục hiện đang tải (nhưng không hoạt động trong hàng đợi) trên receiver.
  • Phương thức getCurrentItemId() – Trả về mã mục của mục đang hoạt động trong hàng đợi (có thể không phát) tại thời điểm thay đổi trạng thái của nội dung nghe nhìn.
  • getQueueItems() (Không dùng nữa, hãy sử dụng MediaQueue để thay thế) – Trả về danh sách thực thể MediaQueueItem dưới dạng danh sách không thể sửa đổi.

Ứng dụng của bạn cũng có thể lấy danh sách các mục bằng cách sử dụng lớp MediaQueue. Lớp này là một mô hình dữ liệu thưa thớt của hàng đợi nội dung đa phương tiện. Thao tác này sẽ lưu danh sách mã mục trong hàng đợi và danh sách này sẽ được tự động đồng bộ hoá với receiver. MediaQueue không giữ lại tất cả MediaQueueItem vì sẽ chiếm quá nhiều bộ nhớ khi hàng đợi rất dài. Thay vào đó, lớp này sẽ tìm nạp các mục theo yêu cầu và giữ lại LruCache của các mục đã truy cập gần đây. Bạn có thể sử dụng các phương thức sau để truy cập vào hàng đợi nội dung nghe nhìn:

  • Phương thức getItemIds() – Trả về danh sách tất cả mã mặt hàng theo thứ tự.
  • Phương thức getItemAtIndex() – Trả về mục được lưu vào bộ nhớ đệm tại một chỉ mục nhất định. Nếu mục không được lưu vào bộ nhớ đệm, MediaQueue sẽ trả về null và lên lịch tìm nạp mục đó. Khi mục được tìm nạp, MediaQueue.Callback#itemsUpdatedAtIndexes() sẽ được gọi và việc gọi getItemAtIndex() với cùng một mã nhận dạng một lần nữa sẽ trả về mục đó.
  • fetchMoteItemsRelativeToIndex() được dùng khi người dùng cuộn giao diện người dùng hàng đợi lên trên cùng hoặc dưới cùng và ứng dụng của bạn muốn tìm nạp thêm mục trên đám mây.

Hãy sử dụng các phương thức này cùng với các phương thức trạng thái nội dung đa phương tiện khác để thông báo cho ứng dụng về trạng thái của hàng đợi và các mục trong hàng đợi. Ngoài việc cập nhật trạng thái của nội dung nghe nhìn từ receiver, ứng dụng của bạn có thể theo dõi các thay đổi đối với hàng đợi bằng cách triển khai RemoteMediaClient.Callback và MediaQueue.Callback.

Ngoài ra, Cast SDK cung cấp 2 lớp tiện ích để tạo giao diện người dùng cho hàng đợi.

Ví dụ: để tạo RecyclerView bằng MediaQueueRecyclerViewAdapter:

Kotlin
class MyRecyclerViewAdapter(mediaQueue: MediaQueue?) :
    MediaQueueRecyclerViewAdapter<MyViewHolder?>(mediaQueue) {
    override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
        val item = getItem(position)

        // Update the view using `item`.
        ...
    }
}

class MyViewHolder : RecyclerView.ViewHolder {
    // Implement your own ViewHolder.
    ...
}

fun someMethod() {
    val adapter = MyRecyclerViewAdapter(
        mCastSession.remoteMediaClient.getMediaQueue())
    val recyclerView =
        activity.findViewById(R.id.my_recycler_view_id) as RecyclerView
    recyclerView.adapter = adapter
}
Java
public class MyRecyclerViewAdapter extends MediaQueueRecyclerViewAdapter<MyViewHolder> {
    public MyRecyclerViewAdapter(MediaQueue mediaQueue) {
        super(mediaQueue);
    }

    @Override
    public void onBindViewHolder(MyViewHolder holder, int position) {
      MediaQueueItem item = getItem(position);

      // Update the view using `item`.
      ...
    }
}

public class MyViewHolder implements RecyclerView.ViewHolder {
  // Implement your own ViewHolder.
  ...
}

public void someMethod() {
    RecyclerView.Adapter adapter = new MyRecyclerViewAdapter(
        mCastSession.getRemoteMediaClient().getMediaQueue());
    RecyclerView recyclerView =
        (RecyclerView) getActivity().findViewById(R.id.my_recycler_view_id);
    recyclerView.setAdapter(adapter);
}

Chỉnh sửa hàng đợi

Để thao tác trên các mục trong hàng đợi, hãy sử dụng các phương thức hàng đợi của lớp RemoteMediaClient. Các thao tác 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, khiến một mục nhảy tiến hoặc lùi trong hàng đợi, thiết lập các thuộc tính của hàng đợi đó (ví dụ: thay đổi thuật toán repeatMode cho 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.

Trước
Bản nhạc đa phương tiện
Tiếp
Ý định tham gia