Loại: queueLoadRequestData

Hàm dựng

QueueLoadRequestData

mới hàng hàngLoadRequestData(items)

Thông số

items

Mảng cast.framework.messages.QueueItem không có giá trị null

Danh sách các mục trong hàng đợi. Trường itemId của các mặt hàng phải để trống, nếu không yêu cầu sẽ không thành công kèm theo lỗi INVALID_PARAMS. Thẻ này được sắp xếp (phần tử đầu tiên sẽ được phát trước).

Giá trị không được rỗng.

Mở rộng
cast.framework.messages.RequestData

Thuộc tính

currentTime

(số hoặc không xác định)

Số giây (kể từ khi bắt đầu nội dung) để bắt đầu phát mục đầu tiên. Nếu được cung cấp, giá trị này sẽ được ưu tiên hơn giá trị startTime được cung cấp ở cấp ShowcaseItem nhưng chỉ trong lần đầu tiên phát mục đó. Nội dung này bao gồm trường hợp phổ biến khi người dùng truyền mục đang phát cục bộ nên currentTime không áp dụng vĩnh viễn cho mục như Hàng đợi startTime. Thao tác này giúp tránh phải đặt lại thời gian bắt đầu một cách linh động (điều này có thể không thực hiện được nếu điện thoại đã chuyển sang chế độ ngủ).

customData

(Đối tượng không rỗng hoặc không xác định)

Dữ liệu dành riêng cho ứng dụng của yêu cầu này. Phương thức này giúp người gửi và người nhận dễ dàng mở rộng giao thức truyền thông mà không phải sử dụng không gian tên mới với các thông báo tuỳ chỉnh.

Được kế thừa từ
cast.framework.messages.RequestData#customData

items

Mảng không có giá trị null cast.framework.messages.QueueItem không có giá trị null

Mảng gồm các mục trong hàng đợi. Thẻ này được sắp xếp (phần tử đầu tiên sẽ được phát trước).

mediaSessionId

(số hoặc không xác định)

Mã của phiên phát nội dung đa phương tiện mà yêu cầu áp dụng.

Được kế thừa từ
cast.framework.messages.RequestData#mediaSessionId

repeatMode

(cast.framework.messages.RepeatMode hoặc không xác định)

Hành vi của hàng đợi khi tất cả các mục đã được phát.

requestId

number

Mã của yêu cầu, dùng để liên kết yêu cầu/phản hồi.

Được kế thừa từ
cast.framework.messages.RequestData#requestId

sequenceNumber

(số hoặc không xác định)

Một số để đồng bộ hoá tất cả các lệnh trong hàng đợi. Nếu được cung cấp cho một lệnh trong hàng đợi, SDK sẽ xác minh số thứ tự mới nhất của hàng đợi khớp với yêu cầu. Hiện tạiseqNumber được cung cấp như một phần của các thông báo đã thay đổi trong hàng đợi gửi đi.

Được kế thừa từ
cast.framework.messages.RequestData#sequenceNumber

startIndex

(số hoặc không xác định)

Chỉ mục của mục trong mảng items phải là currentItem đầu tiên (mục sẽ được phát đầu tiên). Lưu ý rằng đây là chỉ mục của mảng (bắt đầu từ 0) chứ không phải là itemId (vì hệ thống sẽ không biết đến khi tạo hàng đợi). Nếu repeatMode là REPEAT_OFF, quá trình phát sẽ kết thúc khi phát mục cuối cùng trong mảng (các phần tử trước startIndex sẽ không được phát). Điều này có thể hữu ích cho các trường hợp tiếp tục mà trong đó người dùng đã sử dụng ứng dụng gửi và ở giữa quyết định truyền. Bằng cách này, ứng dụng của người gửi không cần phải ánh xạ giữa các vị trí trong hàng đợi cục bộ và từ xa hay lưu thêm một yêu cầu ợ_UPDATE.