每當 Google Cast 發布新版本,我們都會在下方說明變更內容,並更新 API 參考資料。如要瞭解設計檢查清單的變更,請參閱changelog。
2025 年 10 月 7 日
iOS 傳送者 4.8.4
- 新增使用者介面,方便使用者在傳送端閱讀並核准 Google Cast 服務條款和隱私權政策。
- iOS SDK 現在支援的最低版本為 iOS 15。
- 自 4.3.1 版起,Cocoapods 預設會發布靜態程式庫。從 4.8.4 版開始,這個靜態程式庫會包含 Protobuf 程式庫。建議您使用靜態程式庫,以免發生 Protobuf 版本相容性問題。不過,您也可以下載動態程式庫。
-
請注意,如果
GCKErrorCode
為GCKErrorCodeCancelled
,投放失敗和連線中斷是預期行為。請確保應用程式不會在投放失敗或因GCKErrorCodeCancelled
而中斷連線時自動重試投放,否則使用者拒絕服務條款時,可能會導致非預期行為。
2025 年 5 月 12 日
Android Sender 22.1.0
-
發布 play-services-cast:22.1.0 和 play-services-cast-framework:22.1.0
-
更新為依附於 androidx.mediarouter:mediarouter:1.8.0-beta01,並支援 AndroidX Media Router
MediaRouter.RouteInfo#connect()
和MediaRouter.RouteInfo#disconnect()
API。 -
新增
CastOptions.Builder
,用於設定 AndroidX Media RouterMediaRouterParams.Builder#setMediaTransferRestrictedToSelfProviders(boolean)
API。
-
更新為依附於 androidx.mediarouter:mediarouter:1.8.0-beta01,並支援 AndroidX Media Router
2024 年 10 月 28 日
Android 傳送端 22.0.0 和 Android TV 接收端 21.1.1
- 修正 Protobuf Java Lite 程式庫中發現的潛在阻斷服務安全漏洞。
- 已刪除 MediaNotificationService。應用程式不應直接使用這項功能。
- 修正 Android R 或舊版裝置的錯誤:在 Google Cast 通知中顯示過小的圖片時,可能會導致系統 UI 異常。
2024 年 9 月 4 日 2024 年 11 月 1 日
網頁接收器 3.0.0133 3.0.0135 3.0.0137
- CAF 使用的預設 Shaka Player 版本已從 4.3.4 更新至 4.9.2。如需完整變更清單,請參閱 Shaka Player changelog。
- 為 Shaka 播放器啟用內容預先載入功能。這樣就能在媒體項目或廣告插播之間順暢切換。
- 修正 Shaka 切換轉碼器時發生的錯誤。
- 新增了 Shaka 錯誤的
ErrorSeverity
欄位。如果嚴重程度為RECOVERABLE
,播放作業不應停止。 - 修正並行載入要求導致內容載入失敗的問題。
- 在內部,CAF 現在會使用
shaka.Player#attach
附加媒體元素,而不是將媒體元素傳遞至shaka.Player
建構函式 (已在 Shaka API 中淘汰)。 - 在
cast.framework.events.Id3Event
中新增frameType
和frameDescription
欄位。使用 Shaka Player 播放內容時,系統會填入這些欄位。 - 新增
REQUEST_GET_STATUS
和REQUEST_PRELOAD
事件。您可以使用PlayerManager#addEventListener
監聽這些事件。 - 針對
requestId
錯誤的載入要求,新增錯誤回應,而非無聲失敗。 - 修正 Shaka Player
jumpLargeGaps
設定的警告記錄,該設定已在 Shaka v4 中淘汰。 - 開始在
LOADING
狀態的MediaStatus
訊息中填入requestId
。 - 載入新內容時,請回收 Shaka 播放器例項。
- 停止支援已淘汰的
QUEUE_SHUFFLE
媒體指令。改用QUEUE_UPDATE
。 - 修正 VAST 廣告 Pod 的支援問題,現在每個
<Ad>
代碼都有sequence
屬性和巢狀<Wrapper>
代碼。 - 修正
crossorigin
屬性的傳播問題,現在系統會將<cast-media-player>
屬性傳播至巢狀<video>
元素,即使crossorigin
屬性沒有值也一樣。 - 在 MPL 中公開頻內音訊語言。
2024 年 8 月 22 日
iOS 傳送器 4.8.3
- 修正錯誤:輕觸 Cast 按鈕時,裝置挑選器不會開啟。
- 修正了影響搭載 iOS 17 以上版本裝置的 AVRouting 相關當機問題。
2024 年 4 月 18 日
iOS Sender 4.8.1
- Cast SDK 現在支援的最低版本為 iOS 14。
- 套件中包含隱私權資訊清單和已簽署的 xcframework。
- 訪客模式已遭淘汰並移除。這個版本只會提供單一 SDK 類型,方便您整合。
- 修正有時在投放時播放短廣告會導致當機的問題。
2023 年 12 月 11 日
Web Receiver 3.0.0122
- 新增對 VAST 的廣告插播和廣告百匯支援。
- 更新 Google TV 裝置的 Cast Player 媒體控制項使用者介面。
- 在
Track
物件中新增audioTrackInfo
欄位。 - 新增
cast.framework.system.Message
, 代表從寄件者收到或傳送給寄件者的訊息。 - 變更了搜尋中斷邏輯。現在,只有在
BreakManager#setBreakSeekInterceptor
傳回超過 1 個中斷點時,Web Receiver 才會建立合成seek-{timestamp}
中斷點,否則搜尋中斷點會與時間軸上的原始中斷點相同。 - 新增在 CAF 中載入 Shaka Player 偵錯版本的選項。
CastReceiverOptions#shakaVariant
-
修正使用 AES-128 加密時,Shaka 無法辨識 HLS 的
PlaybackConfig#licenseRequestHandler
和PlaybackConfig#licenseResponseHandler
的問題。 - 修正使用 Shaka Player 時,
ID3Event
未觸發的問題。 - 修正使用前置廣告時,側載文字軌的問題。
- 修正使用
UITextDisplayer
時的文字轉譯問題。 - 修正 VAST、MIME 類型和內容保護系統名稱的各種大小寫區分問題。
- 修正強制顯示字幕的各種問題。
- 修正
BREAK_CLIP_ENDED
事件的EndedReason
代碼填入問題。
2023 年 12 月 4 日
Android 傳送器 21.4.0 和 Android TV 接收器 21.0.1
-
發布 play-services-cast:21.4.0 和 play-services-cast-framework:21.4.0
- 將 minSdkVersion 從 16 提高至 19。
-
更新為依附於 androidx.mediarouter:mediarouter:1.6.0-beta01。這會讓
MediaRouteButtons
預設為一律顯示。這樣一來,在使用者未採取任何動作的情況下,系統就不會自動啟動 Cast 裝置探索功能。 -
新增
CastOptions.Builder#setSessionTransferEnabled
,用於設定是否在啟用輸出端切換器時,顯示投放裝置。預設值為 true。 -
如果應用程式未設定
CastMediaOptions
或將 CastMediaOptions 設為空值,系統就不會再建立MediaSessions
。 -
修正使用
FragmentContainerViews
時可能發生的MiniControllerFragment
android.view.InflateException
錯誤。 -
新增
CastButtonFactory#setUpMediaRouteButton
的版本,會傳回Tasks
,應用程式可監聽成功或擲回的例外狀況。不採用Executor
引數的舊版會忽略 ModuleUnavailableExceptions,並以無訊息方式失敗。
-
發布 play-services-cast-tv:21.0.1
- 將 minSdkVersion 從 16 提高至 19。
- 此版本包含品質提升項目
2023 年 7 月 20 日
iOS 傳送器 4.8.0
- iOS SDK 現在支援的最低版本為 iOS 13。
- 第一個穩定版 XCFramework。
- 透過 Cocoapods 提供的 XCFrameworks。
- 還原在媒體播放期間使用實體音量鍵控制音量的功能。
- 在導覽列中使用時,Cast 按鈕現在會採用色調顏色。
- 現在可以使用 GCKUIStyle API 自訂導覽列標題顏色。
- 修正媒體軌字幕清單檢視畫面中的透明導覽列問題。
- 修正 XCFramework Beta 版中的異常終止問題。
- 新增 API,將 UIControl 與快轉或倒轉動作繫結。
- Pixel 平板電腦現在支援投放功能。
2023 年 7 月 6 日
Web Receiver 3.0.0111
-
新增支援使用
BreakManager
addBreak(breakData, breakClips, broadCastMediaStatus)
和removeBreakById(breakId)
插入動態廣告。 -
在 Smooth 資訊清單中新增
Subtype
字串剖析功能。 -
在 Shaka Player 的
manifestRequestHandler
、segmentRequestHandler
和licenseRequestHandler
中,新增對非同步要求的支援。 - 開始支援強制字幕。
- 將 CAF 的預設 Shaka 版本調升至 v4.3.4。
-
清楚闡釋
setActiveByIds
參數說明。 - 修正 CAF 選擇不同音軌的方式。
- 修正 Shaka 要求篩選器的要求主體類型轉換。
-
新增查詢與
BreakManager
中BreakClip
相關CreativeInformation
的功能。getCreativeInfoByClipId(breakClipId)
- 修正透過 D-Pad 控制的裝置載入媒體元素時,媒體中繼資料遺失的問題。
-
已將
hlsSegmentFormat
和hlsVideoSegmentFormat
屬性新增至BreakClip
。 - 使用 MPL 修正區分大小寫的 MIME 類型比較。
- 修正使用 Shaka Player 時,載入固定式 HLS (以 TS 為基礎) 直播時無限緩衝的問題。
-
修正
IS_AT_LIVE_EDGE_CHANGED
事件的PlayerDataBinder
行為。 - 修正使用 MPL 時,TS 區隔中提供的資料不足而導致的無限迴圈問題。
-
新增
error.stack
,用於 Shaka Player 錯誤。 -
改為使用
audioMimeType
欄位,而非 Shaka Player 軌物件中的audioCodec
,以填入變體軌的cast.framework.messages.Track.trackContentType
欄位。 -
已將
shaka.extern.track.label
新增至cast.framework.messages.Track.name
,適用於 Shaka Player 軌。 -
擴充
cast.framework.stats.Stats
物件,以納入shaka.extern.Stats
中的現有欄位。 - 修正含有擴展嵌入中斷點的內容媒體時間計算。
2023 年 3 月 28 日
Android 傳送端 21.3.0 和 Android TV 接收端 21.0.0
-
發布 play-services-cast:21.3.0 和 play-services-cast-framework:21.3.0
-
現在會使用
NotificationManager
發布 Google Cast 媒體通知,而非Foreground Service
。 -
新增
CastReasonCodes#CAST_CANCELLED
,指出正在取消的 Cast 工作階段。
-
現在會使用
-
發布 play-services-cast-tv:21.0.0
- 修正
MediaManager
的可空值註解。
- 修正
2022 年 10 月 17 日
Web Receiver 3.0.0105
- 已將 Shaka 播放器升級至 3.2.11 版。
-
新增
cast.framework.PlaybackConfig#enableUITextDisplayer
,以便使用 DOM 在 Shaka Player 中算繪說明文字。 -
新增
cast.framework.CastReceiverOptions#shakaVersion
和cast.framework.CastReceiverOptions#useShakaForHls
,讓接收器使用 Shaka Player 播放 HLS。 -
PlaybackConfig#manifestHandler
、PlaybackConfig#segmentHandler
和PlaybackConfig#licenseHandler
現在可以存取 HTTP 回應標頭。 -
當
LOAD_BY_ENTITY
訊息解析時發生錯誤,則在CommandAndControlManager#ErrorResponseData
中加入customData
。
2022 年 10 月 10 日
Android Sender 21.2.0
-
發布 play-services-cast:21.2.0 和 play-services-cast-framework:21.2.0
-
導入
Output Switcher
功能。 -
新增 API
Cast.Listener#onDeviceNameChanged()
,用於通知stream transfer
裝置名稱變更。 -
淘汰
CastOptions.Builder#setVolumeDeltaBeforeIceCreamSandwich(double)
和CastOptions#getVolumeDeltaBeforeIceCreamSandwich()
。 -
修正了
MediaNotificationService
的ForegroundServiceStartNotAllowedException
。 -
已更新「
MediaNotificationService
」 ,並新增「Media controls in System UI
」。 -
更新
RemoteMediaClient
API,使其接受可為空值的customData
。 -
已更新
MediaInfo.Builder
,可接受contentId
或contentURL
。 -
已更新
ImagePicker#onPickImage
,可接受可為空值的MediaMetadata
。 -
已將
com.google.android.datatransport:transport-api
依附元件更新至最新版本。
-
導入
2022 年 8 月 8 日
Android 傳送器 21.1.0 和 Android TV 接收器 20.0.0
-
發布 play-services-cast:21.1.0 和 play-services-cast-framework:21.1.0
-
淘汰了
CastContext#getSharedInstance(Context)
。請改用CastContext#getSharedInstance(Context, Executor)
(會傳回 Task API) 和ModuleUnavailableException
,在 Cast SDK 無法載入內部 Cast 模組時處理例外狀況。 -
淘汰了
ApplicationMetadata#getImages()
。請改用ApplicationMetadata#getIconUrl()
,這個方法會傳回在 Cast 開發人員控制台中設定的應用程式圖片。 -
修正註冊及取消註冊
MediaQueue.Callbacks
時可能發生的ConcurrentModificationException
錯誤。 -
已修正直播的
MediaInfo#getStreamDuration()
。 -
修正 Android S 上
MediaNotificationService
的通知彈跳床限制。 -
已修正
CastContext
外洩活動參照的問題。 - 修正錯誤:廣告期間顯示的是清晰的背景圖片,而非模糊版本。
-
淘汰了
-
已發布 play-services-cast-tv:20.0.0
- 已將
minSdkVersion
從 14 升級至 16。 -
修正
MediaManager#setSessionCompatToken(MediaSession.CompatToken)
的問題,現在可正確支援空值引數。
- 已將
2022 年 3 月 31 日
Web Receiver 3.0.0103、MPL Player 1.0.0.113
- 預設 Shaka 播放器版本已升級至 3.2.2。
-
新增
cast.framework.PlaybackConfig#shakaConfig
這個 API,可覆寫 Shaka Player 版本和其他 Shaka 選項。 -
新增
cast.framework.ui.Controls#hasMediaControlsOverlay()
這個 API,可查詢媒體控制項疊加層是否顯示在應用程式上方。 -
新增「喜歡」使用者動作的新樣式
cast.framework.ui.ControlsButton.LIKE_HEART
。 -
cast.framework.events.EventType.BREAK_CLIP_ENDED
事件資料的currentMediaTime
值現在代表事件發生時,最新中斷片段的目前時間。 -
新增
cast.framework.PlayerManager#getRawCurrentTimeSec
方法,可傳回媒體元素的媒體時間。 -
新增
cast.framework.NetworkRequestInfo#timeoutInterval
,指定播放器要求的 HTTP 要求逾時。 - 修正 MPL 錯誤,可解碼已解多工的 A/V 串流 CEA 608/708 字幕。
- 修正 MPL WebVTT 時間戳記剖析邏輯,可接受超過 2 位數的小時值。
2021 年 12 月 9 日
Android Sender 21.0.0
- 我們將空值安全性違規事項視為錯誤,進一步提升 Kotlin 的空值支援。Java 開發人員不會受到影響。如果現有程式碼並非空值安全,Kotlin 開發人員可能會看到新的建構失敗訊息。
2021 年 11 月 19 日
iOS 傳送者 4.7.0
- 修正 iOS 傳送端支援,可搭配 Cast Connect 使用 ATV 憑證。
- 修正使用 Xcode 13 建構時,導覽列背景為透明的錯誤。
-
修正
GCKUICastButton.
回報的無障礙功能問題 - 修正錯誤:在 Wi-Fi 和行動網路之間切換時,系統會中斷投放工作階段,而非暫停工作階段。
- 停止支援 iOS 10 和 iOS 11,因此不再支援 32 位元架構。
- 修正其他錯誤並提升效能。
2021 年 11 月 16 日
Android Sender 20.1.0
- 注意:如果應用程式指定 Android 12,就必須更新至 Android Sender 20.1.0,以免發生執行階段當機問題。
- 佇列改善項目
-
在 MediaQueue 中新增
itemsReorderedAtIndexes
回呼,會在佇列重新排序時呼叫。 - 新增佇列指令的序列化支援。
-
將
RemoteMediaClient#queueSetRepeatMode
中的customData
參數設為可為空值。 - 遠端螢幕功能已淘汰。
minSdkVersion
已從 14 升級至 16。
2021 年 10 月 26 日
Web Receiver 3.0.0102
- 升級至 Shaka 播放器 3.0.13 版 (這會修正先前獲報的許多問題)。
- 新增支援 智慧螢幕和 Chromecast 上的次要圖片。
- 修正問題:由於偵測重複軌的邏輯發生錯誤,導致系統無法顯示緩衝串流的字幕。
-
修正問題:當
LOAD_BY_ENTITY
傳回錯誤時,接收端的錯誤回呼不會觸發。 - 新增對傳輸串流的高效率 AAC (HE-AAC) 音訊轉碼器支援。
-
修正
PlayerManager.getStats()
未傳回正確高度和寬度值的錯誤。 -
從
MediaStatus
訊息中移除 VAST 和 VMAP 資訊,避免溢位,導致傳送端與接收端中斷連線。 -
修正問題:廣告遭到略過時,系統不會將
endedReason
提供給傳送者。 - 修正廣告插播從載入佇列中移除後,無法播放的問題。
-
新增
cast.framework.message.QueueChange#reorderItemIds
欄位,其中包含受QUEUE_CHANGE
作業影響的佇列項目清單。 - 在 MPL 中切換音軌時,HLS 直播串流的緩衝時間縮短,音訊和影片現在會保持同步。
- 修正 MPL 中內嵌 CEA608/CEA708 字幕的 HLS 串流剖析問題。
- 如果媒體暫停超過 5 秒,Chromecast (支援 Google TV) 的媒體控制項就會隱藏。
2021 年 5 月 26 日
iOS Sender 4.6.1
- 修正問題:允許背景執行的應用程式會暫停背景 Cast 工作階段。
2021 年 5 月 17 日
iOS 傳送器 4.6.0
- 變更「投放」按鈕的預設行為,連上 Wi-Fi 時一律顯示。
- 新增說明對話方塊,使用者輕觸「投放」按鈕但系統找不到任何裝置時,就會顯示這個對話方塊。
-
已淘汰
GCKUICastButton::triggersDefaultCastDialog
API。 -
對於透過新版 API
GCKUICastButtonDelegate
實作自訂 UI 的應用程式,現在可更一致地支援對話方塊自訂功能。 - 新增 iOS 13 以上版本的深色模式支援。
-
新增廣告標記自訂功能至
GCKUIStyleAttributes
。 -
新增對媒體的
hlsSegmentFormat
和hlsVideoSegmentFormat
支援。 - 修正多項錯誤並提升執行效能。
2021 年 4 月 29 日
Web Receiver 3.0.0096
2021 年 4 月 20 日
Android 傳送端 20.0.0 和 Android TV 接收端 18.0.0
-
發布 play-services-cast:20.0.0 和
play-services-cast-framework:20.0.0。
- 刪除 GameManager 和相關 API。這些功能已於 2017 年淘汰。
-
在 Cast 用戶端程式庫中新增
SessionState
類別。 -
新增了
CastReasonCodes
,提供CastStatusCodes
的詳細說明。使用CastContext#getCastReasonCodeForCastStatusCode(int)
方法,將CastStatusCodes
翻譯為CastReasonCodes
。 -
已將
HlsSegmentFormat
和HlsVideoSegmentFormat
新增至MediaInfo.Builder
。 -
將
foregroundServiceType
的MediaNotificationService
標示為mediaPlayback
。 -
已將
com.google.android.datatransport:transport-api
的依附元件更新至最新版本。 -
新增
MediaLoadRequestData.Builder
建構函式,可從MediaLoadRequestData
物件建構。 - 修正從 VOD 切換至 LIVE 串流時,迷你播放器的播放/暫停按鈕問題。
-
實作 Cast 媒體通知的
MediaIntentReceiver#ACTION_DISCONNECT
。
-
發布 play-services-cast-tv:18.0.0:
-
在 cast-tv 程式庫中新增
StoreSessionRequestData
類別和StoreSessionResponseData
類別。
-
在 cast-tv 程式庫中新增
2021 年 4 月 5 日
Web Receiver 3.0.0095
- 已將 Shaka Player 升級至 3.0.10 版。
-
現在只要支援
STREAM_TRANSFER
媒體指令,系統就會預設顯示 Cast 按鈕。 - 在媒體瀏覽 UI 底部新增建議列。建議列包含互動式動態磚,選取後即可播放媒體項目,或捲動瀏覽可用的媒體項目。每個晶片也會對應至可用的 Google 助理指令。目前只有在系統語言設為英文或日文時,系統才會顯示建議方塊。
- 修正 Chromecast (支援 Google TV) 的錯誤:將相片內容投放到預設接收器時,系統會顯示媒體控制項疊加層。
- 新增
TRACKS_CHANGED
事件支援。
2020 年 12 月 18 日
Web Receiver 3.0.0085
-
已在
CastReceiverOptions
中新增選項,可停用 Shaka 和 MPL 的載入作業。
2020 年 12 月 3 日
iOS 傳送器 4.5.3
-
已修正
GCKCredentialsData
的載入時間錯誤「Undefined symbols for architecture arm64」。 -
修正了
GCKCredentialsData
上空值可為空值性衝突的編譯器錯誤。 -
如果
Info.plist
缺少必要的 Bonjour 服務項目,系統現在會記錄警告訊息。
2020 年 11 月 4 日
iOS 傳送器 4.5.2
-
在 CocoaPods 中,
Protobuf
程式庫的最低版本更新為 3.13。使用舊版Protobuf
會導致 SDK 損毀。 - 這個版本僅適用於 CocoaPods,且使用的二進位檔與 v4.5.1 相同。
2020 年 10 月 13 日
iOS Sender 4.5.1
-
修正問題:自訂裝置挑選器無法更新
GCKUICastButton
,因此無法反映正確的 Cast 狀態。 - 修正「傳回類型上發生衝突的可為空值指定符」警告。
2020 年 9 月 14 日
網頁接收器
- 將 Shaka Player 升級至 2.5.16。
iOS 傳送者 4.5.0
- 新增支援 iOS 14 中的 Cast 裝置探索功能變更,首次投放時需要使用者明確授權。詳情請參閱「在 iOS 14 中首次投放內容」。
- 支援的最低 SDK 版本更新為 iOS 10。
2020 年 9 月 8 日
網頁寄件者
- 推出 Cast Connect,讓 Chrome 應用程式可以將內容投放到 Android TV 應用程式。詳情請參閱「Android TV Receiver 說明文件」。
2020 年 8 月 31 日
網頁接收器
- 在 HLS 中新增 #EXT-X-DATERANGE 支援,在 DASH 中新增 EventStream 支援。
2020 年 8 月 3 日
iOS 傳送器 4.4.8
- 推出 Cast Connect,讓 iOS 應用程式能將內容投放到 Android TV 應用程式。詳情請參閱「Android TV Receiver 說明文件」。
2020 年 7 月 29 日
Android 傳送端 19.0.0 和 Android TV 接收端 17.0.0
-
推出 Cast Connect,讓 Android TV 應用程式符合 Cast 通訊協定,並以接收器應用程式的形式運作。詳情請參閱「Android TV Receiver 說明文件」。
- 發布 play-services-cast-tv:17.0.0,做為 Android TV 應用程式的接收器 SDK。
- 發布 play-services-cast:19.0.0 和 play-services-cast-framework:19.0.0,包括 Cast Connect 傳送端 API 和 play-services-cast-tv 使用的 API。
-
API 更新:
-
已淘汰
AdBreakStatus#AD_BREAK_CLIP_NOT_SKIPPABLE
,請改用AdBreakClipInfo#AD_BREAK_CLIP_NOT_SKIPPABLE
。 -
已將
CastRemoteDisplayLocalService#getDisplay()
重新命名為CastRemoteDisplayLocalService#getCastRemoteDisplay()
,以免在 Android 11 上發生 API 衝突。 -
已在
MediaError
中新增getCustomData()
和getType()
。 -
在
MediaStatus
中新增詳細支援的指令位元常數 (MediaStatus#COMMAND_*
)。 -
公開
MediaTrack#getRoles()
。 -
公開
RemoteMediaClient.Callback#onMediaError()
。
-
已淘汰
2020 年 7 月 13 日
網頁接收器
- 改善預設 UI 的媒體類別偵測功能 (影片與音訊)。
- 新增對 Shaka Player 絕對即時時間的支援。
- 修正 Nest Hub Max 裝置的音訊故障問題。
- 已將 Shaka Player 升級至 2.5.12 版。
2020 年 5 月 4 日
網頁接收器
- 現在可以設定 Google 助理指令的逾時值。
- 錯誤事件現在會顯示詳細的 MPL 錯誤代碼。
-
現在可以使用
enforceSupportedCommands
旗標,強制執行支援的媒體指令。 - 修正播放中斷時回報的支援指令。
- 修正 Google 助理隨機播放載入要求的問題。
- 修正
getStats
值中的錯誤。
2020 年 3 月 12 日
網頁接收器
-
在
deviceCapabilities
中新增IS_CBCS_SUPPORTED
裝置功能。 - 已將 Shaka Player 升級至 2.5.8 版。
2020 年 2 月 27 日
iOS 傳送器 v4.4.7
- 修正未採用 SDK 中任何 UI 元件的應用程式,無法使用實體音量鍵的問題。
-
修正問題:在展開的控制器中,重複按下快轉或倒轉按鈕時,
currentTime
標籤會發生問題。 -
應用程式移至背景後,
GCKMediaQueue
中的媒體項目仍會保留。 -
使用者介面自訂更新:
- 迷你遙控器的進度列現在可以自訂。
- 現在可以自訂 Cast 對話方塊的導覽列和工具列背景顏色。
- 修正 iPhone X 專屬的使用者介面問題。
- 修正導致停止運作和當機的幾個問題。
2020 年 2 月 24 日
Android Sender 18.1.0
-
新增
MediaError
的預先定義常數, 詳細錯誤代碼和錯誤原因。
2020 年 1 月 22 日
網頁接收器
- 修正問題:變更支援的指令時,系統會播送多個媒體狀態。
接收器 v2
- 改善 VAST 廣告的位元率選取方式。
MPL
- 新增工作階段金鑰預先擷取功能。詳情請參閱 HTTP Live Streaming 2nd Edition 草案。
2020 年 1 月 7 日
網頁接收器
-
在
cast.framework.events.EmsgEvent
中新增對 ID3 時間碼中繼資料的支援。此外,系統現在會為 HLS/CMAF 內容傳送EmsgEvent
。 -
修正問題:轉換至新的媒體工作階段時,缺少播放器資料。
PLAYER_LOAD_COMPLETE
- 修正媒體圖示與休息片段編號和倒數重疊的問題。
- 修正問題:第一個中斷片段的倒數計時器一律顯示 0:00。
- 已將 Shaka Player 升級至 2.5.6 版。
網頁接收器 v2
-
在
deviceCapabilities
中新增IS_DEVICE_REGISTERED
裝置功能。如果已設定,系統會在 Cast 開發人員控制台註冊 Cast 裝置,以進行偵錯。 - 修正載入停滯問題。
- 現在,佇列中每個失敗的項目都會收到個別的媒體錯誤訊息。
MPL
- 修正直播問題:收到停止訊息後,音訊會繼續播放一段時間。
- 修正問題:變更畫質等級時,會顯示影片壓縮失真。
- 修正使用 *.m4s 區隔的 HLS 串流失敗問題。
2019 年 12 月 5 日
Android Sender 18.0.0
-
新增
setMediaSessionEnabled
,供開發人員啟用及停用 Cast SDK 建立的媒體工作階段。 - 變更在 Cast 工作階段期間顯示媒體通知的方式。如果啟用媒體通知,投放工作階段期間一律會顯示這類通知。先前,這項功能只會在應用程式於背景執行時顯示。
-
變更部分媒體相關類別,以實作
Parcelable
介面。
2019 年 11 月 11 日
iOS 傳送器 v4.4.6
- 修正 iOS 9 最低支援版本的相關問題。
2019 年 10 月 7 日
網頁接收器
- 公開曲目角色,做為曲目中繼資料的一部分。
- 已將 Shaka Player 升級至 2.5.5 版。
2019 年 9 月 23 日
iOS 傳送器 v4.4.5
- 改善 Cast 裝置探索和工作階段管理支援。
-
已將新的媒體指令新增至
GCKMediaStatus
。 -
已將
whenSkippable
屬性新增至「GCKAdBreakStatus
」。 - 修正廣告和 iOS 13 的使用者介面。
2019 年 9 月 11 日
Android Sender 17.1.0
-
在
RemoteMediaClient.MediaChannelResult 中新增
MediaError
欄位,可用於存取媒體指令失敗的詳細錯誤代碼。 -
「
MediaStatus.COMMAND_SKIP_FORWARD
」和「MediaStatus.COMMAND_SKIP_BACKWARD
」已淘汰。應用程式應改用MediaStatus.COMMAND_QUEUE_NEXT
和MediaStatus.COMMAND_QUEUE_PREVIOUS
。 -
新增
com.google.android.datatransport:transport-api:2.0.0
的依附元件。
2019 年 9 月 9 日
網頁接收器
-
如果預先載入下一個項目,預設播放器現在會顯示「Playing Next」
TV_SHOW
中繼資料類型預覽畫面。 -
在
cast.framework.messages
命名空間中新增ContentRating
類別。 -
更新預設 UI 音訊標題,讓
metadata.artist
優先於metadata.albumArtist
。 - 新增對負 startTime 值的支援,可指出相對於內容結尾或即時邊緣的開始時間。
- 媒體瀏覽:
- 媒體瀏覽抽屜式選單現在會在使用者閒置 30 秒後自動隱藏。
- 在「媒體瀏覽」疊加層的右上角新增「播放/暫停」按鈕和媒體項目縮圖。
- 更新媒體瀏覽清單行為。現在,每次設定媒體瀏覽內容時,水平捲動都會重設為初始最左側位置。
- 修正錯誤:
-
延遲解析
BasePlayer
結束 Promise,允許觸發媒體元素事件。 - 處理廣告預先載入的載入錯誤。
- 浮水印現在會與其他中繼資料一起顯示。
-
Chromecast 上的預設音訊使用者介面會遵守
.progressBar
樣式。 - 解決在 LOADING 之前和後續媒體項目播放期間,IDLE 畫面會閃爍的問題。
- 修正 Dash 內容的搜尋停滯問題。
網頁接收器 v2
-
在
cast.receiver.media
命名空間中新增ContentRating
類別。 - 修正錯誤:佇列中有多個項目時,錯誤資料傳播不正確。
媒體播放器程式庫
- 已在 API 中新增 HLS #EXT-X-MEDIA 屬性。
- 修正錯誤:
- 修正問題:SourceBuffer remove() 作業失敗,導致音軌切換時播放作業當機。
- 修正指定封裝音訊格式類型 (例如 *.ec3) 但使用 MPEG-4 型區隔 (例如 *.mp4、*.mp4a 等) 時的剖析問題。
- 修正 HLS 問題:內嵌 CEA608 字幕會明顯延遲顯示。
- 修正無法載入沒有音訊的 HLS 和 Smooth 內容。
2019 年 8 月 27 日
網頁寄件者
- 網頁寄件端現在使用新的自訂元素 v1 語法。這個版本會取代已淘汰的 v0 版。
-
修正了
breakTime
、breakClipTime
和liveSeekableRange
的變更事件,使用 Chrome M77 新增的getEstimatedBreakTime
、getEstimatedBreakClipTime
和getLiveSeekableRange
函式。
2019 年 8 月 12 日
iOS 傳送器 v4.4.4
- 改善 iOS 13 上的體驗。
- 改善 Cast 裝置探索功能。
2019 年 7 月 30 日
網頁接收器
- 已將 Shaka Player 版本升級至 2.5.1。
- 修正問題:載入內容時,中繼資料疊加層消失得太快。
- 修正載入攔截器中的拒絕處理方式,以清除載入狀態。
- 將
setBrowseContent
更新為可為空值。 - 修正問題:在廣告插播期間搜尋時,系統回報的目前時間不正確。
- 新增對 ignoreTtmlPositionInfo 的支援,可忽略 TTML 字幕的位置資訊。
- 改善對處理載入錯誤的支援:
- 避免觸發多個
MediaFinishedEvent
。 - 觸發媒體管理員錯誤回呼,以清除載入錯誤的播放器。
2019 年 7 月 22 日
iOS 傳送器 v4.4.3
- 改善對處理載入錯誤的支援,提供 error_reason。
- 發布不含訪客模式的 SDK 版本。
2019 年 6 月 17 日
Android Sender 17.0.0
- 最新版 SDK 會從 Android 支援程式庫切換至 Jetpack (AndroidX) 程式庫。如未在應用程式中進行下列變更,程式庫將無法運作:
-
將
com.android.tools.build:gradle
升級至 3.2.1 以上版本。 - 將
compileSdkVersion
升級至 28 以上版本。 - 將應用程式更新為使用 Jetpack (AndroidX)。請按照「遷移至 AndroidX」一文中的操作說明進行。
- 詳情請參閱「Google APIs for Android 版本資訊」。
2019 年 6 月 10 日
網頁接收器
- 推出媒體瀏覽功能,方便使用者在智慧螢幕上發掘內容。
- 在預設 UI 中新增 9 種語言版本:
- 丹麥文
- 英文 (英國)
- 英文 (印度)
- 英文 (新加坡)
- 法文 (加拿大)
- 義大利文
- 挪威文
- 荷蘭文
- 瑞典文
- 從遙控器使用者介面的專輯封面移除圓角。
- 修正「即時」和其他區域的錯誤。
iOS Sender 4.4.2 版
- 訪客模式
- 在 Cast 開發人員控制台中新增「啟用訪客模式」選項。
- 修正訪客模式工作階段管理問題。
- 修正錯誤
- 修正 4.4.1 版中導入的本地化問題。
2019 年 4 月 24 日
iOS Sender v4.4.1
- 推出直播的 Alpha 版支援功能。詳情請參閱開發人員指南。
- 新增即時串流狀態的資料結構和屬性。
- 新增 GCKMediaMetadata 金鑰。
- 新增直播媒體指令:
- [GCKRemoteMediaClient loadMediaWithLoadRequestData:]
- [GCKRemoteMediaClient seekWithOptions:]
- 改良擴展控制器 UI,支援直播:
- 變更展開控制器的版面配置和外觀。
- 修正錯誤
- 修正 iPhone X 上 GCKUICastContainerViewController 的底部。
- 修正 OS 執行大量網路活動時的重新連線問題。
- 修正使用 GCKUICastButton 初始化無障礙標籤時發生的當機問題。
2019 年 4 月 23 日
網頁接收器
- 推出直播的 Alpha 版支援功能。詳情請參閱開發人員指南。
- 更新使用者介面,支援直播 (包括直播指標)。
- 在媒體狀態中新增 mediaCategory 欄位,指出媒體是影片、音訊還是相片。
- 修正錯誤
- 修正 playbackConfig.segmentHandler 回傳值的使用方式。
媒體播放器程式庫
- 在 MPL 的 HLS 中新增 HEVC 轉碼器支援。
網頁寄件者
Android Sender 16.2.0
- 推出直播的 Alpha 版支援功能。詳情請參閱開發人員指南。
- 新增即時串流狀態的資料結構和屬性。
- 新增 MediaMetadata 鍵。
- 新增直播媒體指令:
- RemoteMediaClient#load(MediaLoadRequestData)
- RemoteMediaClient#seek(MediaSeekOptions)
- 改良擴展控制器 UI,支援直播:
- 在擴充的控制器 UI 小工具中新增直播支援。
- 變更展開控制器的版面配置和外觀。
- 導入與直播相容的 CastSeekBar 小工具,取代原生 SeekBar。
- 修改 ExpandedControllerActivity,使用 CastSeekBar 而非 SeekBar,以確保與直播相容。 ExpandedControllerActivity#getSeekBar() 現已淘汰,並會傳回虛擬例項。
- 新增 MediaStatus#PLAYER_STATE_LOADING 播放器狀態:
- Web Receiver 開始載入媒體時,MediaStatus 中的 playerState 屬性會設為 MediaStatus#PLAYER_STATE_LOADING,直到開始緩衝處理或播放內容為止。
- 在大多數情況下,應用程式處理這個狀態的方式,與處理 MediaStatus#PLAYER_STATE_BUFFERING 相同。
- 緩衝和載入狀態不一定可以互換。
- 載入時,Web Receiver 尚未解析所有媒體資訊,因此可用的媒體資訊只有傳送者載入媒體要求中的資訊。
- 緩衝期間,媒體資訊可能包含接收器解析的其他資訊。
- 修改 MediaMetadata 以支援有聲讀物:
- 新增 MediaMetadata 鍵。
- 新增有聲書的中繼資料類型。
2019 年 3 月 25 日
網頁接收器
-
將
document.registerElement()
的用法替換為customElements.define()
,使 Web 接收器 SDK 與新版 Cast 平台相容。 -
MediaStatus.breakStatus
現在會在內容有廣告插播時間點,但目前未播放廣告插播時,傳回空白物件。 - 修正內嵌 VAST 代碼剖析問題。
媒體播放器程式庫
- 修正切換音軌時約 20 秒的延遲問題。
2019 年 2 月 13 日
網頁接收器
- 修正觸控 UI 的「略過廣告」按鈕突然出現的問題。
- 修正遙控器上顯示休息資訊的問題。
媒體播放器程式庫
- 修正預先載入媒體的 licenseUrl 處理問題。
2019 年 2 月 5 日
iOS 傳送者 v4.3.5
- 新增有聲書中繼資料支援,詳情請參閱 GCKMediaMetadata.h。
- 在 podspec 中為 static_framework 設定正確的值。
- 在 連線控制器中,分割導覽列和工具列的 styleAttributes。
- 修正錯誤
- 修正特定資料庫初始化失敗時的異常終止問題。
- 修正來電或鬧鐘響起時,網頁接收器音量列的問題。
- 修正探索期間重複呼叫特定委派方法的問題。
- 修正問題:媒體佇列中的最後一個項目播放完畢後,佇列清單不會清除。
- 網路無法使用時,不允許顯示無法連線的鄰近裝置。
- 針對無法控制音量的裝置,停用裝置檢視控制器上的音量滑桿。