每當 Google Cast 推出新版本,我們都會在下方說明變更內容,並更新 API 參考資料。如要瞭解設計檢查清單的變更,請參閱異動記錄。
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 Sender 22.0.0 和 Android TV Receiver 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 異動記錄。
- 為 Shaka 播放器啟用內容預先載入功能。這樣一來,媒體項目或廣告插播就能順暢切換。
- 修正了 Shaka 切換編解碼時發生的錯誤。
- 新增欄位
ErrorSeverity
以便記錄 Shaka 錯誤。如果嚴重程度為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 Sender 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 媒體播放器媒體控制項 UI。
- 將新的
audioTrackInfo
欄位新增至Track
物件。 - 新增
cast.framework.system.Message
,代表從寄件者收到或傳送給寄件者的訊息。 - 變更了尋找暫停邏輯。如今,Web Receiver 只會在
BreakManager#setBreakSeekInterceptor
傳回的片段超過 1 個時,才建立綜合seek-{timestamp}
片段,否則尋找片段會維持與時間軸上原始片段相同。 - 新增
CastReceiverOptions#shakaVariant
選項,可在 CAF 中載入 Shaka Player 的偵錯版本。 -
修正在使用 AES-128 加密時,
PlaybackConfig#licenseRequestHandler
和PlaybackConfig#licenseResponseHandler
無法透過 Shaka for HLS 辨識的問題。 - 修正使用 Shaka Player 時不會觸發
ID3Event
的問題。 - 修正使用開場廣告時的側載文字音軌。
- 修正使用
UITextDisplayer
時的文字轉譯問題。 - 修正 VAST、MIME 類型和內容保護系統名稱的大小寫敏感度問題。
- 修正強制字幕的各種問題。
- 修正為
BREAK_CLIP_ENDED
事件填入EndedReason
代碼的問題。
2023 年 12 月 4 日
Android Sender 21.4.0 和 Android TV Receiver 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
錯誤。 -
新增可傳回
Tasks
的新版CastButtonFactory#setUpMediaRouteButton
,應用程式可透過此方式監聽成功或擲回例外狀況。舊版不接受Executor
引數,會忽略 ModuleUnavailableExceptions 並靜默失敗。
-
發布 play-services-cast-tv:21.0.1
- 將 minSdkVersion 從 16 提高至 19。
- 此版本包含品質改善項目
2023 年 7 月 20 日
iOS Sender 4.8.0
- iOS SDK 目前支援的最低版本為 iOS 13。
- 第一個穩定版 XCFramework。
- 可透過 Cocoapods 取得的 XCFramework。
- 恢復在媒體播放期間使用實體音量鍵控制音量的功能。
- 在導覽列中使用投放按鈕時,現在會套用色調顏色。
- 您現在可以使用 GCKUIStyle API 自訂導覽標題顏色。
- 修正媒體字幕音軌清單檢視畫面中,導覽列會變成透明的問題。
- 修正 XCFramework Beta 版中的異常終止問題。
- 新增 API,將 UIControl 與快轉或倒轉動作繫結。
- 新增對 Pixel 平板電腦的串流播放支援功能。
2023 年 7 月 6 日
Web Receiver 3.0.0111
-
新增支援使用
BreakManager
addBreak(breakData, breakClips, broadCastMediaStatus)
和removeBreakById(breakId)
的動態廣告插播。 -
已將
Subtype
字串剖析新增至 Smooth 資訊清單。 -
新增對 Shaka Player 中
manifestRequestHandler
、segmentRequestHandler
和licenseRequestHandler
的非同步要求支援。 - 新增強制字幕支援功能。
- 將 CAF 的預設 Shaka 版本提升至 v4.3.4。
-
清楚闡釋
setActiveByIds
參數說明。 - 修正了 CAF 選擇不同音軌的方式。
- 修正 Shaka 要求篩選器的錯誤要求主體類型轉換。
-
新增查詢
CreativeInformation
的功能,以便查詢與BreakClip
相關的BreakManager
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 Player 曲目新增
shaka.extern.track.label
至cast.framework.messages.Track.name
。 -
展開
cast.framework.stats.Stats
物件,以便考量shaka.extern.Stats
中的現有欄位。 - 修正含有擴大嵌入式插播的內容的媒體時間計算方式。
2023 年 3 月 28 日
Android Sender 21.3.0 和 Android TV Receiver 21.0.0
-
發布 play-services-cast:21.3.0 和 play-services-cast-framework:21.3.0
-
NotificationManager
現已取代Foreground Service
,用於發布投放媒體通知。 -
新增
CastReasonCodes#CAST_CANCELLED
,用於指出 Cast 工作階段已取消。
-
-
已發布 play-services-cast-tv:21.0.0
- 修正
MediaManager
的是否可為空值註解。
- 修正
2022 年 10 月 17 日
Web Receiver 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 Sender 21.2.0
-
發布 play-services-cast:21.2.0 和 play-services-cast-framework:21.2.0
-
推出
Output Switcher
功能。 -
新增了
Cast.Listener#onDeviceNameChanged()
APICast.Listener#onDeviceNameChanged()
,用於通知stream transfer
的裝置名稱變更。 -
已淘汰
CastOptions.Builder#setVolumeDeltaBeforeIceCreamSandwich(double)
和CastOptions#getVolumeDeltaBeforeIceCreamSandwich()
。 -
已修正
ForegroundServiceStartNotAllowedException
與MediaNotificationService
。 -
已將
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 Sender 21.1.0 和 Android TV Receiver 20.0.0
-
發布 play-services-cast:21.1.0 和 play-services-cast-framework:21.1.0
-
淘汰了
CastContext#getSharedInstance(Context)
。請改用CastContext#getSharedInstance(Context, Executor)
,該 API 會傳回 Task API,並在 Cast SDK 無法載入內部 Cast 模組時,處理例外狀況。ModuleUnavailableException
-
淘汰了
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 播放器版本和其他 Shaka 選項。 -
新增了
cast.framework.ui.Controls#hasMediaControlsOverlay()
這個新的 API,用於查詢媒體控制項疊加畫面是否會在應用程式上方顯示。 -
為「Like」使用者動作新增樣式
cast.framework.ui.ControlsButton.LIKE_HEART
。 -
cast.framework.events.EventType.BREAK_CLIP_ENDED
事件資料的currentMediaTime
值現在代表事件發生時,最新插播短片的目前時間。 -
新增方法
cast.framework.PlayerManager#getRawCurrentTimeSec
,用於傳回媒體元素的媒體時間。 -
新增
cast.framework.NetworkRequestInfo#timeoutInterval
,以指定播放器要求的 HTTP 要求逾時時間。 - 修正解碼 CEA 608/708 字幕 (針對解多工處理的 A/V 串流) 的 MPL 錯誤。
- 修正 MPL WebVTT 時間戳記剖析邏輯,以便接受超過 2 位數的小時值。
2021 年 12 月 9 日
Android Sender 21.0.0
- 透過將空值安全性違規視為錯誤,為 Kotlin 新增了更完善的是否可為空值支援。Java 開發人員不會受到影響。如果 Kotlin 開發人員的現有程式碼並非空值安全,可能會發生新的建構失敗。
2021 年 11 月 19 日
iOS Sender 4.7.0
- 修正 iOS 傳送端支援使用 ATV 憑證搭配 Cast Connect。
- 修正使用 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,才能避免執行階段當機。
- 改善佇列
-
新增
itemsReorderedAtIndexes
回呼至 MediaQueue,在重新排序佇列時呼叫。 - 新增對佇列指令序列化的支援。
-
將
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
- 修正了針對允許背景執行的應用程式,背景投放工作階段會遭到暫停的問題。
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 Sender 20.0.0 和 Android TV Receiver 18.0.0
-
發布 play-services-cast:20.0.0 和 play-services-cast-framework:20.0.0。
- 已刪除 GameManager 和相關 API。自 2017 年起已淘汰。
-
將
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 切換至 LIVE 串流時,迷你播放器的播放/暫停按鈕發生的問題。
-
為投放媒體通知導入
MediaIntentReceiver#ACTION_DISCONNECT
。
-
已發布 play-services-cast-tv:18.0.0:
-
已將
StoreSessionRequestData
類別和StoreSessionResponseData
類別新增至 Cast 電視程式庫。
-
已將
2021 年 4 月 5 日
Web Receiver 3.0.0095
- 已將 Shaka Player 升級至 3.0.10 版。
-
系統現在會在支援
STREAM_TRANSFER
媒體指令時,預設顯示投放按鈕。 - 在媒體瀏覽 UI 底部新增「建議」列。建議列包含互動式方塊,選取後即可播放媒體項目或捲動瀏覽可用的媒體項目。每個方塊也會對應至可用的 Google 助理指令。目前只有在系統語言設為英文或日文時,才支援建議方塊。
- 修正 Chromecast (支援 Google TV) 中的錯誤,當使用者將相片內容投放至預設接收器時,會顯示媒體控制項重疊畫面。
- 新增對
TRACKS_CHANGED
事件的支援。
2020 年 12 月 18 日
Web Receiver 3.0.0085
-
已新增選項至
CastReceiverOptions
,可停用 Shaka 和 MPL 的載入作業。
2020 年 12 月 3 日
iOS Sender 4.5.3
-
已修正
GCKCredentialsData
的載入時間錯誤「Undefined symbols for architecture arm64」。 -
修正
GCKCredentialsData
上發生的衝突可為空值錯誤的編譯器錯誤。 -
如果
Info.plist
缺少必要的 Bonjour 服務項目,現在會記錄警告訊息。
2020 年 11 月 4 日
iOS Sender 4.5.2
-
在 CocoaPods 中將
Protobuf
程式庫的最低版本更新為 3.13。使用舊版Protobuf
會導致 SDK 當機。 - 這個版本專供 CocoaPods 使用,並使用與 v4.5.1 相同的二進位檔。
2020 年 10 月 13 日
iOS Sender 4.5.1
-
修正問題:
GCKUICastButton
搭配自訂裝置挑選器時,不會更新以反映正確的 Cast 狀態。 - 修正「Conflicting nullability specifier on return types」的警告。
2020 年 9 月 14 日
Web Receiver
- 將 Shaka Player 升級至 2.5.16。
iOS Sender 4.5.0
- 新增支援 iOS 14 中的投放裝置探索變更,首次投放時需要使用者明確授權。詳情請參閱「在 iOS 14 中首次投放內容」。
- 將 SDK 最低支援版本更新為 iOS 10。
2020 年 9 月 8 日
Web Sender
- 推出 Cast Connect,讓 Chrome 應用程式能夠投放到 Android TV 應用程式。詳情請參閱 Android TV Receiver 說明文件。
2020 年 8 月 31 日
Web Receiver
- 新增對 DASH 中 HLS / EventStream 中的 #EXT-X-DATERANGE 的支援。
2020 年 8 月 3 日
iOS 傳送器 4.4.8
- 推出 Cast Connect,讓 iOS 應用程式能夠投放到 Android TV 應用程式。詳情請參閱 Android TV Receiver 說明文件。
2020 年 7 月 29 日
Android Sender 19.0.0 和 Android TV Receiver 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 日
Web Receiver
- 改善預設 UI 的媒體類別偵測功能 (影片與音訊)。
- 新增對 Shaka Player 即時絕對時間的支援。
- 修正 Nest Hub Max 裝置的音訊異常問題。
- 已將 Shaka Player 升級至 2.5.12。
2020 年 5 月 4 日
Web Receiver
- 現在可以設定 Google 助理指令的逾時值。
- 錯誤事件現在會顯示詳細的 MPL 錯誤代碼。
-
只要使用
enforceSupportedCommands
標記,現在就能強制執行支援的媒體指令。 - 修正在播放中斷期間回報的支援指令。
- 修正 Google 助理隨機播放載入要求的問題。
- 修正
getStats
值中的錯誤。
2020 年 3 月 12 日
Web Receiver
-
將新的裝置功能
IS_CBCS_SUPPORTED
新增至deviceCapabilities
。 - 已將 Shaka Player 升級至 2.5.8。
2020 年 2 月 27 日
iOS 傳送器 v4.4.7
- 修正未使用 SDK 任何 UI 元件的應用程式,可使用實體音量鍵。
-
修正在展開的控制器中,重複按快轉或倒轉按鈕時,
currentTime
標籤發生的問題。 -
應用程式移至背景後,
GCKMediaQueue
中的媒體項目會保留。 -
UI 自訂功能更新:
- 迷你控制器的進度列現在可自訂。
- 投放對話方塊的導覽列和工具列背景顏色現可自訂。
- 修正 iPhone X 專屬的 UI 問題。
- 修正了幾個導致停滯和當機的問題。
2020 年 2 月 24 日
Android Sender 18.1.0
-
已為
MediaError
詳細錯誤代碼和錯誤原因新增預先定義的常數。
2020 年 1 月 22 日
Web Receiver
- 修正問題:變更支援的指令時,會廣播多個媒體狀態。
Receiver v2
- 改善 VAST 廣告的比特率選擇。
MPL
- 新增支援工作階段鍵預先載入功能。詳情請參閱 HTTP Live Streaming 2nd Edition 草稿。
2020 年 1 月 7 日
Web Receiver
-
已在
cast.framework.events.EmsgEvent
中新增 ID3 時間中繼資料支援功能。此外,EmsgEvent
現已可用於 HLS/CMAF 內容。 -
修正問題:在轉換至新媒體工作階段時,
PLAYER_LOAD_COMPLETE
期間缺少播放器資料。 - 修正媒體圖示與插播短片編號和倒數畫面重疊的問題。
- 修正問題:第一個廣告片段的倒數計時器一律會顯示 0:00。
- 已將 Shaka Player 升級至 2.5.6。
Web Receiver v2
-
已將新的裝置功能
IS_DEVICE_REGISTERED
新增至deviceCapabilities
。如果已設定,Cast 裝置就會在 Cast 開發人員控制台中註冊,以便進行偵錯。 - 修正載入停滯問題。
- 系統現在會針對佇列中每個失敗的項目傳送個別媒體錯誤訊息。
MPL
- 修正直播問題,即在收到停止訊息後,音訊會繼續播放一段時間。
- 修正在品質等級變更期間顯示影片壓縮假影的問題。
- 修正使用 *.m4s 區段的 HLS 串流失敗的問題。
2019 年 12 月 5 日
Android Sender 18.0.0
-
新增
setMediaSessionEnabled
,方便開發人員啟用及停用由 Cast SDK 建立的媒體工作階段。 - 變更投放工作階段期間顯示媒體通知的方式。如果啟用媒體通知,系統會一律在投放工作階段期間顯示通知。先前只有在應用程式處於背景執行時才會顯示。
-
變更部分媒體相關類別,以便實作
Parcelable
介面。
2019 年 11 月 11 日
iOS 傳送器 v4.4.6
- 修正與 iOS 9 最低支援版本相關的問題。
2019 年 10 月 7 日
Web Receiver
- 將曲目角色當做曲目中繼資料的一部分公開。
- 升級至 2.5.5 版的 Shaka Player。
2019 年 9 月 23 日
iOS 傳送器 v4.4.5
- 改善 Cast 裝置探索和工作階段管理功能的支援。
-
已將新的媒體指令新增至
GCKMediaStatus
。 -
已將
whenSkippable
屬性新增至GCKAdBreakStatus
。 - 修正廣告和 iOS 13 的使用者介面。
2019 年 9 月 11 日
Android Sender 17.1.0
-
將
MediaError
欄位新增至 RemoteMediaClient.MediaChannelResult,可用於存取失敗媒體指令的詳細錯誤代碼。 -
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 Receiver
-
如果預先載入下一個項目,
TV_SHOW
中繼資料類型現在會在預設播放器中顯示「播放下一個」預覽畫面。 -
將
ContentRating
類別新增至cast.framework.messages
命名空間。 -
更新預設 UI 音訊標題,讓
metadata.artist
優先於metadata.albumArtist
。 - 新增對負 startTime 值的支援,以便指出相對於內容結尾或即時邊緣的開始時間。
- 媒體瀏覽:
- 使用者閒置 30 秒後,媒體瀏覽匣會自動隱藏。
- 在媒體瀏覽疊加畫面的右上角新增了播放/暫停按鈕和媒體項目縮圖。
- 更新媒體瀏覽清單行為。每當設定媒體瀏覽內容時,系統現在會將水平捲動重設為初始最左邊的位置。
- 修正錯誤:
-
延遲解析
BasePlayer
結束承諾,以便觸發媒體元素事件。 - 處理廣告預先載入的載入錯誤。
- 浮水印現在會與其他中繼資料一併顯示。
-
Chromecast 上的預設音訊 UI 會遵循
.progressBar
樣式。 - 在載入前和播放後續媒體項目之間,移除閒置畫面的彈出畫面。
- 修正 Dash 內容的尋軌停頓問題。
Web Receiver v2
-
將
ContentRating
類別新增至cast.receiver.media
命名空間。 - 修正在佇列中有多個項目時,錯誤資料會傳播不正確的問題。
媒體播放器程式庫
- 已將 HLS #EXT-X-MEDIA 屬性新增至 API。
- 修正錯誤:
- 修正 SourceBuffer remove() 作業失敗的問題,導致音軌切換導致播放作業中斷。
- 修正在指定已壓縮音訊格式類型 (例如 *.ec3) 但使用 MPEG-4 的片段 (例如 *.mp4、*.mp4a 等) 時發生的剖析問題。
- 修正 HLS 問題:在頻道內顯示 CEA608 字幕時,會出現明顯的延遲。
- 修正 HLS 和 Smooth 內容無法載入音訊的問題。
2019 年 8 月 27 日
Web Sender
- Web Sender 現在採用新的自訂元素 v1 語法。這個版本會取代已淘汰的 v0。
-
使用 Chrome M77 新增的
getEstimatedBreakTime
、getEstimatedBreakClipTime
和getLiveSeekableRange
函式,修正breakTime
、breakClipTime
和liveSeekableRange
的變更事件。
2019 年 8 月 12 日
iOS 傳送工具 v4.4.4
- 改善 iOS 13 的使用體驗。
- 改善對 Cast 裝置探索功能的支援。
2019 年 7 月 30 日
Web Receiver
- 將 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 API for Android 版本資訊。
2019 年 6 月 10 日
Web Receiver
- 推出支援媒體瀏覽功能,這是智慧螢幕上用來探索內容的新功能。
- 在預設 UI 中新增 9 種語言的本地化:
- 丹麥文
- 英文 (英國)
- 英文 (印度)
- 英文 (新加坡)
- 法文 (加拿大)
- 義大利文
- 挪威文
- 荷蘭文
- 瑞典文
- 為遙控器 UI 移除相簿封面的圓角。
- 修正直播和其他方面的錯誤。
iOS 傳送器 4.4.2 版
- 訪客模式
- 新增對 Cast 開發人員控制台的「啟用訪客模式」選項支援。
- 修正訪客模式工作階段管理問題。
- 修正錯誤
- 修正 4.4.1 版中出現的本地化問題。
2019 年 4 月 24 日
iOS 傳送工具 v4.4.1
- 推出直播的 Alpha 版支援功能。詳情請參閱開發人員指南。
- 新增直播狀態的新資料結構和屬性。
- 新增 GCKMediaMetadata 鍵。
- 新增直播媒體指令:
- [GCKRemoteMediaClient loadMediaWithLoadRequestData:]
- [GCKRemoteMediaClient seekWithOptions:]
- 改善展開的控制器 UI,以支援即時串流:
- 變更展開控制器的版面配置和外觀。
- 修正錯誤
- 修正 iPhone X 上 GCKUICastContainerViewController 的底部。
- 修正作業系統執行大量網路活動時的重新連線問題。
- 修正使用 GCKUICastButton 時,無障礙標籤初始化發生當機的問題。
2019 年 4 月 23 日
Web Receiver
- 推出直播的 Alpha 版支援功能。詳情請參閱開發人員指南。
- 更新使用者介面,支援直播功能,包括直播指標。
- 新增媒體類別欄位至媒體狀態,用於指出媒體是影片、音訊或相片。
- 修正錯誤
- 修正 playbackConfig.segmentHandler 傳回值的用法。
媒體播放器程式庫
- 在 MPL 中為 HLS 新增 HEVC 轉碼器支援。
Web Sender
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 日
Web Receiver
-
將
document.registerElement()
的用法替換為customElements.define()
,讓 Web Receiver SDK 與較新版本的 Cast 平台相容。 -
MediaStatus.breakStatus
現在會在內容含有廣告插播,但目前並未播放廣告插播時,傳回空白物件。 - 修正內嵌 VAST 代碼剖析問題。
媒體播放器程式庫
- 修正切換音軌時約 20 秒的延遲問題。
2019 年 2 月 13 日
Web Receiver
- 修正 Touch UI 中廣告略過按鈕突然顯示的問題。
- 修正了在遙控器上顯示片段資訊的問題。
媒體播放器程式庫
- 修正預先載入媒體的 licenseUrl 處理問題。
2019 年 2 月 5 日
iOS 傳送器 v4.3.5
- 新增對有聲書中繼資料的支援,詳情請參閱 GCKMediaMetadata.h。
- 在 Podspec 上設定正確的 static_framework 值。
- 在 connection controller 中,為導覽列和工具列分割樣式屬性。
- 修正錯誤
- 修正了在特定資料庫初始化失敗時發生異常終止的問題。
- 修正在來電或鬧鐘響鈴時,Web Receiver 音量列發生的問題。
- 修正在探索期間對特定委派方法的多餘呼叫。
- 修正問題:在佇列中最後一個項目播放完畢後,媒體佇列清單不會清除。
- 在網路無法使用時,禁止顯示無法連線的附近裝置。
- 針對無法控制音量的裝置,停用裝置 View Controller 上的音量滑桿。