每次發布新版 Google Cast 時,我們都會在下方說明異動內容,並更新 API 參考資料。如要瞭解設計檢查清單的異動,請參閱changelog。
2026 年 10 月 19 日
Android 傳送端 23.0.0
-
已更新
play-services-cast-framework,使其依附於androidx.mediarouter:mediarouter:1.9.0-beta01。 -
已淘汰
PrecacheManager和CastContext#getPrecacheManager()。 -
MediaMetadata現在會將所有可用的中繼資料鍵匯出至接收端,而不是根據mediaType將匯出的鍵限制為子集。
2026 年 7 月 27 日
iOS 傳送端 4.8.6
這個版本推出後,部分 Cast 裝置可透過網路喚醒功能,開啟處於睡眠模式的支援電視
- 支援的最低 iOS 版本已提高至 iOS 16。
- 請注意,這是 CocoaPods 的最後一次更新。後續更新將透過 Swift 套件管理工具提供,並繼續提供直接下載。
2026 年 7 月 16 日
Web 接收端 3.0.0156
先前嘗試 (3.0.0147 - 3.0.0155) 因各種迴歸問題而復原 (請見下方)
預先發布版:2026 年 7 月 16 日
推出日期:2026 年 8 月 4 日
推出完成日期:2026 年 9 月 9 日
主要異動:
- CAF 使用的預設 Shaka Player 版本已從 4.9.2 更新為 4.15.56。如需完整的變更清單,請參閱 Shaka Player changelog。
- 將
useShakaForHls預設為true,讓 Shaka 成為所有播放作業的預設播放器。應用程式仍可選擇不採用。請參閱「Shaka Player 上的 HLS 遷移」 - 在
CastReceiverContext中新增中繼資料 APIgetDeviceInformation()
原始版本修正項目:
- 修正第 1 代 Chromecast 無法載入第 2 版 SDK 的問題。
- 修正播放器在廣告插播後卡在緩衝狀態的問題。
- 修正回收播放器執行個體時,Shaka Player ABR 失敗的問題。
- 修正多工 TS 內容播放卡住的問題。
- 將「audio/x-mpegurl」和「audio/mpegurl」MIME 類型對應為 Shaka Player 的 HLS,修正使用這個 MIME 類型的應用程式錯誤代碼 4000。
如需完整的異動清單,請參閱原始版本資訊。
2026 年 5 月 20 日
Web 接收端 3.0.0151
修正項目:
- 修正播放器在廣告插播後卡在緩衝狀態的問題。
- 將「audio/x-mpegurl」MIME 類型對應為 Shaka Player 的 HLS,修正使用這個 MIME 類型的應用程式錯誤代碼 4000。
2026 年 4 月 7 日
Android 傳送端 22.3.1
- 修正 22.3.0 版的問題:呼叫受影響的建構函式時,Robolectric 測試會失敗,並顯示驗證錯誤。
2026 年 4 月 6 日
Web 接收端 3.0.0150
2025 年 11 月 18 日復原初始推出版本 (3.0.0147),因為緩衝指標出現迴歸
推出日期:2026 年 4 月 30 日
部署完成日期:2026 年 5 月 18 日
主要異動:
- CAF 使用的預設 Shaka Player 版本已從 4.9.2 更新為 4.15.35。如需完整的異動清單,請參閱 Shaka Player changelog。
- 將
useShakaForHls預設為true,讓 Shaka 成為所有播放作業的預設播放器。應用程式仍可選擇不採用。請參閱「Shaka Player 上的 HLS 遷移」 - 在
CastReceiverContext中新增中繼資料 APIgetDeviceInformation()
其他變更:
- 修正文字軌從一個佇列項目持續到下一個項目的問題
- 在 CAF 回應處理常式中提供完整的 Shaka 要求物件
- 停止為較新的 Shaka 版本設定預設
availabilityWindowOverride - 在
ErrorData中新增playerErrorCode和severity欄位 - 修正因非預期執行階段錯誤,導致載入時未解析 Promise 的問題
- 修正特定 HLS 負載平衡情境的音軌
- 修正 Dolby Vision 轉碼器支援偵測功能
- 修正從 CAF 傳送至 Shaka Player 的預設 DRM 穩定性設定
- 修正 preloadTime 未定義時的佇列行為
- 修正廣告失敗時播放器重設的問題
- 修正 Shaka Player 執行個體在播放期間的快取問題
- 透過 CAF 傳遞 MIME 類型,避免在 Shaka Player 中傳送 HEAD 要求
- 修正新版 Shaka 中曲目變更事件與 CAF 中對應事件之間的不良互動
- 公開
getRawSeekableRange(),與getRawCurrentTimeSec()保持一致。 - 修正 Shaka Player 的預設 DRM 穩定性設定:Android 裝置為 Widevine L1,其他裝置則為系統預設值
- 在「
cast.framework.events.ErrorEvent」中新增「triggeredByEventType」 - 修正 DAI 內容缺少廣告 UI 的問題
- 修正 Shaka Player 頻寬估算錯誤
- 將
shakaRequestContext新增至cast.framework.NetworkRequestInfo - 將
EXT-X-SESSION-DATA從 HLS 向上傳遞至新的cast.framework.events.SessionDataEvent
2026 年 2 月 11 日
Android 傳送端 22.3.0
-
新增選項,可在點選投放按鈕時啟動系統輸出端切換器,而非應用程式內裝置挑選器對話方塊。這項功能適用於搭載 Android 13 (API 級別 33) 以上版本的裝置。
- 請詳閱這些操作說明,確保應用程式已準備好支援系統輸出切換器所做的媒體轉送變更。
-
如要選擇加入這項功能,請在建構從
OptionsProvider傳回的CastOptions時呼叫CastOptions.Builder#setShowSystemOutputSwitcherOnCastIconClick(...)。 -
您也可以在
CastOptions建構完成後,在CastContext的單例共用執行個體上呼叫CastContext#setShowSystemOutputSwitcherOnCastIconClick(...),動態變更這項設定。
2025 年 10 月 20 日
Android 傳送端 22.2.0
-
新增智慧型裝置建議 API,可將投放裝置建議傳送至已註冊的應用程式,讓使用者能更輕鬆地透過一鍵轉移功能啟動投放工作階段。這項功能需要裝置搭載 Android 14 (API 級別 34) 以上版本。
-
透過
DeviceSuggestions#getClient()存取 API。 -
DeviceSuggestionsClient#requestDeviceSuggestions()即可要求裝置建議。 -
DeviceSuggestionsClient#registerCallback(...):接收新裝置通知,以便顯示為建議或先前建議的到期時間。DeviceSuggestionsClient#unregisterCallback(...):取消註冊回呼。 -
DeviceSuggestionsClient#clearClientData()會移除裝置建議所依據的應用程式資料。
-
透過
2025 年 10 月 7 日
iOS 傳送端 4.8.4
- 新增使用者介面,方便使用者在傳送端閱讀及同意 Cast 服務條款和隱私權政策。
- iOS SDK 支援的最低版本現為 iOS 15。
- Cocoapods 自 4.3.1 版起,預設會發布靜態資料庫。自 4.8.4 版起,這個靜態資料庫包含 Protobuf 程式庫。建議您使用靜態資料庫,避免 Protobuf 發生版本相容性問題。不過,您也可以改為下載動態程式庫。
-
請注意,
GCKErrorCode為GCKErrorCodeCancelled的投放失敗和中斷連線是預期行為。如果投放因GCKErrorCodeCancelled失敗或中斷,請確保應用程式不會自動重試投放,因為如果使用者拒絕《服務條款》,可能會導致非預期的行為。
2025 年 5 月 12 日
Android 傳送端 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 日
Web 接收端 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 4 版中淘汰。 - 開始在
MediaStatus訊息中填入requestId,用於LOADING狀態。 - 載入新內容時,回收 Shaka 播放器執行個體。
- 停止支援已淘汰的
QUEUE_SHUFFLE媒體指令。改用QUEUE_UPDATE。 - 修正 VAST 廣告連播支援功能,現在每個
<Ad>標記都有sequence屬性和巢狀<Wrapper>標記。 - 修正了
crossorigin屬性從<cast-media-player>傳播至巢狀<video>元素時,沒有值的情況。 - 在 MPL 中公開頻內音訊語言。
2024 年 8 月 22 日
iOS 傳送端 4.8.3
- 修正輕觸投放按鈕時,不會開啟裝置挑選器的錯誤。
- 修正與 AVRouting 相關的當機問題,這類問題會影響搭載 iOS 17 以上版本的裝置。
2024 年 4 月 18 日
iOS 傳送端 4.8.1
- Cast SDK 支援的最低版本現為 iOS 14。
- 套件中包含隱私權資訊清單和已簽署的 xcframework。
- 訪客模式已淘汰並移除。從這個版本開始,您只能整合單一 SDK。
- 修正投放時偶爾播放 Shorts 廣告會當機的問題。
2023 年 12 月 11 日
Web 接收端 3.0.0122
- 新增 VAST 廣告連播和廣告百匯支援。
- 更新 Google TV 裝置的 Cast 播放器媒體遙控器 UI。
- 在
Track物件中新增audioTrackInfo欄位。 - 新增
cast.framework.system.Message,代表從寄件者收到或傳送給寄件者的訊息。 - 變更跳轉廣告插播邏輯。現在,只有在
BreakManager#setBreakSeekInterceptor傳回超過 1 個廣告插播時,網路接收端才會建立合成seek-{timestamp}插播,否則跳轉插播仍會等於時間軸上的原始插播。 - 新增
CastReceiverOptions#shakaVariant選項,可在 CAF 中載入 Shaka Player 的偵錯版本。 -
修正使用 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時可能發生的MiniControllerFragmentandroid.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。
- 恢復在媒體播放期間使用實體音量鍵控制音量的功能。
- 在導覽列中使用投放按鈕時,現在會遵循色調顏色。
- 現在可以使用 GCKUIStyle API 自訂導覽標題顏色。
- 修正媒體音軌字幕清單檢視畫面中的透明導覽列問題。
- 修正 XCFramework Beta 版中的當機問題。
- 新增 API,可將 UIControl 與快轉或倒轉動作繫結。
- Pixel Tablet 新增投放支援。
2023 年 7 月 6 日
Web 接收端 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 要求篩選器的要求主體類型轉換。
-
新增功能,可查詢
BreakManagergetCreativeInfoByClipId(breakClipId)中與BreakClip相關的CreativeInformation。 - 修正 DPad 控制裝置載入媒體元素時,媒體中繼資料遺失的問題。
-
在
BreakClip中新增hlsSegmentFormat和hlsVideoSegmentFormat屬性。 - 修正使用 MPL 比較 MIME 類型時區分大小寫的問題。
- 修正使用 Shaka Player 載入直播 HTTP 即時串流 (TS 型) 時,無限緩衝的問題。
-
修正
IS_AT_LIVE_EDGE_CHANGED事件的PlayerDataBinder行為。 - 修正使用 MPL 的 TS 區隔中,因提供的資料不足而導致無限迴圈的問題。
-
新增 Shaka Player 錯誤的
error.stack。 -
改為使用 Shaka Player 軌道物件的
audioMimeType欄位 (而非audioCodec),填入變化版本軌道的cast.framework.messages.Track.trackContentType欄位。 -
在
cast.framework.messages.Track.name中新增shaka.extern.track.label,用於 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現在用於發布 Cast 媒體通知,而非Foreground Service。 -
新增
CastReasonCodes#CAST_CANCELLED,表示 Cast 工作階段已取消。
-
-
play-services-cast-tv:21.0.0 發布
- 修正
MediaManager的可為空值註解。
- 修正
2022 年 10 月 17 日
Web 接收端 3.0.0105
- 將 Shaka Player 升級至 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訊息解析錯誤時,將customData新增至CommandAndControlManager#ErrorResponseData。
2022 年 10 月 10 日
Android 傳送端 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。 -
更新
RemoteMediaClientAPI,接受可為空值的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 接收端 3.0.0103、MPL 播放器 1.0.0.113
- 將預設 Shaka Player 版本升級至 3.2.2。
-
新增 API
cast.framework.PlaybackConfig#shakaConfig,可覆寫 Shaka Player 版本和其他 Shaka 選項。 -
新增 API
cast.framework.ui.Controls#hasMediaControlsOverlay(),用於查詢媒體遙控器疊加層是否在應用程式上方算繪。 -
新增「喜歡」使用者動作的樣式
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 傳送端 20.1.0
- 注意:指定 Android 12 的應用程式必須更新至 Android Sender 20.1.0,以免發生執行階段當機。
- 佇列改善項目
-
在 MediaQueue 中新增
itemsReorderedAtIndexes回呼,系統會在佇列重新排序時呼叫該回呼。 - 新增佇列指令序列化支援。
-
將
RemoteMediaClient#queueSetRepeatMode中的customData參數設為可為空值。 - 遠端螢幕功能已淘汰。
minSdkVersion已從 14 升級至 16。
2021 年 10 月 26 日
Web 接收端 3.0.0102
- 升級至 Shaka Player 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 串流剖析問題。
- 如果 Chromecast (支援 Google TV) 上的媒體暫停超過 5 秒,系統就會隱藏媒體遙控器。
2021 年 5 月 26 日
iOS 傳送端 4.6.1
- 修正問題:在允許背景執行的應用程式中,背景 Cast 工作階段會暫停。
2021 年 5 月 17 日
iOS 傳送端 4.6.0
- 變更投放按鈕的預設行為,在連上 Wi-Fi 時一律顯示。
- 新增說明對話方塊,當使用者輕觸「投放」按鈕,但系統找不到任何裝置時,就會顯示這個對話方塊。
-
已淘汰
GCKUICastButton::triggersDefaultCastDialogAPI。 -
針對透過新 API
GCKUICastButtonDelegate導入自訂 UI 的應用程式,新增更一致的對話方塊自訂支援。 - 新增 iOS 13 以上版本的深色模式支援。
-
在
GCKUIStyleAttributes中新增廣告標記自訂功能。 -
媒體新增
hlsSegmentFormat和hlsVideoSegmentFormat支援。 - 修正錯誤並提升效能。
2021 年 4 月 29 日
Web 接收端 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。 -
已將
MediaNotificationService的foregroundServiceType標示為mediaPlayback。 -
將
com.google.android.datatransport:transport-api的依附元件更新至最新版本。 -
新增
MediaLoadRequestData.Builder建構函式,可從MediaLoadRequestData物件建構。 - 修正從 VOD 切換至直播時,迷你播放器上的播放/暫停按鈕問題。
-
已為 Cast 媒體通知導入
MediaIntentReceiver#ACTION_DISCONNECT。
-
play-services-cast-tv:18.0.0 已發布:
-
在 cast-tv 程式庫中新增
StoreSessionRequestData類別和StoreSessionResponseData類別。
-
在 cast-tv 程式庫中新增
2021 年 4 月 5 日
Web 接收端 3.0.0095
- 將 Shaka Player 升級至 3.0.10。
-
如果支援
STREAM_TRANSFER媒體指令,系統現在預設會顯示「投放」按鈕。 - 在媒體瀏覽 UI 底部新增建議列。建議列包含互動式方塊,選取後可播放媒體項目,或捲動瀏覽可用的媒體項目。每個方塊也會對應到可用的 Google 助理指令。目前只有在系統語言設為英文或日文時,才支援建議方塊。
- 修正 Chromecast (支援 Google TV) 的錯誤:將相片內容投放到預設接收端時,會顯示媒體遙控器疊加層。
- 新增
TRACKS_CHANGED事件支援。
2020 年 12 月 18 日
Web 接收端 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,並使用與 4.5.1 版相同的二進位檔。
2020 年 10 月 13 日
iOS 傳送端 4.5.1
-
修正以下問題:使用自訂裝置挑選器的
GCKUICastButton未更新,無法反映正確的投放狀態。 - 修正「Conflicting nullability specifier on return types」警告。
2020 年 9 月 14 日
Web 接收端
- 將 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 接收器說明文件。
2020 年 8 月 31 日
Web 接收端
- 在 HLS 中新增 #EXT-X-DATERANGE 支援,在 DASH 中新增 EventStream 支援。
2020 年 8 月 3 日
iOS 傳送端 4.4.8
- 推出 Cast Connect,讓 iOS 應用程式可投放到 Android TV 應用程式。詳情請參閱 Android TV 接收器說明文件。
2020 年 7 月 29 日
Android 傳送端 19.0.0 和 Android TV 接收端 17.0.0
-
推出 Cast Connect,讓 Android TV 應用程式符合 Cast 通訊協定,以便做為接收端應用程式。詳情請參閱 Android TV 接收器說明文件。
- 發布 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 日
Web 接收端
- 改善預設 UI 的媒體類別偵測功能 (影片與音訊)。
- 新增 Shaka Player 的直播絕對時間支援。
- 修正 Nest Hub Max 裝置的音訊問題。
- 將 Shaka Player 升級至 2.5.12 版。
2020 年 5 月 4 日
Web 接收端
- 現在可以設定 Google 助理指令的逾時值。
- 錯誤事件現在會顯示詳細的 MPL 錯誤代碼。
-
現在可以使用
enforceSupportedCommands旗標強制執行支援的媒體指令。 - 修正播放中斷時回報的支援指令。
- 修正 Google 助理隨機載入要求的問題。
- 修正
getStats值的錯誤。
2020 年 3 月 12 日
Web 接收端
-
在
deviceCapabilities中新增裝置功能IS_CBCS_SUPPORTED。 - 將 Shaka Player 升級至 2.5.8 版。
2020 年 2 月 27 日
iOS 傳送端 v4.4.7
- 修正了不使用 SDK 任何 UI 元件的應用程式實體音量鍵。
-
修正問題:重複按下快轉或倒轉按鈕時,展開控制器中的
currentTime標籤會發生問題。 -
應用程式移至背景後,
GCKMediaQueue中的媒體項目會保留。 -
使用者介面自訂更新:
- 現在可以自訂迷你控制器的進度列。
- 現在可以自訂投放對話方塊的導覽列和工具列背景顏色。
- 修正 iPhone X 專屬的使用者介面問題。
- 修正導致停滯和當機的幾個問題。
2020 年 2 月 24 日
Android 傳送端 18.1.0
-
新增
MediaError詳細錯誤代碼和錯誤原因的預先定義常數。
2020 年 1 月 22 日
Web 接收端
- 修正變更支援的指令時,系統會廣播多個媒體狀態的問題。
Receiver v2
- 改善 VAST 廣告的位元率選擇。
MPL
- 新增工作階段金鑰預先擷取支援。詳情請參閱 HTTP 即時串流 第 2 版草稿。
2020 年 1 月 7 日
Web 接收端
-
在
cast.framework.events.EmsgEvent中新增對 ID3 定時中繼資料的支援。此外,現在會針對 HLS/CMAF 內容調度EmsgEvent。 -
修正問題:在
PLAYER_LOAD_COMPLETE期間轉換至新的媒體工作階段時,播放器資料會遺失。 - 修正媒體圖示與廣告插播片段編號和倒數計時重疊的問題。
- 修正第一個廣告插播片段的倒數計時一律顯示 0:00 的問題。
- 將 Shaka Player 升級至 2.5.6。
Web 接收端 v2
-
在
deviceCapabilities中新增裝置功能IS_DEVICE_REGISTERED。如果設定,Cast 裝置會在 Cast 開發人員控制台中註冊,以便偵錯。 - 修正載入停滯問題。
- 現在,系統會針對佇列中每個失敗的項目傳送個別媒體錯誤訊息。
MPL
- 修正直播問題:收到停止訊息後,音訊仍會繼續播放一段時間。
- 修正問題:變更畫質等級時,會顯示影片壓縮不自然感。
- 修正使用 *.m4s 區隔的 HLS 串流失敗的問題。
2019 年 12 月 5 日
Android 傳送端 18.0.0
-
新增
setMediaSessionEnabled,讓開發人員啟用及停用 Cast SDK 建立的媒體工作階段。 - 變更投放工作階段期間顯示媒體通知的方式。如果啟用媒體通知,系統一律會在投放工作階段期間顯示通知。先前,只有在應用程式處於背景時,系統才會顯示這項資訊。
-
變更部分媒體相關類別,以實作
Parcelable介面。
2019 年 11 月 11 日
iOS 傳送端 v4.4.6
- 修正與 iOS 9 最低支援版本相關的問題。
2019 年 10 月 7 日
Web 接收端
- 公開的音軌會將角色視為音軌中繼資料的一部分。
- 將 Shaka Player 升級至 2.5.5 版。
2019 年 9 月 23 日
iOS 傳送端 v4.4.5
- 改善 Cast 裝置探索和工作階段管理支援。
-
在
GCKMediaStatus中新增媒體指令。 -
在
GCKAdBreakStatus中新增whenSkippable屬性。 - 修正廣告和 iOS 13 的使用者介面。
2019 年 9 月 11 日
Android 傳送端 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 日
Web 接收端
-
如果已預先載入下一個項目,
TV_SHOW中繼資料類型現在會在預設播放器中顯示「接著播放」預覽畫面。 -
在
cast.framework.messages命名空間中新增ContentRating類別。 -
更新預設 UI 音訊標題,讓
metadata.artist優先於metadata.albumArtist。 - 新增對負 startTime 值的支援,以表示相對於內容結尾或直播邊緣的開始時間。
- 媒體瀏覽:
- 使用者閒置 30 秒後,媒體瀏覽導覽匣現在會自動隱藏。
- 在媒體瀏覽疊加層的右上角,新增「播放/暫停」按鈕和媒體項目縮圖。
- 更新媒體瀏覽清單行為。現在,每次設定媒體瀏覽內容時,水平捲動都會重設為最左側的初始位置。
- 修正錯誤:
-
延遲解析
BasePlayer結束承諾,以便觸發媒體元素事件。 - 已處理廣告預先載入的載入錯誤。
- 浮水印現在會與其他中繼資料一併顯示。
-
Chromecast 上的預設音訊 UI 會遵循
.progressBar樣式。 - 在載入前和播放後續媒體項目之間,消除閒置畫面的閃爍。
- 修正 DASH 內容的跳轉停滯問題。
Web 接收端 v2
-
在
cast.receiver.media命名空間中新增ContentRating類別。 - 修正了佇列中有多個項目時,錯誤資料會不正確傳播的錯誤。
媒體播放器程式庫
- 在 API 中新增 HLS #EXT-X-MEDIA 屬性。
- 修正錯誤:
- 修正問題:SourceBuffer remove() 作業失敗,導致切換音軌時播放作業異常終止。
- 修正指定封裝音訊格式類型 (例如 *.ec3),但使用 MPEG-4 區隔 (例如 *.mp4、*.mp4a 等) 時的剖析問題。
- 修正 HLS 問題:顯示頻內 CEA608 字幕時,延遲時間明顯過長。
- 修正無音訊的 HLS 和 Smooth 內容無法載入的問題。
2019 年 8 月 27 日
網頁傳送端
- Web Sender 現在會使用新的 Custom Elements v1 語法。這個版本會取代已淘汰的第 0 版。
-
使用 Chrome M77 新增的
getEstimatedBreakTime、getEstimatedBreakClipTime和getLiveSeekableRange函式,修正breakTime、breakClipTime和liveSeekableRange的變更事件。
2019 年 8 月 12 日
iOS 傳送端 v4.4.4
- 改善 iOS 13 的使用體驗。
- 改善 Cast 裝置探索支援。
2019 年 7 月 30 日
Web 接收端
- 將 Shaka Player 升級至 2.5.1 版。
- 修正載入內容時,中繼資料疊加層太快消失的問題。
- 修正載入攔截器中的拒絕處理方式,以清除載入狀態。
- 將
setBrowseContent更新為可為空值。 - 修正問題:跳過廣告插播時間點時,回報的目前時間不正確。
- 新增 ignoreTtmlPositionInfo 支援,可忽略 TTML 字幕定位。
- 改善載入錯誤的處理支援:
- 避免觸發多個
MediaFinishedEvent。 - 觸發媒體管理工具錯誤回呼,在載入錯誤時清除播放器。
2019 年 7 月 22 日
iOS 傳送端 v4.4.3
- 提供 error_reason,改善載入錯誤的處理支援。
- 發布不含訪客模式的 SDK 版本。
2019 年 6 月 17 日
Android 傳送端 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 日
Web 接收端
- 推出媒體瀏覽支援功能,這項新功能可在智慧螢幕上探索內容。
- 在預設 UI 中新增 9 個語言代碼的本地化版本:
- 丹麥文
- 英文 (英國)
- 英文 (印度)
- 英文 (新加坡)
- 法文 (加拿大)
- 義大利文
- 挪威文
- 荷蘭文
- 瑞典文
- 移除遠端 UI 專輯封面的圓角。
- 修正 Live 和其他區域的錯誤。
iOS 傳送端 v4.4.2
- 訪客模式
- 新增 Cast 開發人員控制台「啟用訪客模式」選項的支援。
- 修正訪客模式工作階段管理問題。
- 修正錯誤
- 修正 4.4.1 版中的本地化問題。
2019 年 4 月 24 日
iOS 傳送端 v4.4.1
- 推出直播 Alpha 版支援。詳情請參閱開發人員指南。
- 新增直播狀態的資料結構和屬性。
- 新增 GCKMediaMetadata 鍵。
- 新增直播媒體指令:
- [GCKRemoteMediaClient loadMediaWithLoadRequestData:]
- [GCKRemoteMediaClient seekWithOptions:]
- 改善展開式控制器 UI,支援直播:
- 變更展開控制器的版面配置和外觀。
- 修正錯誤
- 修正 iPhone X 上的 GCKUICastContainerViewController 底部。
- 修正 OS 執行大量網路活動時的重新連線問題。
- 修正 GCKUICastButton 初始化無障礙標籤時發生的當機問題。
2019 年 4 月 23 日
Web 接收端
- 推出直播 Alpha 版支援。詳情請參閱開發人員指南。
- 更新使用者介面,支援直播和直播指標。
- 在媒體狀態中新增 mediaCategory 欄位,指出媒體是影片、音訊或相片。
- 修正錯誤
- 修正 playbackConfig.segmentHandler 傳回值的使用方式。
媒體播放器程式庫
- MPL 中的 HLS 新增 HEVC 轉碼器支援。
網頁傳送端
Android 傳送端 16.2.0
- 推出直播 Alpha 版支援。詳情請參閱開發人員指南。
- 新增直播狀態的資料結構和屬性。
- 新增 MediaMetadata 鍵。
- 新增直播媒體指令:
- RemoteMediaClient#load(MediaLoadRequestData)
- RemoteMediaClient#seek(MediaSeekOptions)
- 改善展開式控制器 UI,支援直播:
- 在展開的控制器 UI 小工具中,新增直播支援。
- 變更展開控制器的版面配置和外觀。
- 推出與直播相容的 CastSeekBar 小工具,取代原生 SeekBar。
- 修改 ExpandedControllerActivity,改用 CastSeekBar 而非 SeekBar,以確保與直播相容。 ExpandedControllerActivity#getSeekBar() 現已淘汰,並會傳回虛擬例項。
- 新增 MediaStatus#PLAYER_STATE_LOADING 播放器狀態:
- 網路接收端開始載入媒體時,MediaStatus 中的 playerState 屬性會設為 MediaStatus#PLAYER_STATE_LOADING,直到開始緩衝處理或播放內容為止。
- 在大多數情況下,應用程式處理這個狀態的方式與處理 MediaStatus#PLAYER_STATE_BUFFERING 的方式相同。
- 緩衝和載入狀態不一定能互換。
- 載入期間,網路接收器尚未解析所有媒體資訊,因此唯一可用的媒體資訊是傳送端載入媒體要求中的資訊。
- 緩衝處理期間,媒體資訊可能包含接收端解析的其他資訊。
- 修改 MediaMetadata 以支援有聲書:
- 新增 MediaMetadata 鍵。
- 新增有聲書的中繼資料類型。
2019 年 3 月 25 日
Web 接收端
-
將
document.registerElement()替換為customElements.define(),讓 Web 接收端 SDK 與新版 Cast 平台相容。 -
如果內容有廣告插播,但目前未播放廣告插播,
MediaStatus.breakStatus現在會傳回空白物件。 - 修正內嵌 VAST 代碼剖析問題。
媒體播放器程式庫
- 修正切換音軌時延遲約 20 秒的問題。
2019 年 2 月 13 日
Web 接收端
- 修正觸控 UI 突然顯示「略過廣告」按鈕的問題。
- 修正遙控器顯示廣告插播資訊的問題。
媒體播放器程式庫
- 修正預先載入媒體的 licenseUrl 處理問題。
2019 年 2 月 5 日
iOS 傳送端 v4.3.5
- 新增有聲書中繼資料支援,詳情請參閱 GCKMediaMetadata.h。
- 在 podspec 上為 static_framework 設定正確的值。
- 在連線控制器中,分割導覽列和工具列的 styleAttributes。
- 修正錯誤
- 修正了特定資料庫初始化失敗時的異常終止問題。
- 修正有來電或鬧鐘響起時,網路接收器音量列的問題。
- 修正探索期間重複呼叫特定委派方法的問題。
- 修正問題:佇列中的最後一個項目播放完畢後,媒體佇列清單不會清除。
- 不允許在網路無法使用時,顯示無法連線的鄰近裝置。
- 針對無法控制音量的裝置,停用裝置檢視控制器上的音量滑桿。