Loại: PlayerManager

Phương thức

addEventListener

addEventListener(eventType, eventListener)

Thêm một trình nghe sự kiện để theo dõi các sự kiện phát.

Tham số

eventType

(cast.framework.events.EventType không rỗng hoặc mảng không rỗng gồm cast.framework.events.EventType không rỗng)

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ó gồm các lệnh được hỗ trợ cho nội dung nghe nhìn.

Tham số

supportedMediaCommands

số

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 cần được thông báo về thay đổi (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 sóng). Các ứng dụng dùng phương thức này để gửi một thay đổi tuỳ chỉnh về trạng thái.

Tham số

includeMedia

Không bắt buộc

boolean

true cho biết thông báo phải bao gồm thông tin về nội dung nghe nhìn.

requestId

Không bắt buộc

số

Mã nhận dạng 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ể là rỗng.

includeQueueItems

Không bắt buộc

boolean

Có bao gồm các mục trong hàng đợi trong thông báo trạng thái hay không. Theo mặc định, các lượt chuyển đổi này không được đưa vào.

getAbsoluteTimeForMediaTime

getAbsoluteTimeForMediaTime(mediaTime) trả về number

Chuyển đổi thời gian của nội dung nghe nhìn thành thời gian tuyệt đối của nội dung nghe nhìn. Thời gian tuyệt đối chỉ áp dụng cho sự kiện phát trực tiếp.

Tham số

mediaTime

số

Thời gian phát nội dung nghe nhìn.

Giá trị trả về

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.

Giá trị trả về

non-null cast.framework.AudioTracksManager 

getBreakClipCurrentTimeSec

getBreakClipCurrentTimeSec() trả về số

Trả về thời gian hiện tại của đoạn quảng cáo đang phát, tính bằng giây.

Giá trị trả về

nullable number Thời gian hiện tại tính bằng giây trong đoạn quảng cáo hiện tại. null khi Player không phát đoạn video chèn quảng cáo.

getBreakClipDurationSec

getBreakClipDurationSec() trả về số

Trả về thời lượng của đoạn quảng cáo xen giữa đang phát, tính bằng giây.

Giá trị trả về

nullable number Thời lượng của đoạn video quảng cáo hiện tại. null khi Player không phát đoạn video chèn.

getBreakManager

getBreakManager() trả về cast.framework.breaks.BreakManager

Lấy thực thể BreakManager.

Giá trị trả về

non-null cast.framework.breaks.BreakManager 

getBreaks

getBreaks() returns Array of non-null cast.framework.messages.Break

Trả về danh sách các điểm ngắt.

Giá trị trả về

non-null Array of non-null cast.framework.messages.Break 

getCurrentSupportedMediaCommands

getCurrentSupportedMediaCommands() trả về số

Lấy các lệnh hiện tại về nội dung nghe nhìn mà thiết bị nhận hỗ trợ. Không giống như getSupportedMediaCommands(), giá trị mà phương thức này trả về sẽ thay đổi linh hoạt dựa trên trạng thái phát hiện tại. Ví dụ: lệnh SEEK có thể không được hỗ trợ trong khi phát quảng cáo. Bạn chỉ nên gọi phương thức này sau khi gọi receiver CastReceiverContext#start, nếu không, phương thức này sẽ trả về 0.

Xem thêm
cast.framework.messages.Command
Giá trị trả về

number Một 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ố

Lấy thời gian phát đã trôi qua của nội dung nghe nhìn hiện tại.

Giá trị trả về

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ố

Lấy thời lượng của nội dung nghe nhìn đang phát, tính bằng giây.

Giá trị trả về

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ể tua 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 nghe nhìn.

Giá trị trả về

nullable cast.framework.messages.LiveSeekableRange 

getMediaInformation

getMediaInformation() trả về cast.framework.messages.MediaInformation

Lấy thông tin về nội dung nghe nhìn hiện tại.

Giá trị trả về

nullable cast.framework.messages.MediaInformation 

getMediaTimeForAbsoluteTime

getMediaTimeForAbsoluteTime(absoluteTime) trả về number

Chuyển đổi thời gian tuyệt đối của nội dung nghe nhìn thành thời gian của nội dung nghe nhìn. Thời gian tuyệt đối chỉ áp dụng cho sự kiện phát trực tiếp.

Tham số

absoluteTime

số

Thời gian tuyệt đối của nội dung nghe nhìn, tính theo thời gian bắt đầu của hệ thống UNIX (số giây kể từ thời gian bắt đầu của hệ thống Unix).

Giá trị trả về

nullable number Thời gian của nội dung nghe nhì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 các giá trị mặc định chưa bị ghi đè.

Giá trị trả về

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 gọi CastReceiverContext#start của receiver.

Giá trị trả về

number Tốc độ phát hiện tại.

getPlayerState

getPlayerState() trả về cast.framework.messages.PlayerState

Lấy trạng thái Player.

Giá trị trả về

non-null cast.framework.messages.PlayerState Trạng thái của Player hiện tại.

getPreferredPlaybackRate

getPreferredPlaybackRate() trả về số

Nhận tốc độ phát ưu tiên. Có thể dùng trong sự kiện tắt để lưu tốc độ phát ưu tiên mới nhất vào bộ nhớ liên tục, nhờ đó, tốc độ này có thể được dùng trong phiên tiếp theo trong các lựa chọn truyền.

Giá trị trả về

number 

getPreferredTextLanguage

getPreferredTextLanguage() trả về chuỗi

Lấy ngôn ngữ ưu tiên của phụ đề.

Giá trị trả về

nullable string 

getPreferredTextStyle

getPreferredTextStyle() trả về cast.framework.messages.TextTrackStyle

Lấy kiểu phụ đề ưu tiên.

Giá trị trả về

nullable cast.framework.messages.TextTrackStyle 

getQueueManager

getQueueManager() returns (cast.framework.QueueManager or undefined)

Lấy thực thể QueueManager.

Giá trị trả về

(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 điểm chèn quảng cáo.

Giá trị trả về

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.

getRawSeekableRange

getRawSeekableRange() trả về cast.framework.messages.Range

Trả về phạm vi có thể tua của nội dung nghe nhìn hiện tại.

LƯU Ý: Điều này khớp với các đơn vị của getRawCurrentTimeSec(), nhưng không khớp với seek()! Điều này không tính đến quảng cáo hoặc bất kỳ độ lệch nào khác của nội dung nghe nhìn. Trừ phi chắc chắn cần các giá trị thô, nếu không bạn nên sử dụng getLiveSeekableRange().

Giá trị trả về

nullable cast.framework.messages.Range 

getStartAbsoluteTime

getStartAbsoluteTime() trả về số

Lấy thời gian bắt đầu tuyệt đối của nội dung nghe nhìn, dưới dạng thời gian bắt đầu của hệ thống UNIX (số 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.

Giá trị trả về

nullable number 

getStats

getStats() trả về cast.framework.stats.Stats

Trả về số liệu thống kê về lượt phát. Số liệu thống kê được tổng hợp trong toàn bộ phiên phát (nếu có).

Giá trị trả về

non-null cast.framework.stats.Stats 

getSupportedMediaCommands

getSupportedMediaCommands() trả về số

Lấy các lệnh về nội dung nghe nhìn mà thiết bị nhận hỗ trợ. Chỉ được gọi sau khi gọi CastReceiverContext#start(), nếu không, phương thức này sẽ trả về 0. Giá trị lệnh nội dung nghe nhìn được hỗ trợ chỉ do ứng dụng nhận kiểm soát . Danh sách này không tự động cập nhật dựa trên MediaStatus.

Xem thêm
cast.framework.messages.Command
Giá trị trả về

number Một 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.

Giá trị trả về

non-null cast.framework.TextTracksManager 

getTimedMetadata

getTimedMetadata() trả về Mảng gồm các cast.framework.TimedMetadata không rỗng

Trả về siêu dữ liệu có dấu 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.

Giá trị trả về

non-null Array of non-null cast.framework.TimedMetadata 

trọng tải

load(loadRequest) trả về Promise chứa void

Bắt đầu yêu cầu tải nội dung nghe nhìn.

Tham 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.

Giá trị trả về

non-null Promise containing void Promise được phân giải khi thao tác thành công hoặc bị từ chối nếu không thành công.

tạm dừng

pause()

Tạm dừng nội dung nghe nhìn đang phát.

phát

play()

Phát nội dung nghe nhì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 nào phù hợp, thì lệnh gọi này sẽ bị bỏ qua.

Tham số

eventType

(cast.framework.events.EventType không rỗng hoặc mảng không rỗng gồm cast.framework.events.EventType không rỗng)

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á các lệnh khỏi danh sách lệnh điều khiển nội dung nghe nhìn được hỗ trợ.

Tham số

supportedMediaCommands

số

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 cần được thông báo về thay đổi (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

seek(seekTime)

Tìm kiếm trong nội dung nghe nhìn hiện tại.

Tham số

seekTime

số

sendCustomState

sendCustomState(state)

Gửi trạng thái tuỳ chỉnh từ logic phát của ứng dụng đến logic giao diện người dùng. Phương thức này giúp tách biệt 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 cho phép bạn 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. Giao diện người dùng có thể truy cập trạng thái tuỳ chỉnh do phương thức này gửi thông qua PlayerData.

Tham số

tiểu bang

Đố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ể.

Tham số

senderId

chuỗi

Mã nhận dạng người gửi.

requestId

số

Mã nhận dạng 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 xảy ra lỗi.

Giá trị có thể là rỗng.

customData

Không bắt buộc

Đối tượng

Thông báo lỗi dữ liệu tuỳ chỉnh dành riêng cho ứng dụng.

Giá trị có thể là rỗng.

sendLocalMediaRequest

sendLocalMediaRequest(request)

Gửi yêu cầu về nội dung nghe nhìn trên thiết bị.

Tham 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ể.

Tham số

senderId

chuỗi

Mã nhận dạng người gửi.

requestId

số

Mã nhận dạng 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ể là rỗng.

includeQueueItems

Không bắt buộc

boolean

Có bao gồm các mục trong hàng đợi trong thông báo trạng thái hay không. Theo mặc định, các lượt chuyển đổi này không được đưa vào.

setIdleReason

setIdleReason(idleReason)

Đặt lý do khiến trình phát ở 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 thực hiện việc này (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. Bạn chỉ cần dùng phương thức này nếu ứng dụng cần chuyển Player sang trạng thái IDLE trong các trường hợp đặc biệt và idleReason mặc định không phản ánh hành vi dự kiến.

Tham số

idleReason

cast.framework.messages.IdleReason

Lý do ở trạng thái IDLE.

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

setMediaElement

setMediaElement(mediaElement)

Đặt 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.

Tham số

mediaElement

(HTMLMediaElement không rỗng hoặc Promise không rỗng chứa HTMLMediaElement không rỗng)

MediaElementPlayer sẽ sử dụng.

setMediaInformation

setMediaInformation(mediaInformation, opt_broadcast)

Đặt thông tin về nội dung nghe nhìn.

Tham 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)

Đặt một 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à LoadRequestDataPlaybackConfig mặc định cho bộ nhận (được cung cấp trong CastReceiverOptions). Trình xử lý sẽ trả về một 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ủ.

Tham 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 cụ thể theo yêu cầu.

Giá trị có thể là rỗng.

setMediaUrlResolver

setMediaUrlResolver(resolver)

Đặt một trình xử lý để trả về URL của nội dung nghe nhìn cho yêu cầu LOAD. Bạn có thể dùng trình xử lý này để tránh việc URL nội dung nghe nhìn được xuất bản trong trạng thái nội dung nghe nhìn. Theo mặc định, contentId nội dung nghe nhìn được dùng làm URL nội dung.

Tham số

trình phân giải

function(non-null cast.framework.messages.LoadRequestData)

Một hàm để phân giải URL nội dung nghe nhìn.

Giá trị có thể là rỗng.

setMessageInterceptor

setMessageInterceptor(type, interceptor)

Đặt một trình chặn các thông báo đến và đi. Trình chặn có thể cập nhật dữ liệu yêu cầu và phải trả về dữ liệu đã cập nhật, Promise có 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 được xử lý yêu cầu. Lưu ý: nếu bạn cung cấp một trình chặn thông báo LOAD nhưng không cung cấp trình chặn PRELOAD riêng biệt, thì trình chặn LOAD sẽ được gọi cho các thông báo PRELOAD.

Tham số

loại

cast.framework.messages.MessageType

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

bộ chặn

function(non-null cast.framework.messages.RequestData)

Giá trị có thể là rỗng.

setPlaybackConfig

setPlaybackConfig(playbackConfig)

Đặt cấu hình phát trên PlayerManager.

Tham số

playbackConfig

cast.framework.PlaybackConfig

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

setSupportedMediaCommands

setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)

Đặt các lệnh về nội dung nghe nhìn mà bộ nhận hỗ trợ.

Tham số

supportedMediaCommands

số

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 cần được thông báo về thay đổi (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

stop()

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