cast. framework. PlayerManager
Điều khiển và giám sát việc phát nội dung nghe nhìn.
- Gửi
-
non-null Error
Nếu hàm khởi tạo được sử dụng trực tiếp. Bạn chỉ nên truy cậpPlayerManager
bằng cách gọi cast.framework.CastReceiverContext#getPlayerManager.
Phương thức
addEventListener
addEventListener(eventType, eventListener)
Thêm trình nghe sự kiện có chức năng theo dõi các sự kiện phát.
Thông số |
|
---|---|
eventType |
(cast.framework.events.EventType không có giá trị null hoặc mảng không có giá trị null cast.framework.events.EventType) không có giá trị null) Một loại sự kiện hoặc mảng các loại sự kiện |
eventListener |
function(non-null cast.framework.events.Event) |
- Gửi
-
non-null Error
Nếu các đối số đã cho không hợp lệ.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Thêm các lệnh mới được hỗ trợ vào danh sách hiện có các lệnh dành cho nội dung đa phương tiện được hỗ trợ.
Thông số |
|
---|---|
supportedMediaCommands |
number Một mặt nạ bit của các lệnh đa phương tiện mà ứng dụng hỗ trợ. |
broadcastStatus |
Không bắt buộc boolean
|
- Xem thêm
- cast.framework.messages.Command
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Gửi thông báo trạng thái nội dung nghe nhìn cho tất cả người gửi (phát đi). Các ứng dụng dùng thông tin này để gửi nội dung thay đổi trạng thái tuỳ chỉnh.
Thông số |
|
---|---|
includeMedia |
Không bắt buộc boolean
|
requestId |
Không bắt buộc number Mã của yêu cầu đến đã gây ra phản hồi này. |
customData |
Không bắt buộc Đối tượng Dữ liệu tuỳ chỉnh dành riêng cho ứng dụng của thông báo trạng thái. Giá trị có thể rỗng. |
includeQueueItems |
Không bắt buộc boolean Liệu có đưa các mục trong hàng đợi vào thông báo trạng thái hay không. Theo mặc định, các thuộc tính này không được đưa vào. |
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) trả về số
Chuyển đổi thời gian nội dung đa phương tiện thành thời gian tuyệt đối của nội dung đa phương tiện. Thời gian tuyệt đối chỉ áp dụng cho sự kiện phát trực tiếp.
Thông số |
|
---|---|
mediaTime |
number Thời gian phát nội dung đa phương tiện. |
- Trả bóng
-
nullable number
Thời gian tuyệt đối hoặcnull
nếu không có.
getAudioTracksManager
getAudioTracksManager() trả về cast.framework.AudioTracksManager
Lấy thực thể AudioTracksManager
.
- Trả bóng
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() trả về số
Trả về thời gian hiện tại của đoạn ngắt hiện đang phát, tính bằng giây.
- Trả bóng
-
nullable number
Thời gian hiện tại tính bằng giây bên trong đoạn video của điểm chèn hiện tại.null
khiPlayer
không phát đoạn ngắt.
getBreakClipDurationSec
getBreakClipDurationSec() trả về số
Trả về thời lượng của đoạn cắt hiện đang phát tính bằng giây.
- Trả bóng
-
nullable number
Thời lượng của đoạn cắt hiện tại.null
khiPlayer
không phát đoạn ngắt.
getBreakManager
getBreakManager() trả về cast.framework.breaks.BreakManager
Lấy thực thể BreakManager
.
- Trả bóng
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() trả về Array gồm cast.framework.messages.Break không có giá trị null
Trả về danh sách các điểm chèn quảng cáo.
- Trả bóng
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() trả về số
Nhận lệnh truyền nội dung đa phương tiện được hỗ trợ bộ thu hiện tại.
Không giống như getSupportedMediaCommands()
, giá trị trả về của phương thức này thay đổi linh hoạt dựa trên trạng thái phát hiện tại. Ví dụ:
trong khi phát quảng cáo, lệnh SEEK
có thể không được hỗ trợ.
Phương thức này chỉ được gọi sau khi gọi phương thức nhận CastReceiverContext#start
, nếu không, phương thức này sẽ trả về 0
.
- Xem thêm
- cast.framework.messages.Command
- Trả bóng
-
number
Mặt nạ bit của các lệnh đa phương tiện mà ứng dụng hỗ trợ.
getCurrentTimeSec
getCurrentTimeSec() trả về số
Nhận thời gian phát đã trôi qua của nội dung nghe nhìn hiện tại.
- Trả bóng
-
number
Thời gian đã trôi qua, tính bằng giây. Giá trị này sẽ là0
nếu không có nội dung nghe nhìn nào đang phát.
getDurationSec
getDurationSec() trả về số
Xem thời lượng của nội dung nghe nhìn đang phát, tính bằng giây.
- Trả bóng
-
number
Thời lượng của nội dung nghe nhìn.NaN
nếu không có nội dung nghe nhìn nào đang phát.
getLiveSeekableRange
getLiveSeekableRange() trả về cast.framework.messages.LiveSeekableRange
Trả về phạm vi có thể tìm kiếm trực tiếp với thời gian bắt đầu và thời gian kết thúc tính bằng giây. Các giá trị này dựa trên thời gian phát nội dung đa phương tiện.
- Trả bóng
getMediaInformation
getMediaInformation() trả về cast.framework.messages.MediaInformation
Nhận thông tin về nội dung đa phương tiện của nội dung hiện tại.
- Trả bóng
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(absoluteTime) trả về số
Chuyển đổi thời gian tuyệt đối của nội dung đa phương tiện thành thời gian phát nội dung đa phương tiện. Thời gian tuyệt đối chỉ áp dụng cho sự kiện phát trực tiếp.
Thông số |
|
---|---|
absoluteTime |
number Thời gian tuyệt đối của nội dung nghe nhìn, dưới dạng thời gian UNIX Epoch (giây kể từ thời gian bắt đầu của hệ thống Unix). |
- Trả bóng
-
nullable number
Thời gian phát nội dung đa phương tiện hoặcnull
nếu không có.
getPlaybackConfig
getPlaybackConfig() trả về cast.framework.PlaybackConfig
Trả về cấu hình phát hoặc null
nếu giá trị mặc định chưa bị ghi đè.
- Trả bóng
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() trả về số
Trả về tốc độ phát hiện tại.
Trả về 1
trước khi trình nhận CastReceiverContext#start
được gọi.
- Trả bóng
-
number
Tốc độ phát hiện tại.
getPlayerState
getPlayerState() trả về cast.framework.messages.PlayerState
Nhận trạng thái Player
.
- Trả bóng
-
non-null cast.framework.messages.PlayerState
Trạng thái củaPlayer
hiện tại.
getPreferredPlaybackRate
get PreferredPlaybackRate() trả về số
Nhận tốc độ phát mong muốn. Có thể dùng khi sự kiện tắt để lưu tốc độ phát ưu tiên mới nhất vào bộ nhớ ổn định, để có thể dùng trong phiên tiếp theo trong các tuỳ chọn truyền.
- Trả bóng
-
number
getPreferredTextLanguage
getPreferenceTextLanguage() trả về chuỗi
Nhận ngôn ngữ đoạn văn bản ưu tiên.
- Trả bóng
-
nullable string
getPreferredTextStyle
getPreferencesTextStyle() trả về cast.framework.messages.TextTrackStyle
Lấy kiểu đoạn văn bản ưu tiên.
- Trả bóng
getQueueManager
getQueueManager() returns (cast.framework.QueueManager or undefined)
Lấy thực thể QueueManager
.
- Trả bóng
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() trả về số
Lấy thời gian phát đã trôi qua của nội dung nghe nhìn hiện tại mà không trừ thời gian chèn quảng cáo.
- Trả bóng
-
number
Thời gian đã trôi qua, tính bằng giây. Giá trị này sẽ là0
nếu không có nội dung nghe nhìn nào đang phát.
getStartAbsoluteTime
getStartAbsoluteTime() trả về số
Lấy thời gian bắt đầu tuyệt đối của nội dung đa phương tiện, dưới dạng thời gian UNIX Epoch (giây kể từ thời gian bắt đầu của hệ thống Unix). Thời gian tuyệt đối chỉ áp dụng cho sự kiện phát trực tiếp.
- Trả bóng
-
nullable number
getStats
getStats() returns cast.framework.stats.Stats
Trả về số liệu thống kê về việc phát video. Số liệu thống kê được tổng hợp trên toàn bộ phiên phát khi thích hợp.
- Trả bóng
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getSupportedMediaCommands() trả về số
Nhận lệnh truyền nội dung đa phương tiện được bộ nhận hỗ trợ. Chỉ nên gọi sau khi gọi CastReceiverContext#start()
. Nếu không, mã sẽ trả về 0
. Giá trị của lệnh truyền nội dung được hỗ trợ chỉ do ứng dụng nhận kiểm soát .
Mã này không được tự động cập nhật dựa trên MediaStatus
.
- Xem thêm
- cast.framework.messages.Command
- Trả bóng
-
number
Mặt nạ bit của các lệnh đa phương tiện mà ứng dụng hỗ trợ.
getTextTracksManager
getTextTracksManager() trả về cast.framework.TextTracksManager
Lấy thực thể TextTracksManager
.
- Trả bóng
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() trả về Mảng cast.framework.TimedMetadata không có giá trị null
Trả về siêu dữ liệu có thời gian gặp phải trong quá trình phân tích cú pháp tệp kê khai. Đây là #EXT-X-DATERANGE
trong HLS và EventStream
trong DASH.
- Trả bóng
-
non-null Array of non-null cast.framework.TimedMetadata
trọng tải
load(loadRequest) trả về Promise chứa void
Bắt đầu một yêu cầu tải nội dung nghe nhìn.
Thông số |
|
---|---|
loadRequest |
cast.framework.messages.LoadRequestData Yêu cầu tải nội dung nghe nhìn. Giá trị không được rỗng. |
- Trả bóng
-
non-null Promise containing void
Hứa hẹn được giải quyết khi thao tác thành công hoặc bị từ chối nếu không thực hiện được.
tạm dừng
tạm dừng()
Tạm dừng nội dung nghe nhìn đang phát.
phát
phát()
Phát nội dung nghe nhìn hiện đang tạm dừng.
removeEventListener
removeEventListener(eventType, eventListener)
Xoá trình nghe sự kiện đã thêm cho một sự kiện phát cụ thể. Nếu không có trình nghe sự kiện trùng khớp nào, lệnh gọi này sẽ bị bỏ qua.
Thông số |
|
---|---|
eventType |
(cast.framework.events.EventType không có giá trị null hoặc mảng không có giá trị null cast.framework.events.EventType) không có giá trị null) Một eventType hoặc mảng các loại sự kiện |
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Xoá lệnh khỏi danh sách các lệnh chứa nội dung nghe nhìn được hỗ trợ.
Thông số |
|
---|---|
supportedMediaCommands |
number Một mặt nạ bit của các lệnh đa phương tiện mà ứng dụng hỗ trợ. |
broadcastStatus |
Không bắt buộc boolean
|
- Xem thêm
- cast.framework.messages.Command
seek
tìm kiếm(thời gian tìm kiếm)
Tìm kiếm trong nội dung nghe nhìn hiện tại.
Thông số |
|
---|---|
seekTime |
number |
sendCustomState
sendCustomState(state)
Gửi trạng thái tuỳ chỉnh từ logic phát ứng dụng đến logic giao diện người dùng.
Phương thức này giúp phân tách logic phát và giao diện người dùng.
Việc duy trì sự tách biệt giữa logic và giao diện người dùng sẽ cho phép người dùng sử dụng cùng một logic giao diện người dùng cho cả chế độ phát cục bộ và điều khiển từ xa.
Trạng thái tuỳ chỉnh do phương thức này gửi có sẵn cho giao diện người dùng thông qua PlayerData
.
Thông số |
|
---|---|
state |
Đối tượng Đối tượng trạng thái tuỳ chỉnh. Giá trị không được rỗng. |
sendError
sendError(senderId, requestId, type, reason, customData)
Gửi lỗi cho một người gửi cụ thể.
Thông số |
|
---|---|
senderId |
string Mã người gửi. |
requestId |
number Mã của yêu cầu đến đã gây ra lỗi này. |
loại |
cast.framework.messages.ErrorType Loại lỗi. Giá trị không được rỗng. |
lý do |
Không bắt buộc cast.framework.messages.ErrorReason Lý do lỗi. Giá trị có thể rỗng. |
customData |
Không bắt buộc Đối tượng Thông báo lỗi về dữ liệu tuỳ chỉnh dành riêng cho ứng dụng. Giá trị có thể rỗng. |
sendLocalMediaRequest
sendLocalMediaRequest(request)
Gửi một yêu cầu về nội dung nghe nhìn cục bộ.
Thông số |
|
---|---|
request |
cast.framework.messages.RequestData Giá trị không được rỗng. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Gửi thông báo trạng thái nội dung nghe nhìn cho một người gửi cụ thể.
Thông số |
|
---|---|
senderId |
string Mã người gửi. |
requestId |
number Mã của yêu cầu đến đã gây ra phản hồi này. |
includeMedia |
Không bắt buộc boolean
|
customData |
Không bắt buộc Đối tượng Dữ liệu tuỳ chỉnh dành riêng cho ứng dụng của thông báo trạng thái. Giá trị có thể rỗng. |
includeQueueItems |
Không bắt buộc boolean Liệu có đưa các mục trong hàng đợi vào thông báo trạng thái hay không. Theo mặc định, các thuộc tính này không được đưa vào. |
setIdleReason
setIdleReason(idleReason)
Đặt lý do khiến người chơi ở trạng thái IDLE
.
Điều này cho phép các ứng dụng muốn buộc trạng thái IDLE
cho biết lý do (ví dụ: lỗi tuỳ chỉnh).
Lý do không hoạt động sẽ được gửi trong thông báo trạng thái tiếp theo.
Lưu ý Hầu hết các ứng dụng không cần đặt giá trị này. Điều này chỉ cần thiết nếu ứng dụng cần chuyển Player
chuyển sang trạng thái IDLE
trong các trường hợp đặc biệt và navigationReason mặc định không phản ánh hành vi dự định.
Thông số |
|
---|---|
idleReason |
cast.framework.messages.IdleReason Lý do nên ở trạng thái Giá trị không được rỗng. |
setMediaElement
setMediaElement(mediaElement)
Thiết lập HTMLMediaElement
để sử dụng. Nếu bạn đặt Promise
của HTMLMediaElement
, thì nội dung nghe nhìn sẽ bắt đầu phát sau khi Promise
được phân giải.
Thông số |
|
---|---|
mediaElement |
(HTMLMediaElement không có giá trị null hoặc Promise không rỗng chứa HTMLMediaElement không có giá trị))
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Thiết lập thông tin về nội dung đa phương tiện.
Thông số |
|
---|---|
mediaInformation |
cast.framework.messages.MediaInformation Giá trị không được rỗng. |
opt_broadcast |
Không bắt buộc boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Thiết lập trình xử lý để trả về hoặc sửa đổi cast.framework.PlaybackConfig cho một yêu cầu tải cụ thể. Các tham số của trình xử lý là LoadRequestData
và PlaybackConfig
mặc định cho trình thu nhận (được cung cấp trong CastReceiverOptions
). Trình xử lý phải trả về cấu hình phát đã sửa đổi hoặc null
để ngăn nội dung nghe nhìn phát. Giá trị trả về cũng có thể là Promise
để cho phép chờ dữ liệu từ máy chủ.
Thông số |
|
---|---|
trình xử lý |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) Một hàm cung cấp cấu hình phát dành riêng cho một yêu cầu. Giá trị có thể rỗng. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Thiết lập một trình xử lý để trả về URL nội dung đa phương tiện cho yêu cầu LOAD
.
Bạn có thể dùng trình xử lý này để tránh xuất bản URL nội dung đa phương tiện trong trạng thái nội dung đa phương tiện. Theo mặc định, nội dung nghe nhìn contentId
sẽ được dùng làm URL nội dung.
Thông số |
|
---|---|
trình phân giải |
function(non-null cast.framework.messages.LoadRequestData) Hàm để phân giải URL nội dung đa phương tiện. Giá trị có thể rỗng. |
setMessageInterceptor
setMessageInterceptor(type, interceptor)
Thiết lập chế độ chặn tin nhắn đến và đi.
Trình chặn có thể cập nhật dữ liệu yêu cầu và trả về dữ liệu cập nhật, Promise
với dữ liệu đã cập nhật (nếu không thể trả về dữ liệu ngay lập tức) hoặc null
nếu không nên xử lý yêu cầu.
Lưu ý: nếu trình chặn thông điệp LOAD
được cung cấp nhưng không có trình chặn PRELOAD
riêng biệt nào được cung cấp, thì trình chặn LOAD
sẽ được gọi cho các thông điệp PRELOAD
.
Thông số |
|
---|---|
loại |
cast.framework.messages.MessageType Giá trị không được rỗng. |
máy bay đánh chặn |
function(non-null cast.framework.messages.RequestData) Giá trị có thể rỗng. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Thiết lập cấu hình phát trên PlayerManager
.
Thông số |
|
---|---|
playbackConfig |
Giá trị không được rỗng. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Đặt các lệnh nội dung đa phương tiện mà bộ nhận hỗ trợ.
Thông số |
|
---|---|
supportedMediaCommands |
number Một mặt nạ bit của các lệnh đa phương tiện mà ứng dụng hỗ trợ. |
broadcastStatus |
Không bắt buộc boolean
|
- Xem thêm
- cast.framework.messages.Command
điểm dừng
dừng()
Dừng nội dung nghe nhìn đang phát.