chrome. truyền. nội dung nghe nhìn. Nội dung đa phương tiện
Đại diện cho một mục nội dung đa phương tiện đã được tải vào ứng dụng của trình nhận.
Hàm dựng
Nội dung nghe nhìn
mới Media(sessionId, mediaSessionId)
Thông số |
|
---|---|
sessionId |
string Giá trị nhận dạng phiên. |
mediaSessionId |
number Giá trị nhận dạng nội dung đa phương tiện. |
Thuộc tính
activeTrackIds
mảng số có tính chất rỗng
Danh sách mã nhận dạng tương ứng với các Tuyến đường đang hoạt động.
breakStatus
(chrome.cast.media.BreakStatus không có giá trị null hoặc không xác định)
Trạng thái của một điểm nghỉ khi đang phát một điểm nghỉ trên bộ thu. Trường này sẽ được xác định khi receiver đang phát một giờ nghỉ, trống khi một điểm chèn không phát, nhưng vẫn có trong nội dung và không xác định được nếu nội dung không chứa điểm chèn quảng cáo.
currentItemId
số rỗng
Mã mục của mục đang hoạt động trong hàng đợi (có thể không phát được) tại thời điểm thay đổi trạng thái nội dung đa phương tiện.
currentTime
number
Vị trí phát hiện tại tính bằng giây kể từ khi bắt đầu nội dung đa phương tiện.
Thành phần này chỉ được cập nhật không thường xuyên, nên giá trị của thành phần này thường lỗi thời. Sử dụng phương thức getEstimatedTime
để nhận thông tin ước tính về vị trí phát thực tế dựa trên thông tin mới nhất mà trình nhận báo cáo.
- Không được dùng nữa
- Thay vào đó, hãy sử dụng getEstimatedTime.
customData
Đối tượng rỗng
Dữ liệu tuỳ chỉnh do ứng dụng nhận tập hợp.
idleReason
chrome.cast.media.IdleReason rỗng
Lý do không hoạt động nếu người nhận biết.
items
Mảng có tính chất rỗng của chrome.cast.media.QueueItem không rỗng
Mảng các mục được sắp xếp trong hàng đợi.
liveSeekableRange
(chrome.cast.media.LiveSeekableRange không có giá trị null hoặc không xác định)
Phạm vi có thể tìm kiếm của luồng trực tiếp hoặc sự kiện. Chế độ này sử dụng thời gian phát nội dung đa phương tiện tương đối tính bằng giây. Hệ thống sẽ không xác định thông tin này đối với các sự kiện phát trực tiếp VOD.
loadingItemId
số rỗng
Mã mặt hàng của mặt hàng hiện đang tải trên trình nhận. Rỗng nếu không có mục nào đang tải.
truyền-thông
chrome.cast.media.MediaInfo có thể nhận giá trị rỗng
Nội dung mô tả về nội dung nghe nhìn.
mediaSessionId
number
Xác định mục nội dung nghe nhìn.
playbackRate
number
Tốc độ phát. 1.0 thể hiện việc phát bình thường.
playerState
non-null chrome.cast.media.PlayerState
Trạng thái của người chơi.
preloadedItemId
số rỗng
Mã nhận dạng của Mục tiếp theo, chỉ có sẵn nếu đã được tải trước. Trên các mục nội dung nghe nhìn của trình thu nhận, bạn có thể tải trước và lưu tạm thời vào bộ nhớ đệm tạm thời trong bộ nhớ đệm, nhờ vậy, khi các mục này được tải sau này thì quá trình này sẽ nhanh hơn (vì nội dung nghe nhìn không phải được tìm nạp từ mạng).
queueData
(chrome.cast.media.QueueData không có giá trị null hoặc không xác định)
Dữ liệu về hàng đợi.
repeatMode
non-null chrome.cast.media.RepeatMode
Chế độ lặp lại để phát danh sách chờ.
sessionId
string
Xác định phiên đang lưu trữ nội dung nghe nhìn.
supportedMediaCommands
non-null Array of non-null chrome.cast.media.MediaCommand
Các lệnh phát nội dung đa phương tiện được trình phát nội dung đa phương tiện hỗ trợ.
videoInfo
(chrome.cast.media.VideoInformation không có giá trị null hoặc không xác định)
Thông tin về video.
thể tích
chrome.cast.Volume không có giá trị null
Âm lượng luồng nội dung nghe nhìn. Volume.level và Volume.muted sẽ luôn được đặt.
Phương thức
addUpdateListener
addUpdateListener(listener)
Thêm trình nghe được gọi khi trạng thái của nội dung nghe nhìn đã thay đổi. Các thay đổi đối với các thuộc tính sau sẽ kích hoạt trình nghe: currentTime, âm lượng, siêu dữ liệu, playbackRate, PlayerState, customData. Một lệnh gọi thành công đến phương thức getStatus của nội dung đa phương tiện cũng sẽ kích hoạt trình nghe.
Thông số |
|
---|---|
trình nghe |
function(boolean) Trình nghe để thêm. Tham số cho biết liệu đối tượng Media (Nội dung nghe nhìn) có còn hoạt động hay không. |
editTracksInfo
editTracksInfo(editTracksInfoRequest, successCallback, errorCallback)
Sửa đổi kiểu bản nhạc hoặc thay đổi trạng thái bản nhạc. Nếu mã theo dõi không khớp với mã theo dõi hiện có, thì toàn bộ yêu cầu sẽ không thành công và trạng thái sẽ không thay đổi.
Thông số |
|
---|---|
editTracksInfoRequest |
chrome.cast.media.EditTracksInfoRequest Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
getEstimatedBreakClipTime
getEstimatedBreakClipTime() returns (number or undefined)
Ước tính vị trí của đoạn ngắt hiện tại dựa trên thông tin gần đây nhất mà trình nhận báo cáo.
- Trả bóng
-
(number or undefined)
Ước tính vị trí của đoạn cắt điểm hiện tại, tính bằng giây kể từ khi nội dung đa phương tiện bắt đầu phát. Giá trị trả về sẽ không xác định nếu breakStatus hoặc currentBreakClipTime không được xác định khi một điểm chèn không được phát.
getEstimatedBreakTime
getEstimatedBreakTime() returns (number or undefined)
Ước tính vị trí ngắt hiện tại dựa trên thông tin gần đây nhất mà trình nhận báo cáo.
- Trả bóng
-
(number or undefined)
Ước tính vị trí chèn quảng cáo hiện tại (tính bằng giây) kể từ khi nội dung đa phương tiện bắt đầu phát. Giá trị trả về sẽ không xác định nếu bạn không xác định breakStatus hoặc currentBreakTime (khi một điểm chèn không phát).
getEstimatedLiveSeekableRange
getEstimatedLiveSeekableRange() returns (chrome.cast.media.LiveSeekableRange or undefined)
Ước tính thời gian bắt đầu LiveSeekableRange tính bằng giây dựa trên thông tin gần đây nhất mà trình thu nhận báo cáo.
- Trả bóng
-
(non-null chrome.cast.media.LiveSeekableRange or undefined)
Thông tin ước tính về LiveSeekableRange hiện tại. Giá trị trả về sẽ không xác định nếu LiveSeekableRange, LiveSeekableRange.start hoặc LiveSeekableRange.end không được xác định khi nội dung không xuất hiện trên YouTube.
getEstimatedTime
getEstimatedTime() trả về số
Ước tính vị trí phát hiện tại dựa trên thông tin gần đây nhất mà thiết bị nhận báo cáo.
- Trả bóng
-
number
Ước tính vị trí phát hiện tại tính bằng giây kể từ khi nội dung đa phương tiện bắt đầu phát.
getStatus
getStatus(getStatusRequest, successCallback, errorCallback)
Nhận trạng thái của mục nội dung nghe nhìn từ ứng dụng nhận.
Cùng với thành công đã cho, mọi trình nghe cập nhật nội dung đa phương tiện đã thêm cũng sẽ được gọi khi nhận được trạng thái từ ứng dụng của trình nhận. Thay vì gọi phương thức này để thăm dò trạng thái nội dung đa phương tiện, các ứng dụng nên ưu tiên dựa vào lệnh gọi tự động của trình nghe cập nhật nội dung đa phương tiện mỗi khi nội dung đa phương tiện thay đổi.
Thông số |
|
---|---|
getStatusRequest |
chrome.cast.media.GetStatusRequest Yêu cầu nhận trạng thái không bắt buộc. |
successCallback |
hàm() Được gọi khi nhận được trạng thái từ ứng dụng của trình nhận. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
tạm dừng
tạm dừng(pauseRequest, SuccessCallback, errorCallback)
Tạm dừng mục nội dung nghe nhìn.
Thông số |
|
---|---|
pauseRequest |
|
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Yêu cầu tạm dừng nội dung nghe nhìn. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_italicIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
phát
play(playRequest, SuccessCallback, errorCallback)
Phát mục nội dung đa phương tiện.
Thông số |
|
---|---|
playRequest |
Yêu cầu phát nội dung nghe nhìn không bắt buộc. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueAppendItem
queueAppendItem(item, successCallback, errorCallback)
Thêm một mục nội dung đa phương tiện mới vào cuối hàng đợi.
Thông số |
|
---|---|
mặt hàng |
Mục cần thêm vào cuối hàng đợi. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueInsertItems
queueInsertItems(queueInsertItemsRequest, successCallback, errorCallback)
Chèn danh sách các mục nội dung đa phương tiện mới vào hàng đợi.
Thông số |
|
---|---|
queueInsertItemsRequest |
chrome.cast.media.QueueInsertItemsRequest Yêu cầu chèn mục nội dung nghe nhìn vào hàng đợi nội dung nghe nhìn. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueJumpToItem
queueJumpToItem(itemId, successCallback, errorCallback)
Phát mục có itemId trong hàng đợi.
Nếu không tìm thấy itemId trong hàng đợi do ban đầu không có mã này hoặc đã bị một người gửi khác xoá trước khi gọi hàm này, thì hàm này sẽ tự động trả về mà không gửi yêu cầu đến trình nhận.
Thông số |
|
---|---|
itemId |
number Mã của mục cần chuyển đến. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueMoveItemToNewIndex
queueMoveItemToNewIndex(itemId, newIndex, successCallback, errorCallback)
Di chuyển mục có itemId vào vị trí newIndex trong hàng đợi.
Nếu không tìm thấy itemId trong hàng đợi do ban đầu không có mã này hoặc đã bị một người gửi khác xoá trước khi gọi hàm này, thì hàm này sẽ tự động trả về mà không gửi yêu cầu đến trình nhận.
errorCallback sẽ được gọi nếu newIndex là số âm. Tuy nhiên, nếu newIndex bị tràn do chỉ định sai hoặc hàng đợi đã bị một người gửi khác thu hẹp, thì mục sẽ được chuyển đến cuối hàng đợi.
Thông số |
|
---|---|
itemId |
number Mã của mục cần di chuyển. |
newIndex |
number Chỉ mục mới của mục. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueNext
queueNext(successCallback, errorCallback)
Chuyển đến mục tiếp theo trong hàng đợi.
Thông số |
|
---|---|
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queuePrev
queuePrev(successCallback, errorCallback)
Chuyển đến mục trước trong hàng đợi.
Thông số |
|
---|---|
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueRemoveItem
queueRemoveItem(itemId, successCallback, errorCallback)
Xoá mục có mã mặt hàng khỏi hàng đợi.
Nếu không tìm thấy itemId trong hàng đợi do ban đầu không có mã này hoặc đã bị một người gửi khác xoá trước khi gọi hàm này, thì hàm này sẽ tự động trả về mà không gửi yêu cầu đến trình nhận.
Thông số |
|
---|---|
itemId |
number Mã của mục cần xoá. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueReorderItems
queueReorderItems(queueReorderItemsRequest, successCallback, errorCallback)
Sắp xếp lại một danh sách các mục nội dung nghe nhìn trong hàng đợi.
Thông số |
|
---|---|
queueReorderItemsRequest |
chrome.cast.media.QueueReorderItemsRequest Yêu cầu sắp xếp lại các mục trong hàng đợi nội dung nghe nhìn. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueSetRepeatMode
queueSetRepeatMode(repeatMode, successCallback, errorCallback)
Đặt chế độ lặp lại của hàng đợi.
Thông số |
|
---|---|
repeatMode |
Thuật toán để chọn mục tiếp theo khi mục hiện tại đã kết thúc. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
queueUpdateItems
queueUpdateItems(queueUpdateItemsRequest, successCallback, errorCallback)
Cập nhật các thuộc tính của hàng đợi nội dung đa phương tiện, ví dụ: chế độ lặp lại và thuộc tính của các mục hiện có trong hàng đợi nội dung đa phương tiện.
Thông số |
|
---|---|
queueUpdateItemsRequest |
chrome.cast.media.QueueUpdateItemsRequest Yêu cầu cập nhật các thuộc tính của hàng đợi nội dung đa phương tiện. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
removeUpdateListener
removeUpdateListener(listener)
Xoá trình nghe đã thêm trước đó cho Nội dung nghe nhìn này.
Thông số |
|
---|---|
trình nghe |
function(boolean) Trình nghe cần xoá. |
seek
tìm kiếm(seekRequest, SuccessCallback, errorCallback)
Tìm mục nội dung đa phương tiện.
Thông số |
|
---|---|
seekRequest |
Yêu cầu tìm kiếm nội dung nghe nhìn. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
setVolume
setVolume(volumeRequest, successCallback, errorCallback)
Đặt âm lượng luồng đa phương tiện. Bạn phải đặt ít nhất một trong khối VolumeRequest.level hoặc VolumeRequest.muted. Việc thay đổi trạng thái tắt tiếng không ảnh hưởng đến mức âm lượng và ngược lại.
Thông số |
|
---|---|
volumeRequest |
chrome.cast.media.VolumeRequest Yêu cầu về âm lượng đã đặt. Giá trị không được rỗng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
điểm dừng
Stop(stopRequest, successCallback, errorCallback)
Dừng trình phát nội dung đa phương tiện.
Thông số |
|
---|---|
stopRequest |
Yêu cầu ngừng. |
successCallback |
hàm() Được gọi khi thành công. |
errorCallback |
function(non-null chrome.cast.Error) Được gọi do lỗi. Các lỗi có thể xảy ra là TIMEOUT, API_NOT_WITHINIZED, INVALID_METRIC, CHANNEL_ERROR, SESSION_ERROR và EXTENSION_DEFAULT. |
supportsCommand
SupportCommand(command) trả về boolean
Xác định xem trình phát nội dung đa phương tiện có hỗ trợ lệnh phát nội dung đa phương tiện đã cho hay không.
Thông số |
|
---|---|
Command |
chrome.cast.media.MediaCommand Lệnh để truy vấn. Giá trị không được rỗng. |
- Trả bóng
-
boolean
Đúng nếu trình phát hỗ trợ lệnh này.