cast.
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ę. Dzięki temu możesz uniknąć zbyt wczesnego wstępnego wczytywania przerwy na reklamę, co może spowodować nieprawidłowe dane o reklamach. 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”, odbiornik nie zostanie zamknięty, gdy po zatrzymaniu aktywnego odtwarzania przejdzie w stan bezczynności. 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, wygeneruje błąd. 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 nadawców, którzy nie odpowiadają, niż w przypadku 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 jest 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 Shaka Player 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.35" (obecnie domyślna).
Obsługiwane wersje to >=4.15.35 <5.0.0. Wersje, które są przestarzałe, ale nadal zgodne, to >=2.5.6 <4.15.35.
UWAGA: nie zalecamy używania wersji Shaka Player 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 SDK odbiornika internetowego mogą zmienić zakres obsługiwanych wersji i wymusić użycie wersji innej niż ta, którą tu określisz. Tej 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”, odbiornik nie wczyta odtwarzacza MPL.
skipPlayersLoad
(boolean or undefined)
Jeśli ma wartość „true”, odbiornik nie wczyta bibliotek odtwarzacza MPL ani Shaka bibliotek. Odpowiednik ustawienia wartości „true” zarówno dla skipMplLoad, jak i skipShakaLoad.
skipShakaLoad
(boolean or undefined)
Jeśli ma wartość „true”, odbiornik nie wczyta odtwarzacza Shaka.
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, w przypadku treści DASH używaj MPL.
useShakaForHls
(boolean or undefined)
Jeśli ma wartość true, w przypadku treści HLS używaj Shaka Player. Domyślnie ma wartość false.
UWAGA: Shaka Player nie jest domyślnym odtwarzaczem treści HLS, ponieważ brakuje w nim jeszcze niektórych funkcji i chcemy mieć pewność, że jest wydajny i w pełni zgodny z odbiornikami HLS, zanim stanie się domyślnym odtwarzaczem. Jeśli przed oficjalnym uruchomieniem zdecydujesz się na używanie Shaka Player w przypadku HLS, prosimy o zgłaszanie wszelkich napotkanych problemów. (https://developers.google.com/cast/support) Przed pełnym uruchomieniem Shaka Player w przypadku HLS nie gwarantujemy zgodności Shaka Player z HLS i w przypadku poważnych problemów 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. Powinna być zwiększana z każdą wersją i pozostawać powiązana z tą wersją w przypadku wycofania zmian.