類別:CastReceiverOptions

建構函式

CastReceiverOptions

新的 CastReceiverOptions()

屬性

adBreakPreloadTime

(數字或未定義)

我們應提前多久預先載入個別廣告插播內容 (以秒為單位)。這樣您就能避免超早預先載入廣告插播,導致廣告指標混淆。如未提供,系統會使用 5 秒的預設值。

customNamespaces

具有非空值 cast.framework.system.MessageType 屬性的非空值物件

自訂訊息命名空間及其類型的對應。自訂訊息命名空間必須在應用程式啟動前進行初始化,因此您必須在接收器選項中提供這些命名空間。(如未提供,則預設訊息類型為 JSON)。

disableIdleTimeout

(布林值或未定義)

如果為 true,防止接收器在有效播放結束後處於閒置狀態時關閉。這項屬性僅適用於非媒體應用程式。

enforceSupportedCommands

常數

boolean

設為 true 時,不支援指令對應中的所有媒體指令都會產生錯誤。cast.framework.messages.ErrorReason 會設為 NOT_SUPPORTED。預設值為 false,表示不查看地圖即可執行媒體指令。

localSenderId

(字串或未定義)

用於本機要求的寄件者 ID。預設值為「local」。

maxInactivity

(數字或未定義)

關閉閒置寄件者連線前的最長時間 (以秒為單位)。設定這個值會啟用活動訊號訊息,讓連線保持運作。用於偵測無回應寄件者的速度,比一般 TCP 逾時更快。最小值為 5 秒;未強制執行上限,但通常在平台 TCP 逾時生效前幾分鐘。預設值為 10 秒。

mediaElement

(非空值 HTMLMediaElement 或未定義)

用於播放內容的媒體元素。預設行為是使用網頁中的第一個媒體元素。

playbackConfig

(非空值的 cast.framework.PlaybackConfig 或未定義)

包含自訂參數的播放設定。

playWatchedBreak

(布林值或未定義)

如為「true」,即便已經觀看,用戶端拼接的廣告插播時間點仍會播放。

preferredPlaybackRate

(數字或未定義)

未在載入要求中指定使用的播放速率。允許的範圍介於 0.5 至 2 之間,1 代表正常速度。

preferredTextLanguage

(字串或未定義)

如果載入要求未指定有效的測試群組,要用於文字軌的語言。

待播清單

(非空值的 cast.framework.QueueBase 或未定義)

自訂佇列實作。

shakaVariant

(非空值的 cast.framework.ShakaVariant 或未定義)

應載入的 Shaka Player 版本。設為 cast.framework.ShakaVariant.DEBUG 即可載入偵錯版本。

shakaVersion

(字串或未定義)

採用 MAJOR.MINOR.PATCH 格式的 Shaka 版本,例如「4.3.4」(目前預設值)。

支援的版本為 >=3.3.16 <5.0.0。已淘汰,但仍相容版本為 >=2.5.6 <3.3.16。

注意:不建議使用比預設版本更舊的 Shaka Player,因為最新版本中已修正許多錯誤。在這裡可指定較新版本,選用其他預設尚未提供的修正或功能。不過請注意,Web Receiver SDK 日後推出的版本可能會變更支援版本的範圍,並強制使用其他版本,而不是您在這裡指定的版本。這個標記只能做為臨時措施,並應在 Cast 支援團隊的協助下使用。(https://developers.google.com/cast/support) 但您必須自行承擔使用風險。

skipMplLoad

(布林值或未定義)

如果為 true,系統會禁止接收端載入 MPL 播放器。

skipPlayersLoad

(布林值或未定義)

如果設為 true,系統會禁止接收器載入 MPL 或 Shaka 播放器程式庫。等同於將 SkipMplLoad 和 SkipShakaLoad 設為 true。

skipShakaLoad

(布林值或未定義)

如果設為 true,系統會禁止接收端載入 Shaka 播放器。

statusText

(字串或未定義)

代表應用程式狀態的文字。此 ID 應符合國際化規則,因為寄件者應用程式可能會顯示這項資訊。

supportedCommands

(數字或未定義)

應用程式支援的媒體指令位元遮罩。您必須一律支援 LOAD、PLAY、STOP、GET_STATUS。如果未提供這個值,系統也會假設支援 PAUSE、SEEK、STREAM_VOLUME、STREAM_MUTE、EDIT_TRACKS 及 PLAYBACK_RATE。

另請參閱
cast.framework.messages.Command

uiConfig

(非空值的 cast.framework.ui.UiConfig 或未定義)

使用者介面設定。

useLegacyDashSupport

(布林值或未定義)

如為 true,請針對 DASH 內容使用 MPL。

useShakaForHls

(布林值或未定義)

如為 true,請使用 Shaka Player 處理 HLS 內容。預設值為 false

注意:HTTP 即時串流內容仍缺少一些功能,因此在 HLS 內容預設的情況下,由於我們想要確保其效能良好,並與 HLS 接收器相容,因此這不是預設的 HLS 內容。如果您在正式發布前選擇加入 HLS 的 Shaka Player,請回報所遇到的問題。 (https://developers.google.com/cast/support) 在 HLS 適用的 Shaka Player 全面推出前,我們無法保證 Shaka Player 與 HLS 的相容性,如果遇到難以解決的問題,我們可能會建議將此標記還原為預設設定。

versionCode

(數字或未定義)

做為內部版本號碼,用於表示接收器版本的整數。這個數字只是用來在收集指標時區分不同接收器版本。這個版本應隨每個版本遞增,並在復原時沿用至該版本。