Mediarouter

透過常用使用者介面在遠端接收裝置上啟用媒體顯示和播放功能。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2022 年 11 月 9 日 1.3.1 - - 1.4.0-alpha01

宣告依附元件

如要新增 MediaRouter 的依附元件,必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」。

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Groovy

dependencies {
    implementation "androidx.mediarouter:mediarouter:1.3.1"
}

Kotlin

dependencies {
    implementation("androidx.mediarouter:mediarouter:1.3.1")
}

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。建立新的問題之前,請先查看這個程式庫中的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件

1.4 版本

1.4.0-alpha01 版本

2022 年 11 月 9 日

發布了 androidx.mediarouter:mediarouter:1.4.0-alpha011.4.0-alpha01 版本包含以下修訂項目。

新功能

  • 新增 SystemOutputSwitcherDialogController#showDialog 以顯示系統的輸出端切換器對話方塊,或是在系統輸出端切換器無法使用的情況下,顯示 Wear 裝置上的藍牙設定片段。(Ic3d78)

API 相關異動

  • 新增 MediaRouteDescriptor.Builder.clearControlFilters (I3a4e1)
  • MediaRouter 中新增缺少的 MainThread 註解。(I3ef6e)

修正錯誤

  • 修正呼叫 MediaRouter.removeUserRoute 造成的裝置特定當機問題 (b/202931542)。
  • 修正群組描述元無法持續接收磁碟區處理更新的問題 (461303)。
  • 在 API 33 以上版本中新增廣播接收器匯出旗標。(b2a663)。
  • 修正來自平台的無效路徑描述元導致的當機問題 (dd5c09)。

1.3 版本

1.3.1 版本

2022 年 7 月 27 日

發布 androidx.mediarouter:mediarouter:1.3.11.3.1 版本包含以下修訂項目。

修正錯誤

  • 解決裝置專屬問題,其中 MediaRouter.removeUserRoute() 會擲回非預期的 IllegalArgumentException (b/202931542)。

1.3.0 版本

2022 年 4 月 20 日

androidx.mediarouter:mediarouter:1.3.0 發布。1.3.0 版本包含以下修訂項目。

自 1.2.0 版以來的重要異動

  • 將旗標新增至 MediaRouterParams,用於在執行階段停用流暢轉移功能。
  • 新增可重設 MediaRouter 的測試成果。
  • 新增路由器參數,以便在 MediaRouterControllerDialog 之中調整使用者體驗
  • 在公開方法中備註空值。
  • 為 androidx 啟用 MissingGetterMatchingBuilder 的 API Lint 檢查。
  • 將媒體路由器的核心依附元件更新至 1.6.0

1.3.0-rc01 版本

2022 年 3 月 23 日

androidx.mediarouter:mediarouter:1.3.0-rc01 發布。1.3.0-rc01 版本包含這些修訂版本。

  • 自上次 Beta 版發布後沒有任何異動。

1.3.0-beta01 版本

2022 年 3 月 9 日

發布 androidx.mediarouter:mediarouter:1.3.0-beta011.3.0-beta01 版本包含以下修訂項目。

  • 自上次 Alpha 版發布以來沒有任何異動。

1.3.0-alpha01 版本

2021 年 12 月 15 日

發布 androidx.mediarouter:mediarouter:1.3.0-alpha011.3.0-alpha01 版包含以下修訂項目。

API 相關異動

  • 將旗標新增至 MediaRouterParams,用於在執行階段停用流暢的傳輸功能 (I53d68)
  • 新增可重設 MediaRouter 的測試成果 (Id167c)。
  • 新增路由器參數,以用於在 MediaRouterControllerDialog 中調整使用者體驗 (I7e574)
  • 公用方法的備註空值 (Ifc901)

修正錯誤

  • 已為 Android 啟用 MissingGetterMatchingBuilder 的 API Lint 檢查 (I4bbeab/138602561)

1.2 版本

1.2.6 版本

2022 年 1 月 26 日

發布 androidx.mediarouter:mediarouter:1.2.61.2.6 版本包含以下修訂項目。

修正錯誤

  • 修正 Android 12 上的 RemotePlaybackClient 建構函式當機問題 b/210684559

1.2.5 版本

2021 年 9 月 1 日

發布 androidx.mediarouter:mediarouter:1.2.51.2.5 版本包含以下修訂項目。

修正錯誤

  • 沒有可轉移的路徑時,隱藏輸出切換器中的媒體路徑按鈕。
  • 修正控管群組成員路徑音量的問題。

1.2.4 版本

2021 年 6 月 16 日

發布 androidx.mediarouter:mediarouter:1.2.41.2.4 版本包含以下修訂項目。

修正錯誤

  • 修正 MediaRouteButton 重播連結動畫的問題。
  • 修正 MediaRouteChooserDialog 中的路徑垂直對齊。

1.2.3 版本

2021 年 5 月 5 日

發布 androidx.mediarouter:mediarouter:1.2.31.2.3 版本包含以下修訂項目。

修正錯誤

  • 修正自訂選擇器對話方塊的 NullPointerException。
  • 修正 MediaRouteButton 顯示斷開狀態的問題 (即使已連線),如果其已暫時停用。

1.2.2 版本

2021 年 2 月 10 日

發布 androidx.mediarouter:mediarouter:1.2.21.2.2 版本包含以下修訂項目。

修正錯誤

  • 呼叫 OnDynamicRouteChangedListener.onRouteChanged 時,不會嘗試重新選取所選路徑。

1.2.1 版本

2021 年 1 月 13 日

發布 androidx.mediarouter:mediarouter:1.2.11.2.1 版包含以下修訂項目。

修正錯誤

  • 修正在 BT 可用期間,呼叫 unselect() 時選取手機揚聲器的問題
  • 修正 MediaRouter.Callback 時間碼。系統會在 OnPrepareTransferListener#onPrepareTransfer 完成後呼叫 Callback#onRouteSelectedCallback#onRouteUnselected

1.2.0 版本

2020 年 10 月 14 日

發布 androidx.mediarouter:mediarouter:1.2.01.2.0 版本包含以下修訂項目。

自 1.1.0 版以來的主要功能

  • 支援順暢的媒體傳輸功能,透過系統 UI 啟用媒體傳輸:詳情請參閱「媒體影片的新功能
  • 已變更註冊回呼的指南。查看 MediaRouter.addCallback() 的 Javadoc 中的範例程式碼
  • 新增 MediaRouter#OnPrepareTransferListener 事件監聽器,以便在所選路徑即將變更時接收事件。
  • 新增 MediaRouterParams 以表示轉送功能和 UI 類型。
  • 透過 @RestrictTo(LIBRARY) 避免嘗試用於內部用途

1.2.0-rc02 版本

2020 年 10 月 1 日

發布 androidx.mediarouter:mediarouter:1.2.0-rc021.2.0-rc02 版本包含以下修訂項目

修正錯誤

  • 修正了以往當使用者透過系統 UI 停止投放時,可能不會呼叫 RouteController#onUnselect 的問題。

1.2.0-rc01 版本

2020 年 9 月 16 日

發布 androidx.mediarouter:mediarouter:1.2.0-rc011.2.0-rc01 版包含這些修訂版本

修正錯誤

  • 修正了與藍牙音訊裝置連線時,目前投放功能的連線中斷問題。
  • 修正了在 MediaRouteProvider#notifyDynamicRoutesChanged() 中擲回 IllegalArgumentException 的問題。
  • 停止從輸出切換器中投放內容

1.2.0-beta01 版本

2020 年 9 月 2 日

發布 androidx.mediarouter:mediarouter:1.2.0-beta011.2.0-beta01 版包含以下修訂項目。

新功能

  • 支援順暢的媒體傳輸功能,透過系統 UI 啟用媒體傳輸:詳情請參閱「媒體影片的新功能

API 相關異動

  • MediaRouter.OnPrepareTransferListener 使用 ListenableFuture

修正錯誤

  • 修正群組路徑的音量控制問題。
  • 建立群組路徑時,會先建立群組路徑,之後再建立成員路徑。
  • 啟用輸出切換器中的「停止」功能。
  • 修正未正常呼叫的回呼
    • 系統在建立轉送工作階段時為 RouteController#onSelect
    • 從投放功能轉移到手機時為 MediaRouter.Callback#onRouteSelected
    • MediaRouter.Callback#onRouteSelected 以及正確的群組路徑資訊。
  • 移除回呼

1.2.0-alpha02 版本

2020 年 7 月 22 日

發布 androidx.mediarouter:mediarouter:1.2.0-alpha021.2.0-alpha02 版本包含以下修訂項目。

API 相關異動

  • 新增 MediaRouter.Callback#onRouteSelected,以在所選路徑與要求的路徑不同時接收通知 (Ieee16)
  • 新增監聽器 MediaRouter#OnPrepareTransferListener,以在所選路徑即將發生變更時接收事件 (I6ace1)
  • 新增 MediaRouterParam (I33150)
  • 已變更註冊回呼的指南。請參閱 MediaRouter.addCallback() 的 Javadoc 範例程式碼 (I58112)

1.2.0-alpha01 版本

2020 年 4 月 15 日

androidx.mediarouter:mediarouter:1.2.0-alpha01 發布。1.2.0-alpha01 版包含以下修訂項目。

API 相關異動

  • 透過 @RestrictTo(LIBRARY) 避免嘗試用於內部用途

修正錯誤

  • 解決投放對話時的 TalkBack 問題
  • 透過 Lock 保護 DynamicGroupRouterController 的事件監聽器

1.1 版本

1.1.0 版本

2019 年 9 月 5 日

發布了 androidx.mediarouter:mediarouter:1.1.0。您可以前往這裡查看這個版本包含的修訂項目。

自 1.0.0 版以來的重要異動

  • 動態群組支援
    • 允許使用者動態新增或移除路徑裝置。
    • 如要啟用動態群組,請呼叫 MediaRouteButton.enableDynamicGroup();應用程式會顯示新的動態群組對話方塊
    • 已安裝的 MediaRouteProvider 必須同時支援動態群組才能啟用這項功能。

1.1.0-rc01 版本

2019 年 6 月 13 日

androidx.mediarouter:mediarouter:1.1.0-rc01 發布,且自 1.1.0-beta02 版以來皆無異動。您可以前往這裡查看這個版本包含的修訂項目。

1.1.0-beta02 版本

2019 年 6 月 5 日

發布 androidx.mediarouter:mediarouter:1.1.0-beta02。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 支援 MediaRouter 對話中的 RTL 語言

修正錯誤

  • 修正 MediaRoute 對話的底部邊框間距

1.1.0-beta01 版本

2019 年 5 月 7 日

發布了 androidx.mediarouter:mediarouter:1.1.0-alpha01。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 針對標示為 @NonNull 的空值引數,將 IllegalPointerException 變更為 NullPointerException

API 相關異動

  • DynamicRouteDescriptor 的回呼邏輯已變更。現在,MediaRouteProvider 將呼叫 MediaRouterProvider.DynamicGroupController.notifyDynamicRoutesChanged,而不是直接呼叫回呼方法。

1.1.0-alpha03 版本

2019 年 4 月 3 日

發布了 androidx.mediarouter:mediarouter:1.1.0-alpha03。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 已修正 MediaRouteVolumeSlider 和 RegisteredMediaRouteProvider 上的當機問題。

1.1.0-alpha02 版本

2019 年 3 月 13 日

發布了 androidx.mediarouter:mediarouter:1.1.0-alpha02。您可以前往這裡查看這個版本包含的修訂版本完整清單。

新功能

  • 支援 Android Studio 版面配置預覽中的 MediaRouteButton

API 相關異動

  • MediaRouteActionProviderMediaRouteButton 中新增 enableDynamicGroup() 方法,即可啟用動態群組功能
  • MediaRouteActionProviderMediaRouteButton 中新增 setAlwaysVisible(boolean) 方法,以便始終顯示 MediaRouteButton

修正錯誤

  • MediaRouteCastDialog 列點擊功能容易使用
  • 移除不必要的 onRouteChanged 回呼的呼叫

1.1.0-alpha01 版本

2018 年 12 月 3 日

新功能

  • 新增支援動態群組路徑
    • 新增 API 以支援 MediaRouteProviders 的動態群組路徑
    • 新增路徑選擇器和動態群組路徑的控制器對話方塊,提供全新的使用者體驗