Loại: PlayerManager

cast.framework.PlayerManager

lớp   tĩnh

Đ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ập PlayerManager 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 true cho biết người gửi sẽ được thông báo về sự thay đổi này (nếu không được cung cấp, người gửi sẽ được thông báo).

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 true cho biết thông báo phải chứa thông tin về nội dung nghe nhìn.
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ặc null 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 khi Player 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 khi Player 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

nullable cast.framework.messages.LiveSeekableRange 

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

nullable cast.framework.messages.MediaInformation 

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ặc null 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ủa Player 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

nullable cast.framework.messages.TextTrackStyle 

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 true cho biết người gửi sẽ được thông báo về sự thay đổi này (nếu không được cung cấp, người gửi sẽ được thông báo).

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.

Xem thêm

cast.framework.ui.PlayerData#customState

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 true cho biết thông báo phải bao gồm một thực thể MediaInformation.
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 IDLE. 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ị)) MediaElement mà Player sẽ sử dụng.

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	cast.framework.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 true cho biết người gửi sẽ được thông báo về sự thay đổi này (nếu không được cung cấp, người gửi sẽ được thông báo).

Xem thêm

cast.framework.messages.Command

điểm dừng

dừng()

Dừng nội dung nghe nhìn đang phát.