Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Danh sách chờ

Khung truyền cung cấp các lớp hàng đợi hỗ trợ việc tạo danh sách các thực thể MediaQueueItem. Các thực thể này có thể được tạo 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. hàng đợi các mục nội dung này.

SDK của thiết bị thu 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 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. Bộ thu 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 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 bộ thu. 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. Sau 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 nghe nhì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 hàng đợi nội dung nghe nhìn, nếu đang sử dụng Thư viện trình phát nội dung nghe nhì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 vùng đệm mục hàng đợi nội dung nghe nhìn trước khi mục phía 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 phát 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 nghe nhìn vào 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 hàng đợi nội dung nghe nhìn

Khi tải một mục trong hàng đợi nội dung nghe nhìn, thiết bị thu sẽ chỉ định một mã nhận dạng duy nhất cho mục đó. Mã này sẽ tồn tại trong suốt thời gian của phiên (và thời gian hoạt động 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 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 về trạng thái sau:

Phương thức getPreloadedItemId() – Nếu mục tiếp theo đã được tải trước, thì phương thức này sẽ trả về mã mặt hàng được tải trước.
Phương thức getLoadingItemId() – Trả về mã mặt hàng của mục hiện đang tải (nhưng không hoạt động trong hàng đợi) trên thiết bị thu.
Phương thức getCurrentItemId() – Trả về mã mặt hàng của mặt hàng đ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. Hàng đợi này lưu giữ danh sách mã mặt hàng trong hàng đợi và tự động đồng bộ hoá với thiết bị nhận. MediaQueue không giữ tất cả MediaQueueItem vì sẽ tốn 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 một LruCache của các mục đượ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 của 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 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ừ thiết bị thu, ứ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, SDK truyền cung cấp hai lớp tiện ích để tạo giao diện người dùng cho việc thêm vào hàng đợi.

MediaQueueRecyclerViewAdapter, đã hỗ trợ dữ liệu của RecyclerView
MediaQueueListAdapter, đã hỗ trợ 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 lên trước hoặc lùi lại 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