cast. framework. CastReceiverOptions
Opcje kontekstu odbiornika Cast. Wszystkie właściwości są opcjonalne.
Konstruktor
CastReceiverOptions
new CastReceiverOptions()
Właściwości
adBreakPreloadTime
(number or undefined)
Czas w sekundach, z jakim wyprzedzeniem powinniśmy wstępnie wczytać zawartość poszczególnych przerw na reklamę. Pozwala to uniknąć zbyt wczesnego wstępnego wczytywania przerwy na reklamę, co może spowodować nieprawidłowe dane reklamowe. Jeśli nie podasz tej wartości, używana będzie wartość domyślna 5 sekund.
customNamespaces
non-null Object with non-null cast.framework.system.MessageType properties
Mapa niestandardowych przestrzeni nazw wiadomości i ich typów. Niestandardowe przestrzenie nazw wiadomości muszą zostać zainicjowane przed uruchomieniem aplikacji dlatego należy je podać w opcjach odbiornika. (Jeśli nie podasz tej wartości, domyślnym typem wiadomości jest JSON).
disableIdleTimeout
(boolean or undefined)
Jeśli ma wartość „true”, uniemożliwia zamknięcie odbiornika, gdy stanie się bezczynny po zatrzymaniu aktywnego odtwarzania. Tej właściwości należy używać tylko w przypadku aplikacji innych niż multimedialne.
enforceSupportedCommands
wartość logiczna
Jeśli ma wartość „true”, każde polecenie multimedialne, które nie znajduje się na mapie supportedCommands, spowoduje wygenerowanie błędu. Wartość cast.framework.messages.ErrorReason zostanie ustawiona na NOT_SUPPORTED. Wartość domyślna to „false”, co umożliwia wykonywanie poleceń multimedialnych bez sprawdzania mapy.
localSenderId
(string or undefined)
Identyfikator nadawcy używany w przypadku żądań lokalnych. Wartość domyślna to „local”.
maxInactivity
(number or undefined)
Maksymalny czas w sekundach przed zamknięciem bezczynnego połączenia nadawcy. Ustawienie tej wartości umożliwia wysyłanie wiadomości typu heartbeat, aby utrzymać połączenie. Służy do szybszego wykrywania nieodpowiadających nadawców niż typowych limitów czasu TCP. Minimalna wartość to 5 sekund. Nie ma górnego limitu, ale zwykle mija kilka minut, zanim zaczną obowiązywać limity czasu TCP platformy. Wartość domyślna to 10 sekund.
mediaElement
(non-null HTMLMediaElement or undefined)
Element multimedialny do odtwarzania treści. Domyślne zachowanie polega na użyciu pierwszego elementu multimedialnego znalezionego na stronie.
playbackConfig
(non-null cast.framework.PlaybackConfig or undefined)
Konfiguracja odtwarzania z parametrami niestandardowymi.
playWatchedBreak
(boolean or undefined)
Jeśli ma wartość „true”, przerwa zszyta po stronie klienta będzie odtwarzana nawet wtedy, gdy została już obejrzana.
preferredPlaybackRate
(number or undefined)
Szybkość odtwarzania, która ma być używana, jeśli nie została określona w żądaniu wczytania. Dopuszczalny zakres to od 0,5 do 2, przy czym 1 oznacza normalną prędkość.
preferredTextLanguage
(string or undefined)
Język, który ma być używany w przypadku ścieżki tekstowej, jeśli żądanie wczytania nie określa aktywnej ścieżki.
queue
(non-null cast.framework.QueueBase or undefined)
Niestandardowa implementacja kolejki.
shakaVariant
(non-null cast.framework.ShakaVariant or undefined)
Która wersja odtwarzacza Shaka ma zostać wczytana. Aby wczytać kompilację do debugowania, ustaw wartość
cast.framework.ShakaVariant.DEBUG.
shakaVersion
(string or undefined)
Wersja Shaka w formacie GŁÓWNA.PODRZĘDNA.POPRAWKA lub GŁÓWNA.PODRZĘDNA.POPRAWKA-PRZYROSTEK format, np. "4.15.55" (obecna wartość domyślna).
Obsługiwane wersje to >=4.15.55 <5.0.0. Wersje, które są przestarzałe, ale nadal zgodne, to >=2.5.6 <4.15.55.
UWAGA: nie zalecamy używania wersji odtwarzacza Shaka starszych niż domyślna, ponieważ w najnowszych wersjach naprawiono wiele błędów. Możesz tu określić nowsze wersje, aby korzystać z dodatkowych poprawek lub funkcji, które nie są jeszcze dostępne domyślnie. Pamiętaj jednak, że przyszłe wersje pakietu Web Receiver SDK mogą zmienić zakres obsługiwanych wersji i wymusić użycie wersji innej niż ta, którą tu określisz. Tego flagi należy używać tylko tymczasowo i zgodnie z zaleceniami zespołu pomocy Cast. (https://developers.google.com/cast/support) Używaj na własne ryzyko.
skipMplLoad
(boolean or undefined)
Jeśli ma wartość „true”, uniemożliwia wczytanie odtwarzacza MPL przez odbiornik.
skipPlayersLoad
(boolean or undefined)
Jeśli ma wartość „true”, uniemożliwia wczytanie przez odbiornik bibliotek odtwarzacza MPL lub Shaka. Odpowiednik ustawienia wartości „true” zarówno w przypadku skipMplLoad, jak i skipShakaLoad.
skipShakaLoad
(boolean or undefined)
Jeśli ma wartość „true”, uniemożliwia wczytanie odtwarzacza Shaka przez odbiornik.
statusText
(string or undefined)
Tekst reprezentujący stan aplikacji. Powinien być zgodny z regułami internacjonalizacji, ponieważ może być wyświetlany przez aplikację nadawcy.
supportedCommands
(number or undefined)
Bitmaska poleceń multimedialnych obsługiwanych przez aplikację. Polecenia LOAD, PLAY, STOP i GET_STATUS muszą być zawsze obsługiwane. Jeśli ta wartość nie zostanie podana, przyjmuje się, że obsługiwane są też polecenia PAUSE, SEEK, STREAM_VOLUME, STREAM_MUTE, EDIT_TRACKS i PLAYBACK_RATE.
- Zobacz też
- cast.framework.messages.Command
uiConfig
(non-null cast.framework.ui.UiConfig or undefined)
Konfiguracja interfejsu.
useLegacyDashSupport
(boolean or undefined)
Jeśli ma wartość true, używaj MPL w przypadku treści DASH.
useShakaForHls
(boolean or undefined)
Jeśli ma wartość true, używaj odtwarzacza Shaka w przypadku treści HLS. Domyślnie ma wartość false.
UWAGA: odtwarzacz Shaka nie jest domyślnym odtwarzaczem treści HLS, ponieważ brakuje w nim niektórych funkcji. Chcemy też mieć pewność, że jest wydajny i w pełni zgodny z odbiornikami HLS, zanim stanie się domyślnym odtwarzaczem. Jeśli przed oficjalnym wprowadzeniem odtwarzacza Shaka w przypadku treści HLS zdecydujesz się na jego używanie, prosimy o zgłaszanie wszelkich napotkanych problemów. (https://developers.google.com/cast/support) Zanim odtwarzacz Shaka w przypadku treści HLS zostanie w pełni wprowadzony nie gwarantujemy jego zgodności z HLS. Jeśli napotkasz poważne problemy, możemy zalecić przywrócenie domyślnego ustawienia tej flagi.
versionCode
(number or undefined)
Liczba całkowita używana jako wewnętrzny numer wersji do reprezentowania wersji odbiornika wersji. Ta liczba służy tylko do rozróżniania wersji odbiornika podczas zbierania danych. Należy ją zwiększać z każdą wersją i w przypadku wycofania zmian pozostawić powiązaną z tą wersją.