cast. platforma. PlayerManager
Steruje i monitoruje odtwarzanie multimediów.
- Rzuty
-
non-null Error
Jeśli konstruktor jest używany bezpośrednio. ObiektPlayerManager
powinien być dostępny tylko przez wywołanie cast.framework.CastReceiverContext#getPlayerManager.
Metody
addEventListener
addEventListener(eventType, eventListener)
Dodaje detektor zdarzeń, który nasłuchuje zdarzeń odtwarzania.
Parametr |
|
---|---|
eventType |
(nie null cast.framework.events.EventType lub nienull tablica cast.framework.events.EventType) Typ zdarzenia lub tablica typów zdarzeń |
eventListener |
function(non-null cast.framework.events.Event) |
- Rzuty
-
non-null Error
Jeśli podane argumenty są nieprawidłowe.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Dodaje nowe obsługiwane polecenia do istniejącej listy obsługiwanych poleceń multimedialnych.
Parametr |
|
---|---|
supportedMediaCommands |
Liczba Maska bitowa poleceń multimedialnych obsługiwanych przez aplikację. |
broadcastStatus |
Opcjonalnie boolean
|
- Zobacz też
- cast.framework.messages.Command
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Wysyła komunikat o stanie multimediów do wszystkich nadawców (transmisja). Aplikacje używają go do wysyłania niestandardowych zmian stanu.
Parametr |
|
---|---|
includeMedia |
Opcjonalnie boolean
|
requestId |
Opcjonalnie Liczba Identyfikator przychodzącego żądania, które spowodowało tę odpowiedź. |
customData |
Opcjonalnie Obiekt Niestandardowe dane aplikacji z komunikatem o stanie. Wartość może być null. |
includeQueueItems |
Opcjonalnie boolean Określa, czy w komunikacie o stanie mają być uwzględnione elementy kolejki. Domyślnie nie są one uwzględniane. |
getAbsoluteTimeForMediaTime
getOmniTimeForMediaTime(mediaTime) zwraca liczbę
Konwertuje czas korzystania z multimediów na bezwzględny czas korzystania z multimediów. Czas bezwzględny dotyczy tylko transmisji na żywo.
Parametr |
|
---|---|
mediaTime |
Liczba Czas korzystania z mediów. |
- Akcje powrotne
-
nullable number
Bezwzględny czas lubnull
, jeśli jest niedostępny.
getAudioTracksManager
getAudioTracksManager() zwraca metodę cast.framework.AudioTracksManager
Pobiera instancję AudioTracksManager
.
- Akcje powrotne
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() zwraca liczbę
Zwraca w sekundach bieżący czas aktualnie odtwarzanego klipu przerwy na reklamę.
- Akcje powrotne
-
nullable number
Obecny czas w sekundach w bieżącym klipie przerwy.null
, gdyPlayer
nie odtwarza klipu przerwy na reklamę.
getBreakClipDurationSec
getBreakClipDurationSec() zwraca liczbę
Zwraca czas trwania w sekundach aktualnie odtwarzanego klipu przerwy.
- Akcje powrotne
-
nullable number
Czas trwania bieżącego klipu przerwy.null
, gdyPlayer
nie odtwarza klipu przerwy na reklamę.
getBreakManager
getBreakManager() zwraca metodę cast.framework.breaks.BreakManager
Pobiera instancję BreakManager
.
- Akcje powrotne
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() zwraca tablicę nienull cast.framework.messages.Break
Zwraca listę przerw.
- Akcje powrotne
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() zwraca liczbę
Pobiera obsługiwane polecenia multimedialne w bieżącym odbiorniku.
W przeciwieństwie do metody getSupportedMediaCommands()
zwracana wartość tej metody zmienia się dynamicznie w zależności od bieżącego stanu odtwarzania. Na przykład podczas odtwarzania reklam polecenie SEEK
może nie być obsługiwane.
Ta metoda powinna zostać wywołana tylko po wywołaniu odbiornika CastReceiverContext#start
. W przeciwnym razie zwróci wartość 0
.
- Zobacz też
- cast.framework.messages.Command
- Akcje powrotne
-
number
Maska bitowa poleceń multimedialnych obsługiwanych przez aplikację.
getCurrentTimeSec
getCurrentTimeSec() zwraca liczbę
Pobiera czas odtwarzania bieżących multimediów.
- Akcje powrotne
-
number
Czas, który upłynął, w sekundach. Jeśli nie są odtwarzane żadne multimedia, wartość to0
.
getDurationSec
getDurationSec() zwraca liczbę
Pobiera czas trwania aktualnie odtwarzanych multimediów (w sekundach).
- Akcje powrotne
-
number
Czas trwania multimediów.NaN
, jeśli nic nie jest odtwarzane.
getLiveSeekableRange
getLiveSeekableRange() zwraca wartość cast.framework.messages.LiveSeekableRange.
Zwraca zakres wyszukiwania w czasie rzeczywistym z czasem rozpoczęcia i zakończenia w sekundach. Wartości są oparte na czasie mediów.
- Akcje powrotne
getMediaInformation
getMediaInformation() zwraca cast.framework.messages.MediaInformation
Pobiera informacje o bieżących multimediach.
- Akcje powrotne
getMediaTimeForAbsoluteTime
getMediaTimeForOmniTime(absoluteTime) zwraca liczbę
Konwertuje bezwzględny czas korzystania z mediów na czas multimediów. Bezwzględny czas dotyczy tylko transmisji na żywo.
Parametr |
|
---|---|
absoluteTime |
Liczba Bezwzględny czas mediów podany w czasie uniksowym (w sekundach od początku uniksowego okresu). |
- Akcje powrotne
-
nullable number
Czas korzystania z multimediów lubnull
, jeśli są niedostępne.
getPlaybackConfig
getPlaybackConfig() zwraca element cast.framework.PlaybackConfig
Zwraca konfigurację odtwarzania lub null
, jeśli wartości domyślne nie zostały zastąpione.
- Akcje powrotne
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() zwraca liczbę
Zwraca aktualną szybkość odtwarzania.
Zwraca wartość 1
przed wywołaniem odbiornika CastReceiverContext#start
.
- Akcje powrotne
-
number
Bieżąca szybkość odtwarzania.
getPlayerState
getPlayerState() zwraca wartość cast.framework.messages.PlayerState
Pobiera stan Player
.
- Akcje powrotne
-
non-null cast.framework.messages.PlayerState
Stan obecnegoPlayer
.
getPreferredPlaybackRate
getPreferredPlaybackRate() zwraca liczbę
uzyskać preferowaną szybkość odtwarzania; Można jej używać w przypadku zdarzenia wyłączenia, aby zapisać ostatnią preferowaną szybkość odtwarzania w pamięci trwałej. Można ją wykorzystać w następnej sesji w opcjach przesyłania.
- Akcje powrotne
-
number
getPreferredTextLanguage
getPreferTextLanguage() zwraca ciąg znaków
Pobiera preferowany język ścieżki tekstowej.
- Akcje powrotne
-
nullable string
getPreferredTextStyle
getPreferredTextStyle() zwraca cast.framework.messages.TextTrackStyle
Pobiera preferowany styl ścieżki tekstowej.
- Akcje powrotne
getQueueManager
getQueueManager() returns (cast.framework.QueueManager or undefined)
Pobiera instancję QueueManager
.
- Akcje powrotne
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() zwraca liczbę.
Pobiera czas odtwarzania bieżących multimediów bez odejmowania czasu przerwy na reklamę.
- Akcje powrotne
-
number
Czas, który upłynął, w sekundach. Jeśli nie są odtwarzane żadne multimedia, wartość to0
.
getStartAbsoluteTime
getStartTotalTime() zwraca liczbę
Pobiera bezwzględny czas rozpoczęcia multimediów jako czas uniksowy (w sekundach od początku epoki uniksowej). Czas bezwzględny dotyczy tylko transmisji na żywo.
- Akcje powrotne
-
nullable number
getStats
getStats() returns cast.framework.stats.Stats
Zwraca statystyki odtwarzania. W stosownych przypadkach statystyki są przedstawiane zbiorczo z całej sesji odtwarzania.
- Akcje powrotne
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getsupportedMediaCommands() zwraca liczbę
Pobiera obsługiwane przez odbiornik polecenia multimedialne. Należy wywołać je tylko po wywołaniu właściwości CastReceiverContext#start()
. W przeciwnym razie zwraca wartość 0
. Wartość obsługiwanych poleceń multimediów jest kontrolowana wyłącznie przez aplikację odbiornika .
Nie jest automatycznie aktualizowany na podstawie MediaStatus
.
- Zobacz też
- cast.framework.messages.Command
- Akcje powrotne
-
number
Maska bitowa poleceń multimedialnych obsługiwanych przez aplikację.
getTextTracksManager
getTextTracksManager() zwraca cast.framework.TextTracksManager
Pobiera instancję TextTracksManager
.
- Akcje powrotne
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() zwraca tablicę nienull cast.framework.TimedMetadata
Zwraca metadane czasowe, które wystąpiły podczas analizy pliku manifestu. To jest #EXT-X-DATERANGE
w HLS i EventStream
w DASH.
- Akcje powrotne
-
non-null Array of non-null cast.framework.TimedMetadata
ładunek
load(loadRequest) zwraca obietnicę zawierającą pustą wartość.
Inicjuje żądanie wczytania multimediów.
Parametr |
|
---|---|
loadRequest |
cast.framework.messages.LoadRequestData Żądanie wczytania multimediów. Wartość nie może być wartością null. |
- Akcje powrotne
-
non-null Promise containing void
Obietnica, która została zrealizowana po udanej operacji lub odrzucona, jeśli nie powiodła się.
Wstrzymaj
wstrzymaj()
Wstrzymuje aktualnie odtwarzane multimedia.
play
play()
Odtwarza aktualnie wstrzymane multimedia.
removeEventListener
removeEventListener(eventType, eventListener)
Usuwa odbiornik dodany dla danego zdarzenia odtwarzania. Jeśli nie istnieje pasujący detektor zdarzeń, wywołanie jest ignorowane.
Parametr |
|
---|---|
eventType |
(nie null cast.framework.events.EventType lub nienull tablica cast.framework.events.EventType) Obiekt eventType lub tablica typów zdarzeń |
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Usuń polecenia z listy obsługiwanych poleceń multimedialnych.
Parametr |
|
---|---|
supportedMediaCommands |
Liczba Maska bitowa poleceń multimedialnych obsługiwanych przez aplikację. |
broadcastStatus |
Opcjonalnie boolean
|
- Zobacz też
- cast.framework.messages.Command
Poszukaj
search(seekTime)
Przeszukuje bieżące multimedia.
Parametr |
|
---|---|
seekTime |
Liczba |
sendCustomState
sendCustomState(state)
Wysyła niestandardowy stan z logiki odtwarzania aplikacji do logiki interfejsu użytkownika.
Ta metoda umożliwia oddzielenie logiki odtwarzania od interfejsu użytkownika.
Dzięki zachowaniu odseparowania logiki od interfejsu użytkownik może korzystać z tej samej logiki interfejsu zarówno do odtwarzania lokalnego, jak i do sterowania zdalnego.
Stan niestandardowy wysyłany przez tę metodę jest dostępny w interfejsie użytkownika przez PlayerData
.
Parametr |
|
---|---|
state |
Obiekt Obiekt stanu niestandardowego. Wartość nie może być wartością null. |
- Zobacz też
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Wysyła błąd do określonego nadawcy.
Parametr |
|
---|---|
senderId |
ciąg znaków Identyfikator nadawcy. |
requestId |
Liczba Identyfikator przychodzącego żądania, które spowodowało ten błąd. |
typ |
cast.framework.messages.ErrorType typ błędu; Wartość nie może być wartością null. |
powód |
Opcjonalnie cast.framework.messages.ErrorReason Przyczyna błędu. Wartość może być null. |
customData |
Opcjonalnie Obiekt Komunikat o błędzie – dane niestandardowe specyficzne dla aplikacji. Wartość może być null. |
sendLocalMediaRequest
sendLocalMediaRequest(request)
Wysyła żądanie mediów lokalnych.
Parametr |
|
---|---|
Poproś |
cast.framework.messages.RequestData Wartość nie może być wartością null. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Wysyła komunikat o stanie multimediów do określonego nadawcy.
Parametr |
|
---|---|
senderId |
ciąg znaków Identyfikator nadawcy. |
requestId |
Liczba Identyfikator przychodzącego żądania, które spowodowało tę odpowiedź. |
includeMedia |
Opcjonalnie boolean
|
customData |
Opcjonalnie Obiekt Niestandardowe dane aplikacji z komunikatem o stanie. Wartość może być null. |
includeQueueItems |
Opcjonalnie boolean Określa, czy w komunikacie o stanie mają być uwzględnione elementy kolejki. Domyślnie nie są one uwzględniane. |
setIdleReason
setIdleReason(idleReason)
Określa przyczynę, dla której odtwarzacz jest w stanie IDLE
.
Dzięki temu aplikacje, które chcą wymuszać stan IDLE
, wskazują powód (na przykład błąd niestandardowy).
Przyczyna bezczynności jest wysyłana w następnym komunikacie o stanie.
Uwaga: większość aplikacji nie musi ustawiać tej wartości. Jest ona potrzebna tylko wtedy, gdy w szczególnych okolicznościach aplikacja Player
musi przejść do stanu IDLE
, a wartość domyślna idleReason nie odzwierciedla zamierzonego działania.
Parametr |
|
---|---|
idleReason |
cast.framework.messages.IdleReason Przyczyna znalezienia się w stanie Wartość nie może być wartością null. |
setMediaElement
setMediaElement(mediaElement)
Ustawia do użycia HTMLMediaElement
. Jeśli ustawiona jest wartość Promise
dla HTMLMediaElement
, odtwarzanie multimediów rozpoczyna się po rozpoznaniu Promise
.
Parametr |
|
---|---|
mediaElement |
(nie null HTMLMediaElement lub nienull Promise zawierająca niepustą wartość HTMLMediaElement)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Ustawia informacje o multimediach.
Parametr |
|
---|---|
mediaInformation |
cast.framework.messages.MediaInformation Wartość nie może być wartością null. |
opt_broadcast |
Opcjonalnie boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Ustawia moduł obsługi zwracający lub modyfikujący element cast.framework.PlaybackConfig w przypadku określonego żądania wczytania. Parametry modułu obsługi to LoadRequestData
i domyślne PlaybackConfig
dla odbiornika (określone w CastReceiverOptions
). Moduł obsługi powinien zwracać zmodyfikowaną konfigurację odtwarzania lub null
, aby uniemożliwić odtwarzanie multimediów. Wartość zwracana może też być wartością Promise
, aby umożliwić oczekiwanie na dane z serwera.
Parametr |
|
---|---|
moduł obsługi |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) Funkcja udostępniająca konfigurację odtwarzania specyficzną dla żądania. Wartość może być null. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Ustawia moduł obsługi zwracający adres URL multimediów w przypadku żądania LOAD
.
Dzięki temu modułowi obsługi możesz uniknąć publikowania adresu URL treści multimedialnych w ramach stanu mediów. Domyślnie adresem URL treści jest multimedia contentId
.
Parametr |
|
---|---|
resolver |
function(non-null cast.framework.messages.LoadRequestData) Funkcja rozpoznawania adresu URL treści multimedialnych. Wartość może być null. |
setMessageInterceptor
setMessageInterceptor(type, interceptor)
Przechwytuje wiadomości przychodzące i wychodzące.
Przechwytujący może zaktualizować dane żądania i powinien zwrócić zaktualizowane dane, kod Promise
ze zaktualizowanymi danymi (jeśli nie można ich od razu zwrócić) lub parametr null
, jeśli żądanie nie powinno zostać przetworzone.
Uwaga: jeśli dostępny jest LOAD
moduł do przechwytywania wiadomości, ale nie ma osobnego PRELOAD
przechwytującego, zostanie ono wywołane LOAD
dla wiadomości PRELOAD
.
Parametr |
|
---|---|
typ |
cast.framework.messages.MessageType Wartość nie może być wartością null. |
przechwytujący |
function(non-null cast.framework.messages.RequestData) Wartość może być null. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Ustawia konfigurację odtwarzania na urządzeniu PlayerManager
.
Parametr |
|
---|---|
playbackConfig |
Wartość nie może być wartością null. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Ustawia polecenia dotyczące multimediów obsługiwane przez odbiornik.
Parametr |
|
---|---|
supportedMediaCommands |
Liczba Maska bitowa poleceń multimedialnych obsługiwanych przez aplikację. |
broadcastStatus |
Opcjonalnie boolean
|
- Zobacz też
- cast.framework.messages.Command
przesiadka
zatrzymaj()
Zatrzymuje aktualnie odtwarzany multimedia.