Trang này được dịch bởi Cloud Translation API.

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 các thực thể MediaQueueItem. Bạn có thể tạo các thực thể này từ các thực thể MediaInfo như luồng video hoặc âm thanh để phát tuần tự trên thiết bị nhận. Bạn có thể chỉnh sửa, sắp xếp lại, cập nhật, v.v. cho hàng đợi các mục nội dung này.

SDK Receiver duy trì hàng đợi và phản hồi các thao tác trên 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 đang tạm dừng). Người gửi có thể tham gia phiên 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 trong hàng đợi cho đến khi mục cuối cùng hoàn tất quá trình phát hoặc trình gửi dừng phát và chấm dứt phiên hoặc cho đến khi trình gửi tải một hàng đợi mới trên trình nhận. Theo mặc định, trình 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 kết thúc, phiên phát nội dung nghe nhì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

Một mục trong hàng đợi nội dung đa phương tiện được biểu thị trong khung Cast dưới dạng một thực thể MediaQueueItem. Khi tạo một mục trong hàng đợi nội dung đa phương tiện, nếu đang sử dụng Thư viện trình phát nội dung đa phương tiện với 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 mục trong hàng đợi nội dung đa phương tiện vào bộ đệm trước khi mục trướ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 cho phép trình thu 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 nghe nhì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 đa phương tiện 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 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 nhận sẽ gán một mã nhận dạng duy nhất cho mục đó. Mã nhận dạng này sẽ tồn tại trong suốt phiên (và thời gian tồn tạ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 về mục nào hiện đang được tải (có thể không phát), đang tải hoặc được tải trước. Lớp MediaStatus cung cấp thông tin trạng thái này:

Phương thức getPreloadedItemId() – Nếu mục tiếp theo đã được tải trước, hãy trả về mã mục đã tải trước.
Phương thức getLoadingItemId() – Trả về mã mặt hàng của mặt hàng đang tải (nhưng không hoạt động trong hàng đợi) trên trình nhận.
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 nội dung nghe nhìn.
Phương thức getQueueItems() (Không dùng nữa, hãy sử dụng MediaQueue) – Trả về danh sách các 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 nghe nhìn. Lớp này lưu giữ danh sách mã nhận dạng mục trong hàng đợi, danh sách này được tự động đồng bộ hoá với trình nhận. MediaQueue không giữ lại tất cả MediaQueueItem vì sẽ tốn quá nhiều bộ nhớ khi hàng đợi quá dài. Thay vào đó, ứng dụng này sẽ tìm nạp các mục theo yêu cầu và lưu giữ 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 đã 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 lại getItemAtIndex() bằng cùng một mã nhận dạng 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 xuống dưới cùng và ứng dụng của bạn muốn tìm nạp thêm các mục từ đá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 nghe nhì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 thông tin cập nhật trạng thái nội dung đa phương tiện từ trình nhận, ứ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 hai lớp tiện ích để tạo giao diện người dùng cho việc xếp hàng.

MediaQueueRecyclerViewAdapter, để sao lưu dữ liệu của RecyclerView
MediaQueueListAdapter, để sao lưu dữ liệu của ListAdapter.

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 phương thứ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, chuyển một mục sang trước hoặc sang sau trong hàng đợi, đặt thuộc tính của chính hàng đợi (ví dụ: thay đổi thuật toán 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.

Bản nhạc đa phương tiện

Tiếp

Ý định tham gia