cast. framework. thông báo. QueueItem
Thông tin về mục trong hàng đợi. Nhà phát triển ứng dụng có thể cần tạo mộtQueueItem để chèn một phần tử hàng đợi bằng cách sử dụng Cast.framework.messages.InsertQueueItems. Trong trường hợp này, chúng không nên cung cấp itemId (vì itemId thực tế sẽ được gán khi mục được chèn vào hàng đợi). Điều này giúp tránh xung đột mã nhận dạng với các mục được thêm từ ứng dụng của người gửi.
Hàm dựng
QueueItem
mới Hàng đợi(opt_itemId)
Thông số |
|
---|---|
opt_itemId |
Không bắt buộc number Mã mặt hàng. |
Thuộc tính
activeTrackIds
(Mảng số có giá trị không rỗng hoặc không xác định)
Mảng mã theo dõi đang hoạt động. Nếu bạn không cung cấp mảng, các kênh mặc định sẽ hoạt động.
tự động phát
(Boolean hoặc không xác định)
Nếu tham số tự động phát không được chỉ định hoặc đúng, thì trình phát nội dung đa phương tiện sẽ bắt đầu phát phần tử trong hàng đợi khi mục đó trở thành currentItem.
customData
(Đối tượng rỗng hoặc không xác định)
Ứng dụng có thể xác định mọi thông tin cần thiết về mục trong hàng đợi bổ sung.
itemId
(số hoặc không xác định)
Giá trị nhận dạng duy nhất của mục trong hàng đợi. Thuộc tính này là không bắt buộc vì bạn không nên cung cấp TẢI hoặc CHÈN (vì thuộc tính này sẽ được trình thu chỉ định khi một mục được tạo/chèn lần đầu tiên).
truyền-thông
(cast.framework.messages.MediaInformation không có giá trị null hoặc không xác định)
Siêu dữ liệu (bao gồm cả contentId) của thành phần trong danh sách phát.
orderId
(số hoặc không xác định)
Dùng để theo dõi thứ tự ban đầu của một mục trong hàng đợi để huỷ trộn.
preloadTime
(số hoặc không xác định)
Tham số này là gợi ý để trình thu tải tải trước mục nội dung đa phương tiện này trước khi phát. Nhờ vậy, quá trình chuyển đổi giữa các mục được phát trong hàng đợi sẽ diễn ra suôn sẻ. Thời gian được biểu thị bằng giây, tương ứng với thời điểm bắt đầu phát mục này (thường là thời điểm kết thúc phát mục trước đó). Ví dụ: nếu giá trị là 10 giây, mục này sẽ được tải trước 10 giây trước khi mục trước kết thúc. Trình thu nhận sẽ cố gắng tuân thủ giá trị này nhưng không đảm bảo, chẳng hạn như nếu giá trị lớn hơn thời lượng mục trước đó, thì trình thu nhận có thể tải trước mục này ngay sau khi mục trước đó bắt đầu phát (sẽ không bao giờ có hai mục được tải trước song song). Ngoài ra, nếu một mục được chèn vào hàng đợi ngay sau currentItem và thời gian tải trước lâu hơn thời gian còn lại của currentItem, thì quá trình tải trước sẽ diễn ra sớm nhất có thể. Giá trị âm vô hiệu hoá rõ ràng tính năng tải trước. Nếu giá trị là 0 hoặc không xác định, mục nội dung đa phương tiện sẽ bắt đầu tải trước ngay khi mục trước được tải xuống hoàn toàn sau vị trí phát.
startTime
(số hoặc không xác định)
Số giây kể từ khi bắt đầu nội dung. Nếu nội dung là nội dung phát trực tiếp và bạn không chỉ định thời gian bắt đầu, thì sự kiện phát trực tiếp sẽ bắt đầu ở vị trí phát trực tiếp.