CastReceiverOptions

new CastReceiverOptions()

adBreakPreloadTime

(數字或未定義)

應提前多久預先載入個別廣告插播的內容 (以秒為單位)。這樣一來，您就不會過早預先載入廣告插播，導致廣告指標混淆。如未提供，則預設為 5 秒。

customNamespaces

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

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

disableIdleTimeout

(布林值或未定義)

如果設為 true，則在主動播放停止後，接收端閒置時不會關閉。這項屬性僅適用於非媒體應用程式。

enforceSupportedCommands

布林值

如果設為 true，任何不在 supportedCommands 對應中的媒體指令都會產生錯誤。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

(字串或未定義)

Shaka 版本，格式為 <主版本號>.<次版本號>.<修補程式編號> 或 <主版本號>.<次版本號>.<修補程式編號>-<後置字串>，例如「4.15.56」(目前的預設值)。

支援的版本為 >=4.15.56 <6.0.0。 已淘汰但仍相容的版本為 >=2.5.6 <4.15.56。

注意：不建議使用預設版本之前的 Shaka Player 版本，因為最新版本已修正許多錯誤。您可以在這裡指定較新版本，選擇加入預設尚未提供的其他修正或功能。不過請注意，日後推出的 Web 接收器 SDK 版本可能會變更支援的版本範圍，並強制使用此處指定版本以外的版本。這個標記只能做為暫時措施，且應在 Cast 支援團隊的指導下使用。(https://developers.google.com/cast/support) 使用時請自行承擔風險。

skipMplLoad

(布林值或未定義)

如果設為 true，接收端就不會載入 MPL 播放器。

skipPlayersLoad

(布林值或未定義)

如果設為 true，接收端就無法載入 MPL 或 Shaka 播放器程式庫。相當於將 skipMplLoad 和 skipShakaLoad 都設為 true。

skipShakaLoad

(布林值或未定義)

如果設為 true，接收端就不會載入 Shaka 播放器。

statusText

(字串或未定義)

代表申請狀態的文字。這項資訊應符合國際化規則，因為可能會由傳送端應用程式顯示。

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 或未定義)

UI 設定。

useLegacyDashSupport

(布林值或未定義)

如果 true，請使用 MPL 播放 DASH 內容。

useShakaForHls

(布林值或未定義)

如果是 true，請使用 Shaka Player 播放 HLS 內容。預設為 false。

注意：Shaka Player 仍有部分功能尚未推出，且我們希望確保其效能良好，並與 HLS 接收器廣泛相容，才會將其設為預設播放器，因此目前並非 HLS 內容的預設播放器。如果您在正式推出前選擇使用 Shaka Player 播放 HLS，請回報遇到的任何問題。(https://developers.google.com/cast/support)。在 Shaka Player for HLS 正式推出前，我們不保證 Shaka Player 與 HLS 的相容性。如果您遇到重大問題，我們可能會建議您將這個標記還原為預設設定。

versionCode

(數字或未定義)

做為內部版本號碼的整數，代表接收端版本。這個數字僅用於在收集指標時區分接收端版本。每次發布時，這個值都應遞增，並在復原時保持與該版本繫結。