cast. 架構。 CastReceiverOptions
投放接收端內容選項。所有屬性皆為選用。
建構函式
CastReceiverOptions
新的 CastReceiverOptions()
屬性
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 或未定義)
自訂佇列實作。
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。
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
(數字或未定義)
做為內部版本號碼,用於表示接收器版本的整數。這個數字只是用來在收集指標時區分不同接收器版本。這個版本應隨每個版本遞增,並在復原時沿用至該版本。